Skip to content

Messages

Messages is the log of every SMS in and out of your organization: from the portal, the API, campaigns and Verify, plus the replies your phones receive. Use it to answer “did it arrive?” and “which phone sent it?”.

  1. Click Messages in the sidebar.

    Open Messages.
  2. The newest messages are at the top. The toolbar above the table filters the log; the Status column shows where each message is now.

    The log and its filters.
  3. To see only one status, open Status and pick it, for example failed to review what didn’t go out.

    Filter by status.
  4. To find one conversation, type a number, or part of one, into Search by number. Use the direction filter (Sent and received, Outbound, Inbound) to see only one side. The device filter and the two date fields narrow it further. Clear filters resets everything.

    Search by number or filter by direction.

The filters live in the page address, so you can bookmark a view or send it to a teammate. The table loads 50 messages at a time; Load more at the foot fetches the next page.

  1. Click a row.

    Click a message.
  2. The panel shows the text, the current status and the Timeline: every step the message went through, with the time of each and the seconds between steps. Under it are the direction, both numbers, the Device, the Provider, the Parts with the encoding, and the message ID. A failed message also shows its Error code.

    Read the timeline.
Status Meaning
queued Accepted and waiting: for a phone, for its scheduled time, or for the send window.
routed Assigned to a phone and SIM, which has been told to send it.
sending The phone has handed it to the radio.
sent The carrier accepted it.
delivered The recipient’s handset confirmed it. Final.
failed It couldn’t be sent; the Error field says why. Final.
blocked Never sent: the number is on the blacklist or opted out, or its campaign was canceled. Final.
received A message someone sent to one of your SIMs.

Statuses only move forward. A message that stays at sent reached the carrier, but not every carrier returns delivery reports. The full lifecycle, the failure codes and how to get each change pushed to your server are in Track delivery.

Column Shows
Arrow Pointing up and out for outbound, down and in for inbound
Number The recipient, or the sender for an inbound message
Message The text. Verification codes are hidden.
Status The current status
Route The phone and SIM that carried it, or Not routed yet
Parts Segments and encoding (GSM or UCS)
Time When it was created. Hover for the exact time.

On narrow screens the Message, Route and Parts columns are hidden; open the message to see them.

Click Export CSV.

Click Export CSV to download the log with the filters you have set. Cells that start with =, +, - or @ are escaped so a spreadsheet won’t run them as formulas. CSV export is part of the Starter plan and above; on Free the button is dimmed and says why.

Every role can read the log (messages:read). Export CSV needs logs:export, which the Owner, Admin, Developer, Campaign manager and Billing roles have. See Team.