# Twilio (Reference: https://docs.iqra.bot/integrations/telephony/twilio)

Twilio is a leading cloud communications platform. Iqra AI integrates seamlessly with Twilio to provision phone numbers and manage call routing.

Prerequisites [#prerequisites]

Before connecting, ensure you have:

* A Twilio Account.
* A **Twilio Phone Number** purchased and active in your Twilio console.
* Your **Twilio Account SID** and **Auth Token**.

Getting Credentials [#getting-credentials]

1. **Log in** to your [Twilio Console](https://www.twilio.com/console).
2. **Account SID & Auth Token:** These are prominently displayed on the main **Dashboard** page. Copy both values.
3. **Phone Numbers:** Navigate to **Phone Numbers** > **Manage** > **Active Numbers**. Find the number you want to use with Iqra AI.

Connecting to Iqra AI [#connecting-to-iqra-ai]

1. Navigate to **Business Dashboard** > **Integrations**.
2. Click **Add Integration** > **Twilio**.
3. **Name:** Give your integration a recognizable name (e.g., "My Twilio Account").
4. **Account SID:** Paste your Twilio Account SID.
5. **Auth Token:** Paste your Twilio Auth Token.
6. **Default Number:** Select the primary Twilio number that will be used for this business. (This can be overridden in campaign routing).
7. Click **Save Integration**.

***

Webhook Configuration [#webhook-configuration]

This is the most crucial step for Twilio to work with Iqra AI. It tells Twilio where to send call events.

Automatic Configuration [#automatic-configuration]

When you save your Twilio integration, Iqra AI attempts to automatically configure the **Voice Request URL** for your Twilio number. It also attempts to set up the **Status Callback URL**.

* **If Successful:** You should see a green checkmark next to your number in the Iqra AI "Numbers" tab.
* **If Failed:** You may see a warning, indicating manual setup is required.

Manual Configuration (If Auto-Fails) [#manual-configuration-if-auto-fails]

If the automatic setup doesn't work, or if you prefer manual control:

1. **Find the Iqra AI Webhook URL:**
   * Go to **Business Dashboard** > **Numbers**.
   * Find your Twilio number in the list.
   * Copy the **Voice Request URL** provided. It will look like: `https://<region-server>.iqra.bot/webhooks/twilio` (e.g., `https://eu-1.sip.iqra.bot/webhooks/twilio`).
2. **Configure Twilio:**
   * In your Twilio Console, navigate to **Phone Numbers** > **Manage** > **Active Numbers**.
   * Click on your specific phone number.
   * Scroll down to the **Voice & Fax** section.
   * For **"A CALL COMES IN"**, select **Webhook** and paste the Iqra AI Voice Request URL you copied.
   * Ensure the HTTP Method is set to **HTTP POST**.
   * **Status Callback URL:** It's good practice to also set the **"Status Callback URL"** to the same Iqra AI webhook URL.
   * Click **Save**.

<Callout type="warn" title="Geo-Permissions">
  Ensure your Twilio account allows outbound calls to the countries you intend to dial. Check your Twilio Console under **Super Properties** > **Geo Permissions**.
</Callout>