SMS provider: Twilio

Overview

This page provides information about how to:

• Get the account SID and authorization token

• Create Sub Account

• Get a Twilio number

• Create a messaging service

• Set up the delivery status callback URL

Get an account SID and authorization token

An account SID and an authorization token are both required to build an application that integrates with Twilio using our API.

1. Sign up for a Twilio account and log in.

2. Once your account is verified and has a phone number, go to your Account management page.

3. In the submenu, select API keys & tokens. Scroll down to Auth Tokens and your live credentials (Account SID & Auth Token) will be shown as displayed.

4. Select the lock icon to show the authorization token. The account SID and authorization token are now displayed.

5. There is only one Auth Token by default, so you should avoid sharing this Auth Token to minimize the risk of it becoming compromised. If the Auth Token is compromised for some reason, create a secondary Auth Token by selecting Request a Secondary token beside the Auth token.

6. Your Primary and Secondary tokens will be shown as displayed. Select the lock icon (eye) to show the authorization token.

Create a subaccount

Subaccounts are just like accounts, but they are owned and can be managed by the parent account. Instead of using the Auth Tokens of the parent account, you can use the Auth Tokens of the subaccount. If the auth token of the subaccount is compromised, the token cannot be used to access resources of the parent account or other subaccounts.

1. Go to your Account management page.

2. In the submenu, select Subaccounts.

3. Select Create subaccount.

4. Enter a Friendly name.

5. Select Create.

Get a Twilio number

1. Sign up for a Twilio account and log in.

2. Initially, your account will be associated with a phone number already. You can choose to release your initial number and buy a new one if you upgrade your account.

3. View your number(s) by going to your console page. From the Develop tab, click Phone Numbers, then select Active numbers from the submenu.

4. Optionally buy additional numbers for your account on the Buy a Number page.

Create a Messaging Service

A messaging service is a container that bundles messaging functionality, especially for a large volume of recipients. A messaging service ID is required for our application to send SMS messages to Twilio.

1. View your messaging service(s) by going to your console page. From the Develop tab, click Messaging then select Services from the submenu.

2. Click Create Messaging Service to configure. Assign phone numbers to the sender pool and finish integration.

3. After set-up, view the Messaging Service SID in the Properties page. Copy the SID into the Twilio channel configuration.

Set up the Delivery Status Callback URL

The delivery status callback is a URL that Twilio calls to send delivery status of outbound messages.

1. Go to the messaging services page of the console and click the desired messaging service.

2. Click Integration from the submenu. Set the callback URL of the Delivery Status Callback.

Additional resources

• RPI: Configuring Twilio SMS channel

• Best practices: Twilio

• Best practices: Twilio functional guide

• Best practices: Twilio UI configuration

• Best practices: Using Twilio in RPI