> ## Documentation Index
> Fetch the complete documentation index at: https://docs-classic.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Twilio SMS

![Twilio SMS Endpoint logo](https://mintcdn.com/cognigy-docs-legacy/RomCLoWcsmr9N2pz/_assets/ai/deploy/endpoint-reference/twilio.png?fit=max\&auto=format\&n=RomCLoWcsmr9N2pz\&q=85\&s=8e9a9ed24f06035e22e4b2ae7268f56a)

The Twilio SMS Endpoint enables you to connect your AI Agent to the [Twilio platform](https://www.twilio.com/) to handle SMS and WhatsApp messages. Via this Endpoint, your end users can interact with your AI Agent through text messaging.

## Prerequisites

* Access to the [Twilio platform](https://www.twilio.com/).

## Generic Endpoint Settings

Learn about the generic Endpoint settings on the following pages:

* [Endpoints Overview](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/overview)
* [NLU Connectors](https://docs-classic.cognigy.com/ai/platform-features/nlu/external/nlu-connectors/overview)
* [Data Protection & Analytics](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/data-protection-and-analytics.md)
* [Session Management](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/session-management.md)
* [Real-Time Translation Settings](https://docs-classic.cognigy.com/ai/agents/deploy/endpoints/real-time-translation-settings.md)
* [Transformer Functions](https://docs-classic.cognigy.com/ai/for-developers/transformers/overview)

## How to Set Up

### Configure on the Cognigy Side

> [accordion] 1. Create a Twilio Endpoint
>
> To create a Twilio Endpoint, follow these steps:
>
> 1. Go to **Deploy > Endpoints**.
> 2. On the **Endpoints** page, click **+ New Endpoint**.
> 3. In the **New Endpoint** section, do the following:
>    1. Select the **Twilio SMS** Endpoint type.
>    2. Specify a unique name.
>    3. Select a Flow from the list. Save changes.
> 4. In the **Configuration Information** section, copy the Endpoint URL and save it for later use.

### Configure on the Twilio Side

> [accordion] 1. Get a Phone Number
>
> 1. Open the Twilio Console. Go to the Account Dashboard.
> 2. In the left sidebar, select the **Develop** tab, then go to **Phone Numbers > Manage > Buy a Number**. Select the country and ensure the number supports SMS. Activate **SMS**. You can search for area code, for example, 211, which shows numbers available for Düsseldorf, Germany. Select the number and click **Buy**.
> 3. Some phone numbers require you to validate that your company operates in the same city or region. This approach is common for German numbers. To validate the number, read the [Twilio documentation](https://help.twilio.com/) and upload proof of your company registration. The validation process can take up to 3 business days. US numbers don't require this validation.
> 4. Go to **Active Numbers**. Select the number, then go to **Voice Configuration**. From the **A call comes in** list, select **Webhook**. In the **URL** field, enter the Cognigy Endpoint URL. Click **Save configuration**. To test the connection, send an SMS to your Twilio number.

> [accordion] 2. Connect Your Twilio Number to WhatsApp
>
> 1. Go to **Explore Products > Messaging**.
> 2. Select **WhatsApp**. To connect the Twilio number to WhatsApp, your Twilio account must first be approved by WhatsApp.

## More Information

* [Cognigy Help Center: Twilio Intro](https://support.cognigy.com/hc/en-us/articles/360016308619-Twilio-Intro)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.