> For the complete documentation index, see [llms.txt](https://buildersupport.gitbook.io/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://buildersupport.gitbook.io/hub/internal-integrations/twilio.md).

# Twilio

To set up your project to start sending SMS, WhatsApp, and Voice messages, you'll need a Twilio account [here](https://www.twilio.com/).

## **What is Twilio?** <a href="#what-is-twilio" id="what-is-twilio"></a>

**Twilio** is a service that helps businesses send texts, make calls, and communicate with customers. It’s like a toolkit that lets you add messaging or calling features to your app or website easily, without needing to build everything yourself. This way, you can stay connected with your users through SMS, WhatsApp, voice, and more.

### Getting Connected <a href="#getting-connected" id="getting-connected"></a>

Once you have registered for a Twilio account you will be directed to the Twilio main dashboard as shown below.

{% hint style="info" %}
To use Twilio's SMS and WhatsApp features you are required to purchase a number
{% endhint %}

Simply click the - Get phone number button.

<figure><img src="/files/VusIzElN9QVYq1QF65V7" alt=""><figcaption></figcaption></figure>

### Purchasing a Twilio Number <a href="#purchasing-a-twilio-number" id="purchasing-a-twilio-number"></a>

Here, you can select the country you want to register the number in. There are standard filters that allow you to type in numbers you'd like to include within the number itself. You can also refine the filter using the '**Advanced Search**' to get a more localized number if you prefer, such as one based on your city.

Once you've decided on a number go ahead and purchase it.

{% hint style="info" %}
Note: You can 'purchase' a number without paying anything. It will be defined as a trial number that you can use for testing purposes only. Once you enter your billing details, the number will become active.
{% endhint %}

<figure><img src="/files/ikbcLaizuMAGedO5mrGs" alt=""><figcaption></figcaption></figure>

Once done it will take you through the next steps, which are mostly tick boxes and verifying your number select.

<figure><img src="/files/8pyDvGc2TjQFI6N8Wp4n" alt=""><figcaption><p>Tick agree and Click next</p></figcaption></figure>

<figure><img src="/files/OPX179DvkSNXvblHDP26" alt=""><figcaption></figcaption></figure>

The **select end user** step is where you can chose between Business or Individual. This is optional to what you do. For example, when selecting **Business** you will have to fill out your business credentials. If selecting **Individual**, no business details are required - just a photo ID is required.

<figure><img src="/files/AH3XQg6MUeYwK7a0hq6O" alt=""><figcaption></figcaption></figure>

When you reach this step, if you have not already set up your bundle, you will need to do that first. If you have already created a bundle in Twilio, it will be displayed in the 'Assign Approved Bundle' tab.

### Creating a Bundle <a href="#creating-a-bundle" id="creating-a-bundle"></a>

To create a bundle within Twilio, navigate to the **main dashboard** > **Regulatory Compliance** > **Bundles**

Follow the steps - it will guide you through step by step.

<figure><img src="/files/5POftkuZDJXSHqxJMMSq" alt=""><figcaption></figcaption></figure>

### Creating a Service <a href="#creating-a-service" id="creating-a-service"></a>

Creating a Messaging Service in Twilio enables you to send messages. To set up your messaging service, go to the main Twilio **dashboard** and select **Messaging** > **Services**. You will then see the dashboard shown in the image below.

{% hint style="success" %}
Messaging Services are for sending bulk SMS and WhatsApp messages.
{% endhint %}

<figure><img src="/files/bKO7xANQQeBT2PVXj45T" alt=""><figcaption></figcaption></figure>

### Link The Service to Your Phone Number <a href="#link-the-service-to-your-phone-number" id="link-the-service-to-your-phone-number"></a>

The final step is to link the Messaging Service to your Twilio phone number.

First, navigate to the main Twilio **dashboard** > **Phone numbers** > **Manage** > **Active numbers**

Click on your phone number you want to add the messaging service to.

<figure><img src="/files/uLfMBXPhvZWw9QAvFAzx" alt=""><figcaption></figcaption></figure>

Once you have selected the number to add the service to, a new window will open. Scroll down toward the bottom.

Under the **Messaging Service** tab you will be able to select the service you have created. Select the service and click **Save** at the bottom left side.

<figure><img src="/files/6xTN2ejSUQGUWpB4dFBp" alt=""><figcaption></figcaption></figure>

That's you now connected with Twilio and ready to start sending SMS and WhatsApp messages to your customers.

{% content-ref url="/pages/Di7mbdlnLE3W0kpFDPMK" %}
[SMS & WhatsApp](/hub/platform/messaging-and-workflows/sms-and-whatsapp.md)
{% endcontent-ref %}

Below is a simple flow diagram for reference:

<figure><img src="/files/r8QLIuxswLFDTeBTs4Pg" alt=""><figcaption></figcaption></figure>