Skip to main content

Message History & Opt-Outs

In one sentence: Every message ServCraft sends is logged with a status you can check, failed SMS sends caused by empty credit balances can be retried, and each contact controls whether they receive email, SMS, and marketing.


What Is This?​

The message history is the log of every email and SMS the system has sent or tried to send — manual, triggered, reminder, and bulk. Each entry records who it went to, what it said, which record it belonged to, and its current delivery status.

Opt-outs are the per-contact switches that control what a person may be sent: email notifications, SMS notifications, and SMS marketing.



How It Works​

Where to look​

LocationWhat you see
Messages screen → Messages tabFull history of all messages for the business (needs the Message permission). The SMS credit balance shows at the top.
Bulk SMS tab on the same screenCampaign-level history with per-status statistics
Customer record → Messages tabEvery message linked to that customer, across all sources
The Messages tab on a job, quote or invoiceMessages linked to that specific record

Each entry shows the linked record, module, message type (email/SMS), recipient, subject, source (manual, trigger, appointment, bulk, …), and status. From the list you can open the linked record or preview the message content.

Message statuses​

The ones support sees most:

StatusWhat it means
DraftComposed but not finalised (bulk campaigns start here)
QueuedWaiting in the sending queue
In ProgressBeing processed right now
CompletedHanded to the sending provider successfully
DeliveredThe provider confirmed delivery to the recipient's inbox/phone
ErrorThe attempt failed — the system will retry automatically
Retry Count ExceededFailed 3 times; the system has given up on it
Out of CreditsSMS could not be sent because the credit balance was empty
ForbiddenThe SMS provider blocked the number (e.g. blacklisted)
Aborted / Validation FailedStopped before sending — usually bad or missing recipient details

A few notes on how statuses move:

  • Completed but customer says nothing arrived: the message left ServCraft successfully — the usual culprit is the recipient's spam folder or a wrong address.

Retrying failed messages​

  • Out of Credits is the only status with a manual retry. Once credits have been topped up (Settings → Subscription → SMS tab), use Retry Sending Message on the message — or, for a bulk campaign, the campaign's retry option, which re-queues all of its out-of-credit messages at once. If the balance is still zero, the retry is refused with a prompt to buy credits.
  • Error messages cannot be manually retried — the system already retried them automatically. If they ended in Retry Count Exceeded, fix the cause (usually the contact's email address or mobile number) and send the message again fresh.

Opt-out and unsubscribe settings​

Opt-outs live on each contact (Customer record → Contacts tab → open the contact). The three boxes sit under the Messages heading in the contact window, which says that when they are off the contact can't be picked as a recipient. On the Contacts tab and in the Customers list, a mobile number has a green WhatsApp icon next to it. Clicking it opens a WhatsApp chat with that number in a new browser tab.

Setting on the contactWhat it controls
Send emails to this contactWhether any email — manual or automated — is sent to this contact
Send SMS to this contactWhether any SMS — manual or automated — is sent to this contact
Send SMS marketingWhether this contact is included in Bulk SMS campaigns; unticking it is the marketing opt-out

How they're enforced:

  • Manual sends: the recipient picker flags and excludes contacts whose channel is off.
  • Triggered/automated sends: the system checks the same toggles before queuing each message.
  • Bulk SMS: unsubscribed contacts are always excluded — no override exists.
  • SMS replies: a reply of exactly "STOP" or "opt out" to a bulk SMS automatically unticks the contact's marketing subscription.

Without the customer-edit permission the boxes are greyed out and cannot be changed.


Key Terms​

TermWhat It Means
Message historyThe log of every sent/attempted message
StatusWhere a message is in its life: queued → in progress → completed → delivered (or an error state)
Delivery receiptConfirmation from the email/SMS provider that the message reached the recipient
RetryRe-queuing a message that failed; manual retry exists only for Out of Credits
Opt-outA contact-level switch blocking a channel (email/SMS) or marketing
UnsubscribedA contact excluded from all bulk SMS marketing




Important Rules & Gotchas​

  • "Completed" is not "Delivered". Completed means the provider accepted it; Delivered means the provider confirmed receipt. Both mean ServCraft did its job.
  • Only Out of Credits can be manually retried. Everything else either retried automatically or must be sent again fresh.
  • Opt-out changes are immediate but don't recall messages already queued.
  • Deleting a message from history only hides the log entry — it doesn't unsend anything.
  • No history entry does not always mean the trigger failed. An automated message is not created at all for a contact whose Send emails to this contact or Send SMS to this contact box is unticked, or whose email address or mobile number is blank.
  • The message history is also where incoming SMS replies land: a reply to a record-linked message is added to that record as a comment.