> ## 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 ![Twilio 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 Endpoint enables you to connect your AI Agent to the [Twilio platform](https://www.twilio.com/), which allows you to handle voice calls directly through Twilio. ## 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) ## Specific Endpoint Settings > [accordion] Twilio Settings > > | **Parameter** | **Description** | > | - | - | > | STT / TTS Language | The language used by the Speech-to-Text (STT) and Text-to-Speech (TTS) services for messages exchanged between Twilio and Cognigy. | > | Voice | The delivery voice for your Twilio voice bot from the list of available Twilio voices. | ## How to Set Up ### Configure on the Cognigy Side > [accordion] 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** Endpoint type. > 2. Specify a unique name. > 3. Select a Flow from the list. Save changes. > 4. In the **Twilio Settings** section, configure the following settings: > * **STT / TTS Language** — select the language used by the Speech-to-Text (STT) and Text-to-Speech (TTS) services for messages exchanged between Twilio and Cognigy. > * **Voice** — select the delivery voice for your Twilio voice bot from the list of available Twilio voices. > 5. In the **Configuration Information** section, copy the Endpoint URL and save it for later use. Save changes. ### Configure on the Twilio Side > [accordion] 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 voice messages. Activate **Voice**. 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**. ## Additional Configuration > [accordion] Trigger Twilio to Initiate a Call > > In addition to receiving calls from Twilio in Cognigy, you can also trigger Twilio to initiate a call. > > 1. Create a [TwiML Bin](https://www.twilio.com/docs/serverless/twiml-bins/getting-started) in Twilio to handle the call. Twilio can host TwiML (Twilio Markup Language) for you. This TwiML tells Twilio what to do after the call connects. Use the following TwiML, replacing `your_endpoint_url` with your valid Cognigy Endpoint URL: > > ```xml theme={null} > > > your_endpoint_url > > ``` > > Copy the URL of the TwiML Bin for later use. > > 2. Add an HTTP Request Node to your Cognigy voice Flow. To configure this Node to trigger Twilio to make a call and connect the call back to the Flow, set the following parameters: > > | **Parameter** | **Description** | > | - | - | > | Type | The HTTP method used to send the request. Enter `POST`. | > | URL | The URL pattern is `https://api.twilio.com/2010-04-01/Accounts/your_twilio_account_sid/Calls.json`. Replace `your_twilio_account_sid` with your actual Twilio account SID. | > | Headers | The header is `Content-Type: application/x-www-form-urlencoded`. Required to tell Twilio the request format. | > | Payload is JSON | A flag that controls the payload format. Enter `false`. | > | Payload | The data sent in the request body. Use: `To=number_to_call&Url=your_twiml_bin_url&From=your_twilio_number` - `to` – the phone number to call. - `url` – the URL of your TwiML Bin. - `from` – your Twilio phone number. | > | Authorization Type | Twilio requires basic authentication for API calls. Enter `Basic Auth`. | > | Username | Your Twilio **Account SID**. You can find this on the Account Dashboard. | > | Password | Your Twilio **Auth Token**. You can find this on the Account Dashboard. | ## 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.