Communications

Every message the platform sends — the delivery tracker, mailbox, chat, and how to diagnose a message that never arrived.

Operations → Communications

Every SMS, email and push notification the platform sends lands in one ledger. That is what makes "did the tenant actually get their invoice?" a question with an answer.

SurfaceRoutePurpose
Delivery Tracker/communications/trackerEvery outbound message and its delivery outcome.
Mailbox/mailboxEmail conversations.
Chat/chatDirect messaging.
Templates Beta/message-templatesThe templates messages are rendered from. See Templates & broadcasts.
Notice Board/lookups/notice-boardProperty notices. See Notices & polls.
Polls/pollsResident polls.

The delivery tracker

The tracker is the operational record of outbound messaging.

ColumnMeaning
ChannelSMS, email, WhatsApp, push.
DirectionOutbound or inbound.
Recipient / Recipient nameWho it went to.
Sender / Sender addressWho it came from.
Subject / MessageThe content sent.
Message type / CategoryWhat kind of message it was.
Source type / Source IDWhat generated it — an invoice, a payment, a case, a broadcast.
StatusWhere it got to (see below).
Attempts / Max attemptsRetry state.
Scheduled at / Next runWhen it is due to be attempted.
Sent atWhen it left.
Response / Sender responseWhat the provider returned.
Batch noThe batch it belonged to, for bulk sends.
SentimentWhere inbound sentiment analysis is enabled.

Statuses

Messages move through a lifecycle rather than being simply sent or not:

StatusMeaning
Pending / Staged / QueuedAccepted, waiting to go.
ProcessingBeing dispatched.
SentHanded to the provider.
DeliveredConfirmed delivered to the handset or inbox.
Read / Viewed / ClickedEngagement, where the channel reports it.
Undelivered / Failed / RejectedDid not arrive; the response explains why.
Delayed / PausedHeld.
SkippedDeliberately not sent — for example a recipient with no valid address.
Not required / Not trackedNo delivery was expected or is being tracked.

Diagnosing a message that never arrived

  1. Find it by source

    Filter by source type and ID — the invoice, payment or case that generated it — rather than scrolling by date.

  2. Read the status

    Skipped means it was never attempted. Failed means it was attempted and rejected.

  3. Read the provider response

    Most failures name their cause: invalid number, unreachable handset, bounced address, blocked sender.

  4. Check the recipient details

    The address used is recorded on the message. Compare it against the resident record.

  5. Fix the source, not the message

    Correcting the resident's phone or email is what fixes the next hundred messages.

Where messages come from

SourceExamples
DocumentsInvoice, receipt, statement delivery.
CollectionsReminders and demand letters staged by a strategy.
PromisesReminders ahead of a promised payment date.
OperationsService-request updates, visitor notifications, amenity confirmations.
BroadcastsOperator-initiated bulk messages. See Templates & broadcasts.
SystemApproval notifications, job outcomes.

Because everything lands in one ledger, delivery status is available to every module without each one building its own tracking.

Mailbox and chat

  • Mailbox holds email conversations, with threads and archive.
  • Chat carries direct messages — operator to operator, and operator to resident where enabled.

Both are conversation surfaces; the tracker is the audit surface. Use chat to talk, use the tracker to prove.

Message frequency

Automated messaging can become harassment quickly when several engines each have a reason to write to the same person. Collection strategies carry a max contacts per week guard counted across all channels, precisely for this reason. Where you add new automated messaging, check what else already writes to that audience.

Common problems

SymptomCause
Message skippedRecipient has no valid address for that channel.
Repeated failures to one numberWrong format, or the number is no longer in service.
Bulk send partially deliveredCheck the batch number and filter by failed within the batch.
Nothing being sent at allThe dispatch job is off. See Scheduled tasks.
Tenant received the same message twiceTwo sources generated it — check source type on both rows.