# Twilio SMS Quick Start

{% hint style="info" %}
with Twilio, you will need a [Twilio account](https://www.twilio.com/login).
{% endhint %}

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md5dQ-H2CGgxTPnVr3h%2F-Md5euAcdmkjLxTmBAxW%2Fimage.png?alt=media\&token=5778ee17-b913-4674-91b5-0090ad54ad8f)

Twilio is a cloud communications platform that allows you to send and receive SMS text messages through web service APIs.

This Twilio integration lets you respond to SMS messages directly from our platform.

## Setting Up Twilio

**Step 1: Sign in to your Twilio account**\
Sign in with your user credentials. If you don't have a Twilio account, sign up for a free account \
with $15 credit.&#x20;

**Step 2: Get a phone number**\
Head over to the [Twilio Dashboard](https://www.twilio.com/console/) and press the red **Get a Trial Number** button. Twilio will recommend a phone number based on your location.

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md5dQ-H2CGgxTPnVr3h%2F-Md5eyaPyCeeVm-0uZJg%2Fimage.png?alt=media\&token=1c44cac8-a3b5-4b2a-a58b-67957fbd691c)

**Step 3: Choose a phone number**\
Select a phone number that you prefer and best suit your company needs. You can select a number from any country available on Twilio.

{% hint style="warning" %}
Be sure to select a phone number that supports SMS capability as it is required for this connection to work.&#x20;
{% endhint %}

{% hint style="info" %}
Don't forget to add your credit card information to your Twilio Account before you make the SMS Channel public. The charges for each message will depend on your country.
{% endhint %}

## Connecting Twilio (SMS)

**Step 1:** Navigate to **Workspace Settings** > Click **Add Channel**

**Step 2:** Locate the Twilio SMS Channel > Click **Connect**

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/v14rteunel/1696402419634/tsms.gif" alt=""><figcaption></figcaption></figure>

**Step 3: Sign in** with your user credentials at [**Twilio**](https://www.twilio.com/login)

**Step 4:** Locate the Account SID and Auth Token on the dashboard and add them to the corresponding fields on the IS-Messenger platform.

![](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-Md5f4_L0m_LJ5v_z4hG%2F-Md60Liku5Arw_rmHw-E%2Fimage.png?alt=media\&token=3d4ba924-ab49-4712-b881-0b4233522f4f)

**Step 5:**&#x53;elect the Twilio phone number on the IS-Messenger platform.

**Step 6:** Click Save Changes to complete the setup in IS-Messenger.

{% hint style="success" %}
Once you completed the setup, any SMS sent to the Twilio phone number will now be received in your space.
{% endhint %}

## Channel Configuration

{% hint style="info" %}
Twilio SMS channel can be configured with a unique Channel Name.
{% endhint %}

**Step 1:** Navigate to **Workspace Settings** > Click **Channels**.

**Step 2:** Locate the Twilio WhatsApp Channel > Click **Manage > Configuration.**

**Step 3:** Configure the Channel name, which is used internally to identify the account.

{% hint style="warning" %}
Ensure all your details are entered correctly as errors may cause failure to receive messages from the connected Twilio SMS account.
{% endhint %}

**Step 4:** Click **Save Changes** to update the Channel configuration.

### FAQ and Troubleshooting <a href="#faq_and_troubleshooting" id="faq_and_troubleshooting"></a>

If you're unable to receive messages after following the instructions above, we recommend you to check the Twilio Webhook Configuration for the selected Phone Number.

**Step 1: Sign in to** [**Twilio**](https://www.twilio.com/login)

Sign in with your user credentials at Twilio.

**Step 2: View Phone Numbers Settings**

From the side navigation menu, view all **Products and Services** and select **Phone Numbers**.

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/v14rteunel/1663765913353/troubleshooti.png" alt="Twilio Dashboard"><figcaption></figcaption></figure>

**Step 3: Select on the phone number**

From the list of phone numbers, choose the phone number you would like to troubleshoot.

**Step 4: Check the webhook details**

Navigate to the Messaging section and check the webhook details.

Make sure that the following webhook appears under **A MESSAGE COMES IN** field `https://app.`is-global.com`/twilio/webhook`

<figure><img src="https://files.helpdocs.io/9e3syfbzn8/articles/v14rteunel/1663766067759/troubleshooting-2.png" alt="twilio dashboard phone numbers page"><figcaption></figcaption></figure>

By default we add the correct webhook to your phone number configuration when it's connected for the first time; however if you have previously installed other tools to that number, this might cause the wrong webhook to be stored on that field, preventing messages from being passed to IS-Messenger platform.
