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

# Twilio Setup

> Learn how to setup voice to voice interactions in Convocore.

Integrate **Twilio** with the Voice Suite to enable seamless phone number management and real-time calling. Follow the steps below to configure Twilio in your Convocore dashboard.

<Note>
  On **v2-2026**, Voice / phone starts on **Business** (2 Twilio slots included) or via the Voice add-on. Extra number slots are \$3/mo. See [Voice pricing](/voice/pricing).
</Note>

***

## 🛠 Step 1: Access the Voice Setup Page

1. Navigate to the **Voice Setup** page in the Convocore dashboard.
2. Select the **Phone Numbers** tab.

<img src="https://mintcdn.com/convocore-app/d6A8Xe6ghCx0eVzo/voice/assets/select_number.png?fit=max&auto=format&n=d6A8Xe6ghCx0eVzo&q=85&s=dce25eea866e2be0ec9bda0bd629a0dc" alt="Voice Setup Page" width="1914" height="858" data-path="voice/assets/select_number.png" />

***

## 📞 Step 2: Purchase or View Twilio Numbers

### 2.1 **View Available Numbers**

* Click on the **Phone Numbers** tab.
* A list of **Available Numbers** will appear.
* To refresh the list, click **"Refresh List"**.

### 2.2 **Purchase a Number**

* Click **"Buy"** next to a Twilio number to purchase it.
* Once purchased, the number will appear under **Purchased Numbers**.

<img src="https://mintcdn.com/convocore-app/d6A8Xe6ghCx0eVzo/voice/assets/twilio-ss.png?fit=max&auto=format&n=d6A8Xe6ghCx0eVzo&q=85&s=6cd4eeb36414690cd1c020e2be0ceaa1" alt="Available and Purchased Twilio Numbers" width="1919" height="863" data-path="voice/assets/twilio-ss.png" />

***

## 🔑 Step 3: Assign a Number to Your Agent

1. Under **Purchased Numbers**, locate the number you wish to assign.
2. Click the **"Assign"** button.
3. Assign the number to your virtual agent (e.g., **test**).

> **Tip**: You can **Release** or **Unassign** numbers if needed.

<img src="https://mintcdn.com/convocore-app/d6A8Xe6ghCx0eVzo/voice/assets/purchase_number.png?fit=max&auto=format&n=d6A8Xe6ghCx0eVzo&q=85&s=8f41440e70b24cbbe1428e2e48b3a56c" alt="Assigning a Twilio Number" width="769" height="661" data-path="voice/assets/purchase_number.png" />

***

## 📥 Step 4: Import Your Own Twilio Number

If you already own phone numbers in your Twilio account, you can import them instead of purchasing through Convocore.

<Steps>
  <Step title="Open the agent Voice settings">
    In the dashboard, go to **Agents** → select your agent → **Voice** → **Phone Numbers** tab.
  </Step>

  <Step title="Start the import">
    Click **Import Twilio Number** in the top-right of the Phone Numbers section.
  </Step>

  <Step title="Enter Twilio credentials">
    Fill in:

    * **Phone Number** — E.164 format (e.g. `+14155551234`)
    * **Account SID** — from your [Twilio Console](https://console.twilio.com) dashboard
    * **Auth Token** — from the same dashboard (stored encrypted by Convocore)
  </Step>

  <Step title="Select capabilities">
    Enable **Voice**, **SMS**, or both. At least one capability is required.
  </Step>

  <Step title="Import">
    Click **Import Number**. Convocore configures voice/SMS webhooks and assigns the number to the **current agent**.
  </Step>
</Steps>

<Note>
  The import is scoped to the agent whose Voice settings you opened. If you manage numbers for multiple agents, repeat the import from each agent's Phone Numbers tab.
</Note>

Imported numbers appear in your workspace phone list with an **imported** indicator. Outbound test calls from the Voice tab are only available for imported numbers.

For API-based imports, see [Import a Twilio number](/api-reference/v3/voices/import-twilio-number).

***

## 📊 Cost Breakdown

* Convocore Voice charges **10 credits per minute** for Twilio calls.
* The cost per minute is displayed in the dashboard:
  * **22 Credits \~ 0.083 USD/Min**.

***

## 🚦 Troubleshooting

### Issue: Twilio Numbers Not Showing Up

* Ensure your Twilio credentials are correct.
* Refresh the list under **Available Numbers**.

### Issue: Calls Not Connecting

* Verify that your assigned Twilio number is active in the Twilio Console.
* Check network settings and webhook configurations.

### Issue: Imported Number Not Working

Imported numbers have extra Twilio-side requirements (routing status, webhooks, emergency address). See the dedicated guide: [Troubleshooting Imported Twilio Numbers](/support/imported-twilio).

Common causes:

* **Inactive regional routing** in the Twilio Console (must show **Active**)
* **Missing or incorrect webhooks** on the phone number
* **Voice capability not enabled** on the imported number

***

## 🔗 Next Steps

<CardGroup cols={2}>
  <Card title="SetUp Web Calling" icon="phone" iconType="solid" href="/voice/setup/webcalling">
    Enable browser-based calling.
  </Card>

  <Card title="Advanced Settings" icon="gear" iconType="solid" href="/voice/config/advanced">
    Customize your voice settings for Twilio.
  </Card>

  <Card title="Imported Twilio Troubleshooting" icon="circle-question" iconType="solid" href="/support/imported-twilio">
    Fix routing, webhook, and configuration issues for imported numbers.
  </Card>
</CardGroup>

You’re all set! Start leveraging Twilio with the Voice Suite to manage phone numbers and real-time calls seamlessly. 🚀