Skip to main content

Manual Messages & Templates

In one sentence: Staff can send a one-off email or SMS to customers, suppliers, or employees straight from a record (a job, quote, invoice, customer, and more), and templates with merge fields mean the message writes itself.


What Is This?​

A manual message is a once-off email or SMS that a staff member sends deliberately — as opposed to automated messages that the system sends by itself. Manual messages are always sent from a record: you open the customer, job, quote, invoice, purchase order, project, query, or asset you're dealing with and use its Send / Email / SMS action. The message is then linked to that record, so the history stays attached to the right job or invoice.

A template is a saved message format — subject and body for email, plus a short text version for SMS — that the team reuses instead of typing the same message every time. Templates can contain merge fields (also called replacement tags): placeholders that are swapped for real data (like the customer's name or the job number) at the moment of sending.


Why Does This Matter?​

  • Sending the quote, invoice, or job card to the customer is the last step of almost every workflow in ServCraft — this is how it happens.
  • Templates keep the business's communication consistent and professional, and save enormous typing time.

If a message won't send, it's almost always one of three things: the contact has no email address / mobile number, the contact is switched off for that channel, or (for SMS) the business is out of SMS credits.


How It Works​

Sending a manual message​

  1. Open the record you want to send from — a customer, job, quote, invoice, project, query, asset, supplier, or purchase order — and choose the Send / Email / SMS action.
  2. Choose the message type: Email, SMS, or Both.
  3. Pick the recipients. You can select the customer's (or supplier's) contacts and also employees. The selector shows who can actually receive each channel:
    • A contact with no email address, or with email notifications switched off, is flagged (e.g. "Excluded from emails") and won't get the email.
    • A contact with no mobile number, or with SMS switched off, is flagged and won't get the SMS.
    • You cannot send at all if none of the selected people can receive anything.
  4. Click Insert template and pick a template for the module you're in, or write the message from scratch. Picking a template fills in the subject, email body and SMS text. The subject is required for emails.
  5. Add attachments if needed:
    • System documents generated from the record — quote, invoice, job card, job sheet, workshop report, sign-off document, purchase order (which ones are offered depends on the record you're sending from).
    • Completed forms linked to the record.
    • Files uploaded from your computer or already attached to the record.
  6. Send. The message goes into the sending queue immediately — manual messages are not scheduled for later (scheduling for a future date/time exists only for Bulk SMS campaigns).

SMS length​

An SMS body is limited to 459 characters (the equivalent of three SMS segments). Be careful with merge fields in SMS — a long customer name makes the real message longer than what you typed.

Templates​

Templates are managed under Settings → Templates → Messages.

Template typeWhat it means
SystemPre-built by ServCraft. Cannot be deleted. When you edit and save one, ServCraft keeps the original and stores your customised copy as the new active version for your business.
UserCreated by the business. Fully editable, and can be deleted or deactivated.

Each template has:

FieldNotes
NameInternal name — the customer never sees it
ModuleWhich area it belongs to (Job, Quote, Invoice, Customer, Query, Asset, Purchase Order, etc.). This controls where the template is offered and which merge fields are available
SubjectEmail subject line
Email bodyRich formatted email content, maximum 500 KB including any images in it
SMS bodyPlain text, maximum 459 characters

Email signatures, logos and images​

ServCraft has no separate email signature setting. A template only has a subject, an email body and an SMS body, so a business that wants a sign-off with a logo writes it at the bottom of the email body in each template.

The email body editor has no button for inserting an image. An image can still end up in the body when it comes in with pasted content, or when someone adds it through the Edit HTML button on the editor toolbar. An image embedded in the body, rather than linked from a website, is saved as part of the body and counts toward the 500 KB limit. If the body is too big, the form shows "Total content exceeds the 500KB limit by ..." and will not save. Keep signature images small, such as a cropped logo, rather than a full-size photo. The same 500 KB limit applies when you write or edit an email in the Compose Message window.

Every email sent to a customer is already wrapped in a ServCraft frame. The frame shows the business logo at the top, 100 pixels high (the branch's own logo if the branch has one), and a footer that reads "Sent with care from" followed by the business name. A logo pasted into the template appears a second time, inside the message.

Merge fields (replacement tags)​

Merge fields are placeholders written in double curly braces that get replaced with live data when the message is sent. They are organised in groups — general message details, customer details, store (branch) details, and then module-specific groups such as job, quote, query, or product/asset fields. The list you can pick from depends on the template's module.

Two gotchas worth knowing:

  • A payment link merge field is only offered when the business has the PayFast payment integration active.
  • If someone types an invalid tag by hand, the form flags it — tags must match the published list exactly.

Key Terms​

TermWhat It Means
Manual messageA once-off email/SMS a staff member sends from a record
TemplateA saved, reusable message format tied to a module
System templateA ServCraft-provided template that can be customised but never deleted
Merge field / replacement tagA placeholder in double curly braces replaced with real data at send time
ModuleThe area of ServCraft a template belongs to (Job, Quote, Invoice, …)
Message typeEmail, SMS, or Both




Important Rules & Gotchas​

  • Manual messages send now, not later. There is no schedule-for-later option on a manual send; only Bulk SMS campaigns have a scheduled send date/time.
  • Opt-out settings are respected automatically. A contact with "Send emails to this contact" or "Send SMS to this contact" unticked is silently excluded from that channel — even if a staff member selects them.
  • System templates can't be deleted, only customised. Editing one saves your business's own version; the ServCraft original remains underneath.
  • The SMS limit is 459 characters, and merge fields can push a message over the limit after replacement.
  • Sending "Both" requires a valid subject (for the email) and an SMS body.
  • Employees can be recipients too, and their own email/SMS notification toggles are respected the same way.
  • Settings → Templates → Signatures is not for email signatures. It holds the signature settings for forms, such as the terms a customer signs against and the instructions shown when a signature is captured.
  • Email bodies are capped at 500 KB. Large pasted images are the usual reason a template refuses to save.