Connect SMS with Twilio
Send and receive text messages in the inbox through your own Twilio account and numbers.
For owners and admins
On this page
SMS works through your own Twilio account. You connect Twilio, pick the numbers your customers text, and their messages land in the inbox. Replies go out from the same number. You pay Twilio directly for every message; Luminobot doesn't sell numbers or SMS credit.
You need to be a workspace owner or manager (permission to manage connected accounts and to use chat channels) or an organization owner or admin to connect SMS. Each number you connect uses one connected-account slot on your plan.
Before you start
- A Twilio account with at least one SMS-capable phone number. If you don't have one yet, buy or port a number in Twilio Console → Phone Numbers.
- Your Account SID. It is on the Twilio Console home page, under "Account Info".
- An API key (recommended) or your Auth Token. To create a key, go to Twilio Console → Account → API keys & tokens and create a Standard key. Twilio shows the secret only once, so copy it.
- Texting US numbers? Register for A2P 10DLC first (see below).
Connect your Twilio account
- Open Connect a channel: in the sidebar, click More channels under Connect channels.
- On the SMS (Twilio) tile, click Connect Twilio.
- Choose how to sign in to Twilio:
- API key (recommended): a key just for Luminobot that you can revoke at any time. Enter the Account SID, API key SID (starts with
SK) and API key secret. You can also add your Auth Token (optional). With it, Luminobot checks the signature on every incoming message. Without it, each message is confirmed by looking it up in your Twilio account. - Auth Token: your account's main token. Enter the Account SID and Auth Token.
- API key (recommended): a key just for Luminobot that you can revoke at any time. Enter the Account SID, API key SID (starts with
- Click Continue. Luminobot checks the credentials with Twilio and stores them encrypted.
- On Pick your numbers, tick the numbers to connect. Each one shows whether it supports SMS or SMS + MMS. Short codes on the account (5–6 digit numbers you lease from Twilio) are listed after the phone numbers with a Short code badge.
- Tick the box that lets Luminobot point the numbers' incoming messages here. This changes only the number's "A message comes in" setting in Twilio. Calls and anything else on the number stay as they are.
- Click Connect numbers.
You land on the SMS numbers page. Each number shows its status and whether incoming messages arrive in this inbox.
If a number already sends its messages somewhere else, the list says so. Luminobot replaces that setting and puts it back if you disconnect the number later.
Texting US numbers: A2P 10DLC
US carriers block or filter business texts from local (10-digit) numbers that aren't registered. In Twilio, register your brand and a messaging campaign, then add your numbers to it. Twilio error 30034 means a number isn't registered yet. Toll-free numbers need toll-free verification instead.
Luminobot doesn't block you from connecting an unregistered number. Your messages may simply not reach US customers until registration is done.
Choose how messages go out
By default, messages go out from the number itself. On the SMS numbers page, open Change how messages go out on a number to pick something else. Incoming messages always keep arriving on the number.
- From this number: customers see the number and can reply to it.
- Through the Messaging Service: only offered when the number belongs to a Twilio Messaging Service. Twilio then picks the sender from the service's pool of numbers and applies the service's own settings. When you save, Luminobot checks with Twilio that the number really is in that service. Replies only reach the inbox when they come back to a number you connected. If you added the number to a service after connecting it, click Check Twilio again.
- As a sender name (alphanumeric sender ID): customers see a name such as "ACME" instead of a number. Use up to 11 letters, digits or spaces, with at least one letter.
Before you use a sender name, keep in mind:
- It is one-way. Customers can't reply to a sender name.
- The US and Canada don't support sender names. Texts to +1 numbers always go out from the number instead.
- Your Twilio account must be allowed to use sender names for each country you text, and some countries need the name registered first. Luminobot can't check this. If Twilio refuses a message, the reason shows on the message.
- By default the sender name is only used for broadcasts, drips and Send message on a contact. Inbox replies still go out from the number so the conversation can continue. Tick Also use it for inbox replies to change that.
Opt-outs, delivery receipts and SMS costs work the same way whichever option you pick. Every change is recorded in the activity log.
How SMS works in the inbox
- Replies go out from the number the customer texted, unless you chose another option above.
- Every 160 plain characters is one billed segment. With emoji or other special characters, a segment is 70 characters. The reply box shows a segment counter.
- MMS (pictures, video, audio and PDF) works on US and Canadian numbers. Elsewhere, Twilio sends a link instead.
STOP and START
When someone texts STOP, UNSUBSCRIBE, CANCEL, END or QUIT, they are opted out. Twilio blocks further texts from that number to them, and Luminobot marks the contact as opted out for SMS so broadcasts, drips and workflows skip them. If you try to reply anyway, you see a message saying the person replied STOP.
When they text START, they are subscribed again and you can text them.
Twilio sends its own confirmation for these keywords, so Luminobot doesn't reply to them.
Manage your numbers
To open the SMS numbers page later, click Chat channels in the sidebar, then click the number. For each number you can:
- Point incoming messages here again: use this if the number's Twilio setting was changed and messages stopped arriving.
- Change how messages go out: send from the number, through its Messaging Service, or as a sender name (see above).
- Update credentials: enter a new API key or Auth Token.
- Disconnect: incoming messages stop arriving here, and the number's previous Twilio setting is put back if it still points at Luminobot.
- Add numbers: connect more numbers from the same or another Twilio account.
If something goes wrong
- "No SMS-capable numbers on this account": buy or port a number with SMS in Twilio, then come back.
- The number says incoming messages don't arrive here: click Point incoming messages here again. If the number belongs to a Twilio Messaging Service, check that the service is set to defer to the sender's webhook. The number list warns you when it isn't.
- Messages to US customers fail: check your A2P 10DLC registration in Twilio.
For more help, see Troubleshooting.