Skip to content
Letterhead Letterhead Letterhead Help Center
Admin Tools

Send SMS campaigns to your audience

Edit in CMS

With SMS campaigns you can send text messages to your audience from Letterhead, through your own Twilio account or numbers Letterhead set up for you. SMS campaigns are in early access, so they may not be on for your account yet. You connect Twilio once, create an SMS channel, and then write, send or schedule campaigns from that channel the way you would a newsletter. Each campaign gets its own report, and the channel’s Analytics page shows how your texts are doing over time.

  • A Twilio account with at least one phone number. Letterhead sends through your Twilio account. It doesn’t buy phone numbers for you or register them with carriers. Register your numbers and your messaging campaign in Twilio before you send. Carriers can refuse texts from a number that isn’t registered, and those texts show as Not Delivered in your report.
  • Or numbers Letterhead set up for you. If you’d rather not run your own Twilio account, Letterhead can set texting up for you on its own account with Bird, a messaging provider. Letterhead adds the numbers and takes care of carrier registration, so there’s nothing for you to connect. See If Letterhead set up texting for you.
  • Who can do what. Connecting Twilio and creating an SMS channel need a company administrator. Anyone who can work on a channel can write, send and schedule its campaigns and read their reports, just as they can for a newsletter. SMS templates are for company administrators only, as email templates are.
app.tryletterhead.com
  1. In the company menu, open Settings, then Notification providers.
  2. Click the Twilio card to open Connect Twilio.
  3. Under Twilio account, enter your Account SID and Auth token. You’ll find both in your Twilio Console.
  4. Click Validate credentials. When Twilio accepts them, the other steps unlock.
  5. Under Text messages (SMS and MMS), choose the Phone numbers you’ll send from. They come from your Twilio account, and you can choose up to 50. Only the numbers you choose here can be picked when you write a campaign.
  6. Click Save.

Letterhead checks the connection with Twilio every time you save, and again every hour after that. The card shows the result:

  • Connected: Twilio confirmed the connection and it’s ready to send.
  • Not verified: the connection is saved but Twilio hasn’t confirmed it yet. Check the credentials and numbers, then save again.
  • Connection error: Twilio rejected the connection, for example because the auth token changed. Enter the new details and save.

To add or remove numbers later, open the form again and validate your credentials. You don’t need to re-enter a saved auth token: leave the field blank to keep it.

app.tryletterhead.com

Enable inbound messaging is on, and Reply setup by number shows each number receiving replies.

When a reader texts back, including to unsubscribe, Twilio has to pass that message on to Letterhead. If it doesn’t, readers who text STOP keep their opt-in in Letterhead. This works whether or not your account has the Inbox: STOP, START and HELP are always handled. Set it up in one of two ways, in the form’s Text messages (SMS and MMS) step:

  • Let Letterhead set it up. Enable inbound messaging is on when you connect Twilio for the first time, and you can turn it on later for an existing connection. Letterhead updates the incoming-message setting of each number you chose in your Twilio account. Click Reply setup by number to see how each one went (it opens by itself when a number needs your attention):
    • Receiving replies: the number is set up.
    • Already sends replies elsewhere: the number already sends its replies to another address, so Letterhead left it alone. Click Replace to send them to Letterhead instead. If you later turn inbound messaging off, Letterhead puts the previous address back.
    • Handled by a Messaging Service: a Twilio Messaging Service decides where this number’s replies go. In your Twilio Console, set the service to use each number’s own incoming-message setting, then save again.
    • Couldn’t update in Twilio: Twilio didn’t accept the change. Save again to try once more.
  • Set it up yourself. Once you’ve saved the connection, and with inbound messaging off, copy the Address for replies. In your Twilio Console, open each phone number you send from and set A message comes in to that address, using HTTP POST.

When Letterhead has set up texting for you through its Bird account, you skip the Twilio steps above. There are no credentials to enter and nothing to connect.

app.tryletterhead.com
  1. In the company menu, open Settings, then Notification providers. You’ll see a Bird card.
  2. Click it to see Your Bird numbers. Each number shows where it stands:
    • Ready to send: you can choose it when you write a campaign.
    • Waiting on carrier registration: carriers haven’t finished approving it yet.
    • Being set up: Letterhead is still setting it up.
    • Paused: it can’t send for now.

Only numbers marked Ready to send appear when you write a campaign. You can’t add, change or remove numbers here; contact Letterhead for that.

Readers’ replies reach Letterhead without any setup on your side, so a reader who texts STOP is always opted out. A few things work differently from a Twilio number:

  • HELP is answered by the messaging provider, not by Letterhead. In the countries the provider covers, the reader gets its standard reply, which doesn’t include your company’s details. Elsewhere, a reader who texts HELP gets no reply.
  • Other text replies reach your Inbox. Where replies are available on your account, an ordinary reply to one of these numbers appears in the campaign report’s Responses and in your channel’s Inbox, and your answer goes out from the number the reader texted.
  • Pictures don’t reach your Inbox. A picture a reader texts to one of these numbers isn’t shown, and a reply that is only a picture doesn’t appear at all.

