How to set up a Twilio SMS inbox in Front

Overview

Twilio is a service that provides phone numbers to send and receive SMS and calls, built on an API meant for global scale. Front's Twilio channel integration allows you to send and receive SMS messages in an inbox in Front using a regular phone number or a shortcode, and use all the collaborative features of Front just like with email.

---

Instructions

Step 1

Click the gear icon on the top right of Front and into the Company or Personal settings tab, depending on which space you are working with. Admins can also access user settings by following these steps.

Step 2

Click on Inboxes on the left menu and Add an individual inbox or Add a team inbox, depending on which space you're in.

Step 3

Fill out the name and description of your inbox. Click Create.

Step 4

Choose SMS from the channel menu.

Step 5

Go to the Twilio website, and log in.

Step 6

You should now be looking at your Twilio console dashboard, which is where you will find your Account SID and Auth Token. Copy and paste those into your Front Twilio settings.

Step 7

Now, select a phone number from the dropdown.

Step 8 (optional)

If you don't see the number you need or if the number is a shortcode, click the link on the bottom that says Can't find your phone number in the list? Enter it manually.

You'll see a new box appear where you can enter the number you need. From your Twilio console, copy and paste the number you'd like to use into the Front inbox setup. If it's a regular phone number, the format should include the country code and the area code, like this: +1 (123) 456-7890.

Step 9

Click Verify Account. We will then automatically validate these credentials with Twilio. If you receive an error, please double check that you have entered everything correctly.

---

FAQ

Does my Twilio history import into Front?

Yes, Front will import 100 of the most recent message of your Twilio history into the Archived tab of the inbox. If you've used another SMS platform, that portion of the history might be importable via API, but feel free to contact us and we'll take a look.

Do Front and Twilio have a full two-way sync?

Not fully. All inbound messages should be received by Twilio and sent to Front. Any outbound messages sent directly from Twilio will only be imported into Front after a new inbound message is received in the conversation. Front will import up to 20 previous messages for any conversation.

Why did my messages stop coming into Front?

Check that the webhook in your Twilio settings is filled in with the Front webhook. Since Twilio only allows one webhook per phone number, connecting other apps to this phone number may override Front's webhook, thus stopping Front from receiving your messages.

Why can't I send SMS?

If you ever experience issues sending an SMS message in Front, check the Twilio console for the status of the message you sent. For reference, here's a dictionary of errors and warnings you may experience using Twilio.

How many contacts can I message at once?

Front allows you to send a single SMS message to 200 contacts at a time. On sending an SMS to a group of recipients, each recipient will receive their own individual copy of the message, in a 1:1 conversation between your SMS channel, and their number. 

I'm trying to compose a Twilio message to a specific contact. Why isn't my contact showing up in the recipient field?

Only contacts that have an associated phone number will show up as suggested recipients when sending in a Twilio channel. In order for your contact to appear, you will need to first add their phone number by editing their contact information. 

---

Pricing

This feature is available on all plans. Some legacy plans may not have access to Twilio SMS channels.