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?”.
Find a message
Section titled “Find a message”-
Click Messages in the sidebar.
Open Messages. -
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. -
To see only one status, open Status and pick it, for example
failedto review what didn’t go out.Filter by status. -
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.
Open a message
Section titled “Open a message”-
Click a row.
Click a message. -
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.
What the statuses mean
Section titled “What the statuses mean”| 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.
Read the table
Section titled “Read the table”| 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.
Export to CSV
Section titled “Export to 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.
Who can see it
Section titled “Who can see it”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.