SMS alerts

Text a buyer when one of their calls qualifies: switching it on, the words and their placeholders, the number it comes from, who pays for it, and STOP.

After this page you can have a buyer's phone buzz the moment one of their calls earns its price, choose what the text says and which of your numbers sends it, and know what it costs you and why a text did not go.

An SMS alert is one text per qualified call, from a number you own to the buyer's alert number: the campaign, the talk time, the caller and a link that opens that call on the buyer's dashboard.

A text as it arrives
Roofing leads - Phoenix: qualified call, 3:04 talk time, caller ***-***-0142. https://app.example.com/buyer/call-logs?call=0b9f6c1e-52a4-4a0e-9f0a-3d1c7e8b2a11

Switching them on

On the buyer's page, SMS alerts: switch on Text this buyer when one of their calls qualifies, then say where the texts go and which number sends them.

SettingWhat it takes
Send them toA US (+1) mobile number. You type it, and by saving it you confirm it is the buyer's — nobody texts it a code. The buyer's seat can instead send the alerts to the mobile it proved on its own dashboard.
Send fromOne of your numbers that can text: yours, active, SMS-enabled and not held back for spam. Leave it on automatic and texts come from your oldest such number. A number that stops qualifying is passed over for the next.
The tab says, before any call converts, whether a text would go out now — and if not, why. The same reasons are recorded on every alert that was skipped.
PATCH /api/tracking/buyers/:id/alerts
{
  "smsAlerts": true,
  "alertE164": "+16025550131",
  "fromNumberId": null
}

The words

Settings → SMS alert text sets the words for every buyer you switch alerts on for, with a live preview. Leave it empty for the default:

The default
{campaign}: qualified call, {talkTime} talk time, caller {caller}. {link}
PlaceholderBecomes
{campaign}The campaign's name, as it stood when the call arrived.
{talkTime}The buyer's talk time as m:ss, or h:mm:ss from an hour.
{caller}***-***-1234 — the last four digits — unless the buyer may see callers' numbers (the buyer's Show the caller's number once a call qualifies and its seat's Can see the caller's number after a call qualifies are both on), in which case the whole number. The call has qualified by definition.
{link}A link to that call on the buyer's dashboard. It is the platform's own address even when your console is white-labelled, as invitation links are; the text itself never names the platform.
No other placeholder is accepted — saving one is refused, naming it. The template is up to 320 characters; after the placeholders are filled, a text over 320 characters has the campaign name shortened first (ending ..., plain ASCII so the text stays in the standard SMS alphabet), and only then the text itself.

When a text goes, and when it does not

  • Once per qualified call. When the books mark a call converted — at hangup when it passed its qualifying time, or later when a conversion is posted or you correct it — the buyer gets one text. A call converted twice is still one text.
  • A paused buyer still gets texts for calls already put through: pausing stops routing, not the books. An archived buyer gets none.
  • Nothing is sent twice. An alert still waiting to go out ten minutes after it was decided lost its send, and is closed as never sent, at $0.
  • Every alert is listed on the tab under Texts sent — the newest 50 — with the time, campaign, masked caller, the number it went to and from, and what the carrier said: sent, delivered, undelivered or failed.
Skipped becauseMeans
no_alert_numberNo alert number is set for this buyer.
invalid_alert_numberThe alert number is not a US mobile number.
opted_outThe alert number replied STOP, so nothing is texted to it until it texts START.
no_from_numberThis account has no active number that can send texts.
texting_not_configuredTexting is not set up on this platform yet.
A skipped alert is recorded with its reason and costs nothing — it is the answer to "why did my buyer get no text?"

Who pays

You do, from your account's wallet, like your number rent and connected minutes — never the buyer, who has no wallet here. Each text is priced as a message by its carrier cost; see Billing and usage. A text the carrier failed is not billed, and while the platform's SMS charge is switched off, alerts are recorded at $0 and never billed later.

STOP and START

A reply of STOP, STOPALL, STOP ALL, UNSUBSCRIBE, CANCEL, END or QUIT — in any case — to any of your numbers puts the sender on the platform's opt-out list; START or UNSTOP takes it off. Nothing is texted back. No automatic text — an alert, or a buyer's verification code — ever goes to a number on the list, whoever would pay for it. The buyer page shows when a buyer's alert number has opted out.

What the buyer can do

  • Read the texts sent to them on their dashboard's SMS alerts page — never a cost, a sender or an error. A call-back number there follows the same reveal rule as their call log.
  • Switch them off. Only you can switch them back on: you pay for them.
  • Send them to their own verified mobile. An alert number that is their proved mobile follows them: it moves when they prove a new mobile, and is cleared when they give it up or you remove their seat.

Next steps