If your company has both its own Twilio account and numbers from Letterhead, and both are connected and working, the composer asks which Messaging provider each campaign goes through, then lists that provider’s numbers under Phone number.

Campaigns are sent from an SMS channel, which sits in a brand group alongside your newsletters.

app.tryletterhead.com
  1. In the company menu, open Settings, then Channels.
  2. In the brand group where the channel belongs, click Create SMS channel.
  3. Enter a Channel Title. Notes are optional.
  4. Click Create, then Create channel to confirm.

You choose which of your Twilio numbers to send from each time you write a campaign.

When you open the channel, its menu shows Home, Analytics, Audience, Campaigns, Inbox and Settings.

Section titled “Step 3: Give contacts a mobile number and their consent”

A contact receives a campaign from this channel only when all of these are true:

  • they are in the audience you choose for the campaign and not in a segment you exclude,
  • they are subscribed to this channel,
  • they have an active mobile number on file,
  • they have opted in to texts from this channel, and
  • they haven’t texted STOP.

Consent is recorded separately for each channel. Opting a contact in to one channel never opts them in to another.

To add a number and an opt-in by hand:

  1. Open the contact’s profile (see How to view or edit an audience member).
  2. In the Text Messaging card, enter the Mobile Number in international format, starting with + and the country code, for example +15551234567, and click Add number.
  3. Under Text Consent, click Opt in next to each channel the contact agreed to receive texts from.

Text Consent lists the SMS channels the contact is subscribed to. The badge next to each shows Opted in, Opted out or Awaiting opt-in, or No number while the contact has no mobile number on file. If you change a contact’s number later, their text consent is cleared, and the new number has to opt in to each channel again.

When you import contacts with the company-wide Contacts importer, a Phone column in your file adds each contact’s mobile number. Imported numbers start as Awaiting opt-in, because having a number isn’t the same as agreeing to texts. See How do I import subscribers?.

A contact doesn’t need an email address to get your texts. Where contacts without an email address are available on your account (early access), you can add a reader by their mobile number alone, or import rows that have a phone number and no email address. Like anyone else, they get a campaign only once everything in the list above is true. See Contacts without an email address.

app.tryletterhead.com
  1. In your SMS channel’s menu, open Campaigns, then All Campaigns.
  2. Choose Start from scratch, or, if you’re a company administrator, Use template on one of your saved SMS templates.
  3. Fill in the message:
    • Message Type: SMS for text only, or MMS to attach a picture.
    • Phone number: which of your Twilio numbers sends it.
    • Subject: the campaign’s name in your Campaigns list. Readers don’t see it.
    • Message: up to 160 characters for an SMS, or 1,600 for an MMS.
    • Unsubscribe Message: sent at the end of every text, up to 160 characters. It starts as “Reply STOP to unsubscribe”, and you can reword it, but it has to contain one of the words readers can text to opt out, such as STOP or UNSUBSCRIBE (the full list is under What readers can text back). The composer tells you as you type if it doesn’t, and a campaign can’t be saved or sent until it does. Make sure the word you ask readers to reply with is on that list: “Reply NO to unsubscribe” is accepted because it contains “unsubscribe”, but a reader who texts NO stays subscribed.
  4. Open Sending Settings. On smaller screens, use the Sending settings button. Choose the Audience, and in Suppress, any segments to exclude. Letterhead shows how many contacts can receive the text.
  5. Choose Send Now, or Schedule and pick a Date and Time. The time is in your channel’s time zone, which is shown above the picker.
  6. Click Send or Schedule, and confirm.

Your draft saves itself a moment after you stop typing, and again when you leave the composer. The line beside Last Updated at the top says Saving… or All changes saved. A draft can only be saved once it has a message within the length limit and an unsubscribe message that contains an opt-out word. Until then that line says it isn’t saved yet. If a save fails, the line says your latest changes couldn’t be saved. Whenever you have an edit that hasn’t been saved, your browser asks before you close the tab. The audience and send time you pick are kept when you send or schedule.

You can also start a text from your channel’s Home page. Type your message there and click Save draft and continue: Letterhead saves it as a draft and opens it in the composer, where you choose who it goes to and when it sends.

To change a scheduled campaign, open it and click Pause & edit. It becomes a draft again, and you can change it and schedule it once more.

Once a campaign has started sending, or has been sent, it can’t be sent or scheduled again, so no one gets the same text twice by accident. To send the same message again, start a new campaign with it.

Carriers deliver a text in segments, and the line under the message shows how many yours uses, for example GSM-7 · 152/160 characters · 1 segment. The count includes your unsubscribe message. It turns amber once your text needs more than one segment.

  • With plain letters, numbers and common punctuation, a one-segment text holds 160 characters. Longer texts are split into segments of 153.
  • One emoji or other special character switches the whole text to a different encoding, shown as UCS-2. Curly quotes and apostrophes pasted from a word processor count too. A one-segment text then holds only 70 characters, and longer texts are split into segments of 67.

