SMS
The SMS feature lets your team text leads from PeakIDX and read their replies in one place. Texting uses your own Twilio account, so you must set that up first. See SMS Settings.
Open it from the SMS Inbox link in the site menu.
SMS Inbox
The inbox lists one row per phone number, newest conversation first, up to 200 rows.
| Column | Description |
|---|---|
| Number | The phone number of the conversation. |
| Last message | The latest message, shortened to 80 characters. < marks a received message and > marks one you sent. |
| When | When the latest message was logged, in your time zone. |
| Messages | How many messages are stored for the number. |
| Actions | Open shows the conversation. |
The SMS Settings button at the top opens SMS Settings.
Who Can Use the Inbox
The inbox and the settings page are for site administrators only. Agents do not see the full inbox. They reach a conversation from the Send SMS button on a lead they can access (see below).
Conversation Page
The conversation page shows the number, a link back to the lead if one matches, and a consent line:
- Opted in, with how the consent was recorded.
- Opted out: texting is blocked until the person replies START.
- No consent on file: texting is blocked until the person opts in with a form checkbox or a START reply.
Below that is a table of the latest 200 messages (When, Direction, Message, Status), followed by a send box.
Sending From a Lead
If a lead has a phone number, the View Lead page shows a Send SMS button. It opens the conversation for that lead. The lead's first phone number is used, or the second phone number if the first is not a valid mobile number.
Type your message and click Send. Merge fields such as {{contact.first_name}} work when the conversation is linked to a lead, the same as in email. Unknown fields render empty. A message can be up to 1600 characters, counting anything PeakIDX adds.
A successful send adds an "SMS sent" entry to the lead's activity timeline, and an incoming message from the lead's number adds an "SMS received" entry. Incoming messages are matched to the newest lead on the site whose phone or second phone ends in the same 10 digits.
Messages PeakIDX Adds
The first message sent to a number gets your business name added at the start and "Reply STOP to opt out." added at the end. Later messages are sent exactly as typed. See Consent and STOP.
Refused Sends
A send is refused, and an error is shown, when:
- SMS is not set up or not enabled for the site.
- The from number or the lead's number is not valid.
- The message is empty or too long.
- There is no recorded consent for the number, or the person has opted out.
Known Limits
- The inbox is for administrators only. Agents reach a thread through a lead.
- Inbound messages not addressed to the site's from number are ignored.
- Delivery status is updated by Twilio's status callback (see below). It only updates messages PeakIDX sent. If Twilio cannot reach your site's
/sms-statusaddress, the status stays at the value returned when the message was accepted (for examplequeued). - The auth token needs the
PEAKIDX_CRM_ENCRYPTION_KEYserver setting before settings can be saved. See SMS Settings.
Delivery Status
When Twilio reports a status for a message you sent, PeakIDX finds the message by its Twilio message ID and updates the Status column in the conversation. The progression is queued, accepted, scheduled, sending, sent, delivered. Callbacks can arrive out of order, so a status never moves backwards, and delivered is never replaced. failed and undelivered are final: they replace any status except delivered, and the Twilio error code and message are saved with the message.
Drip Campaign SMS Steps
A drip campaign can include SMS steps. They send through these same settings, require the same consent, and appear in the conversation like any other outbound message. A step for a lead without consent or a valid phone number is skipped and logged on the lead's timeline. A text from a lead (including STOP) also stops that lead's active campaigns, as described in Enrollment and Stop Rules.