Personyze Wiki Personyze Wiki docs
English
Open Personyze
Docs/ Campaigns/ SMS — Text a Visitor When a Campaign Matches
Campaigns

SMS — Text a Visitor When a Campaign Matches

Send a text when a campaign matches — through your own Twilio, Vonage, Plivo, Telnyx, Bird or Sinch number. What a segment costs, why one emoji doubles it, and how STOP is recorded.

9 min read Updated 2 weeks ago

SMS on Campaign Match sends a text message when a campaign matches a visitor — to the
visitor themselves, if their phone number was captured, or to a fixed number such as a sales line. Personyze fields go
into the text exactly as they go into an email.

It is an ordinary action, so it carries the ordinary
targeting, the ordinary reporting, and the ordinary
caps. What is different is that you bring the sender.

To text the people in your user base, rather than a visitor on your site, use it in an Email & SMS Personalization campaign (New campaign → Email & SMS), on its own or as a step after an email — see Email campaigns.

Personyze has no SMS number of its own, and there is no fallback. The email action can fall back to
the Personyze mail server because one exists; there is deliberately no house SMS sender. A text from a number the
recipient cannot reply to, billed to us, with a STOP arriving somewhere that means nothing to the account that sent it,
is worse than no text at all. An action with no provider chosen does not send — it errors.

Connecting a provider

On the action, under Send through → Add provider, or in Integrations → SMS delivery, which lists Your SMS providers. Six are set up ready:

Provider What it calls the credentials Worth knowing
Twilio Account SID · Auth Token Both are on the front page of the console. The sender can be a number you own, a name of up to 11 letters, digits and spaces where Twilio allows one — not in the US or Canada — or a Messaging Service SID (it starts with MG).
Vonage API key · API secret On the dashboard home page under API settings. Vonage lets the sender be a name of up to 11 letters and digits rather than a number in many countries — but not in the US or Canada, where it must be a number you own.
Plivo Auth ID · Auth Token The sender can be a name of up to 11 letters and digits where Plivo allows one — not in the US or Canada, where it must be a number you own.
Telnyx API key One credential, so the form shows one field. The sender is always a number.
MessageBird (Bird) Access key Use a live key. A test key is accepted and returns success without sending anything. The originator can be a name of up to 11 letters and digits — not in the US or Canada.
Sinch Service plan ID · API token The host is regional. Change it here if your service plan lives outside the EU. The sender can be a name of up to 11 letters and digits — not in the US or Canada.

Every provider names the same two secrets differently — Account SID and Auth Token, API key and API secret,
Auth ID and Auth Token — so the form asks for them by that provider’s own names rather than
“username” and “password”. The API host is filled in for you and stays editable, because
several providers have regional hosts.

Countries this provider may text

Each provider in Integrations → SMS delivery has Countries this provider may text. A text to a number in any other country is not sent — it protects your account from fraud that texts costly numbers abroad. The default is your own countries, read from your sender numbers; choose others to change it. A provider whose sender numbers give no country texts nobody until you choose. On the action, the sender step says which countries the chosen provider texts, with a link to change them.

A sender the carrier has not approved is rejected, not delivered late. Save the provider, then press Test on it and Send to text yourself through it: an unverified number, a trial account or an unapproved sender shows up there in the carrier’s own words.

Who it goes to

  • Use the visitor’s number — whatever was captured onto their profile.
  • A fixed number — a sales line, an on-call phone, a shared inbox.

Numbers must carry the country code: +15555550123. So must the sender.

When texts go: quiet hours

The action’s Timing step has Hours. Switch on Only at set hours and choose Send only between two times: nothing goes outside them. Anyone due before the start waits for it; anyone due after the end waits for the next start. An end before the start runs past midnight; with no end hour it means “not before”.

  • A new text to the visitor’s own number starts with quiet hours on: only between 09:00 and 20:00, in each person’s own time zone. For anyone whose zone is not known, the hours are read in the zone chosen under For people whose zone we don’t know: — your account’s, unless you pick another.
  • A text to a fixed number, such as your team’s lead alert, goes as soon as it is due, day or night. Set hours to hold it; they are read in your account’s time zone.
  • A text to the visitor with no hours is offered them, with Use these hours.