Letterhead doesn’t show a cost. Your provider usually charges per segment, so the segment count is the figure to watch.

Use the link icon in the toolbar to Add a link. Paste the full web address and click Shorten and insert, and Letterhead puts a short link in your message.

Tap counts are measured only on links with Track individual contacts turned on. That option gives each recipient their own code, which adds about 75 characters to the link and can add a segment. Leave it off to keep your text short, but you won’t see clicks for that link. If a message with tracked links gets too long, Letterhead sends it without tracking and tells you in the composer.

With MMS selected, use the image icon to attach a JPEG, PNG or GIF of up to 1 MB. Your picture goes out with the message.

Letterhead doesn’t text people overnight. A recipient whose local time is outside 8 a.m. to 9 p.m. when your campaign goes out gets it when their morning window opens. Letterhead uses the recipient’s time zone where it knows it, and your channel’s time zone otherwise. While some texts are waiting, the campaign report says how many and that they will go out automatically.

When a reader replies with one of these words on its own, Letterhead acts on it automatically. Capitals don’t matter. For STOP, punctuation doesn’t either, so “Stop.” and “STOP!” both count. START and HELP must be the word alone, so “Help?” is treated as an ordinary reply. A longer message such as “stop it now” is an ordinary reply too.

  • STOP (also STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT, REVOKE, OPT OUT): the reader stops getting texts from every channel in your company, and any texts still waiting to go to them are skipped. Their profile then says they have opted out of all text messages.
  • START (also UNSTOP, YES): texts resume from the newsletters the reader had opted in to.
  • HELP (also INFO): Letterhead replies from the same number, telling the reader how to unsubscribe, to contact you for help, and that message and data rates may apply. On numbers Letterhead set up for you, the messaging provider answers instead (see If Letterhead set up texting for you).

Any other reply is an ordinary message. Where replies are available on your account, it appears in the campaign report’s Responses and in your channel’s Inbox, where you can read and answer it.

Open a sent campaign from All Campaigns to see its report.

  • Metrics counts each outcome:

    • Sent: everyone the campaign set out to text.
    • Delivered: texts the carrier confirmed as delivered.
    • Not Delivered: texts the carrier couldn’t deliver, that Twilio refused, or that were deliberately not sent.
    • Pending: texts still on their way, waiting for a send window, or waiting for a delivery report.
    • Outcome Unknown: texts whose outcome can’t be determined. This bar only appears when it isn’t zero.

    Delivered, Not Delivered, Pending and Outcome Unknown always add up to Sent. Unsubscribed counts the people who texted STOP after this campaign, and they are already counted in the other bars. When your links track contacts, a line above the bars says how many times readers tapped a link and how many readers tapped at least one.

  • Delivery Errors groups the texts that didn’t arrive by what happened, with the carrier’s code where one was reported.

  • Clicks lists each link with its unique and total clicks. A link that doesn’t track contacts shows Not measured.

  • Unsubscribes lists the numbers that texted STOP after this campaign, and when.

  • Responses shows readers’ replies, where replies are available on your account: one row per conversation, with its latest message. A reply counts toward this campaign when the campaign texted that reader in the 7 days before it.

Delivery reports can take a few minutes to arrive, so the numbers move for a while after sending.

A contact’s profile shows their texts in the activity feed alongside their newsletter activity: Text delivered, Text failed to deliver, Text link clicked, and Replied STOP to texts. Use the feed’s filter to show only Texts delivered, Texts failed, Text link clicks or Text opt-outs. This works for contacts with or without an email address.

Open Analytics in your SMS channel’s menu and pick a date range. The Overview tab shows Sent, Delivered, Delivery Rate, Not Delivered, Clicks, Unique Clicks, Click Rate, Unsubscribed and Unsubscribe Rate for the period, plus your top links. Pending and Outcome Unknown appear when they aren’t zero. The Campaigns tab lists each campaign in the period with its figures.

How the figures are worked out:

  • A campaign counts on the day it was sent, in your channel’s time zone.
  • Delivery Rate is texts delivered as a share of texts Twilio accepted.
  • Click Rate is readers who tapped at least one tracked link, as a share of texts delivered. Unique Clicks adds up each campaign’s unique tappers, so a reader who tapped in two campaigns counts twice.
  • Unsubscribe Rate is opt-outs as a share of texts delivered. An opt-out counts toward a campaign when it comes from someone that campaign texted, within 7 days of it finishing.
  • The rates leave out campaigns that are still delivering, and the page says so while one is.

Open and click-to-open rates don’t apply to texts, so they don’t appear.

  • Phone numbers can be from any country. Write them in international format.
  • Each campaign goes through one of your connected numbers. On your own Twilio account, Letterhead doesn’t buy numbers or register them with carriers; on numbers Letterhead set up for you, it handles both.
  • Automations in an SMS channel’s Campaigns menu isn’t available yet.
  • The Analytics page for an SMS channel has no Audience or Content tab, and no export.

Still can’t find what you need? Contact support.