# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.is-messenger.com/ismessenger/messaging-channels/sms/twillio-sms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