How many: the cap per person and the daily ceiling

  • Text message cap, in Settings → Email setup → Sending limits, limits how many of your texts one person gets in a period, however many campaigns they are in — switched on, it starts at 2 texts per 7 days. A text over the cap is skipped, not failed: a campaign that sends when its audience rules match offers it again once the person has room, and one fired by an event waits for that event to happen again. Texts to a fixed number are never capped, and a text that must go — an order update — can switch on Ignore the account cap in its Timing step.
  • At most 500 texts are sent in any 24 hours for an account, to protect it from SMS fraud. Any more wait in the queue until there is room — none are dropped.

Ready-made texts

Adding the action offers five texts to start from, or Start blank:

Template For
Order Thank-You Thanks the customer by name right after an order, and says a text will follow when it ships.
Cart Reminder A gentle nudge to a shopper who left items in the cart: nothing is lost. Pair it with an audience rule for an abandoned cart.
Thank-You Coupon Thanks a customer and gives a discount code for the next order. Change THANKS10 to a code of your own before you publish.
We Miss You For customers who have not visited in a while. Pair it with an audience rule for the days since the last visit.
Lead Alert Goes to a fixed number of your own, not to the visitor: who just matched the campaign, so someone can follow up while they are interested.

Each greets the person by first name, with a fallback (“friend”, “there”) when the name is not known. The four that go to a customer end with “Reply STOP to opt out.” All of them stay in the standard SMS alphabet, so most fit in one message — see What one message costs.

What one message costs

A text is billed by the segment, and the rules are not guessable from looking at the message:

  • If every character is in the standard SMS alphabet, one segment holds 160 characters.
  • A single character outside it — a curly quote, an em dash, an emoji, any non-Latin script
    — switches the whole message to the wider encoding, where one segment holds 70. Not 70 for that
    character and 160 for the rest: 70 for all of it.
  • Splitting is not free either. Concatenated parts each give up room to a header, so a two-part message holds
    153 per part rather than 160 — or 67 in the wider encoding.
The composer counts this live and names the culprit: “’ and — are not in the standard SMS
alphabet, so every message now holds 70 characters instead of 160”
, and
“{n} left before this becomes another message”. A smart quote pasted out of a word
processor can double the bill without changing anything you can see.
If a message is suddenly two parts, that
is almost always why.

Replies, and STOP

Personyze keeps its own list of people who answered STOP or unsubscribed, and checks it before every text, whatever the provider does. For replies to reach that list, open the provider in Integrations → SMS delivery: under Replies: STOP and START it shows the address to paste into the provider’s console, and where — for a Twilio number, Phone Numbers › Manage › Active numbers › your number › Messaging Configuration; for a Messaging Service sender, the service’s Integration page.

The address is given for Twilio, whose replies Personyze can check are really Twilio’s. For the other providers the section says that a STOP sent to them does not reach Personyze — people can still opt out on your unsubscribe page — and what that provider does with a STOP by itself. When replies do reach Personyze:

  • STOP — and stopall, unsubscribe, cancel, end, quit, optout — opts that number
    out for your account.
  • START withdraws a STOP, and only that. Somebody texting a number they never subscribed to has not
    consented to anything, so it is not treated as an opt-in.
  • HELP — or info — is answered with your account’s name, your site and “Reply STOP to opt out.”, as US carriers expect.
  • To a STOP or a START, Personyze sends no auto-reply. The carrier sends the STOP confirmation itself, and a second message
    on top of it would be redundant — and in some countries another billable message to somebody who just asked you to
    stop.

A word is matched against the whole message, never as a substring: “please don’t
stop sending these”
contains the word and means the opposite, and reading it as a STOP would silence somebody
who asked for more — a mistake nobody ever reports, because the symptom is silence.

Your provider already blocks stopped numbers, silently and only for itself. Without the webhook the
campaign keeps queueing, the provider keeps refusing, and the log fills with failures nobody can read as “this
person asked us to stop”
. Recording the opt-out in Personyze is what makes it visible, and portable to a
provider that does not do it for you.

When one does not arrive

Delivery failures come back on the send itself and are written onto the campaign log — the inbound webhook is
for replies, not delivery reporting. The usual causes: no country code, a sender the destination country will not accept
(a sender name into the US, for instance), a test key that reports success, a number that has opted out, or a number in a country the provider may not text.

Get an AI plan for your site

Inspire me reads your website and suggests the personalization campaigns to run first, and who should see each one. Free.

Scan your site
Did this page answer your question?
Thank you — that goes to whoever maintains this page.