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

# Twilio Setup

> Set up Twilio so Vocalis AI Actors can conduct phone call interviews. Get your credentials, buy a number, connect to Vocalis, and configure webhooks.

Vocalis uses Twilio to conduct phone call interviews. The Actor calls the candidate at the scheduled time and conducts the interview over a standard voice call.

<Note>
  Twilio is only required for phone call interviews. If you only use Google Meet, you can skip this setup.
</Note>

## Prerequisites

* A Twilio account ([sign up at twilio.com](https://www.twilio.com))
* A Twilio phone number capable of making outbound calls

## Step 1: Get your Twilio credentials

<Steps>
  <Step title="Log in to Twilio Console">
    Go to [console.twilio.com](https://console.twilio.com).
  </Step>

  <Step title="Find your credentials">
    On the Console dashboard, locate:

    * **Account SID** — Starts with `AC`
    * **Auth Token** — Click the eye icon to reveal it
  </Step>

  <Step title="Copy both values">
    You'll enter these in Vocalis.
  </Step>
</Steps>

## Step 2: Get a phone number

If you don't already have a Twilio phone number:

<Steps>
  <Step title="Go to Phone Numbers">
    Navigate to **Phone Numbers** → **Manage** → **Buy a number**.
  </Step>

  <Step title="Choose a number">
    Select a number with **Voice** capability. Choose a local number in a region appropriate for your candidates.
  </Step>

  <Step title="Purchase">
    Click **Buy** to add the number to your account.
  </Step>
</Steps>

## Step 3: Connect to Vocalis

<Steps>
  <Step title="Open Vocalis settings">
    Log in to [vocalis.witting.ai](https://vocalis.witting.ai) and go to **Settings** → **Integrations**.
  </Step>

  <Step title="Enter Twilio credentials">
    In the **Twilio** section, enter:

    * **Account SID**
    * **Auth Token**
    * **Phone Number** (the Twilio number that will be the caller ID)
  </Step>

  <Step title="Save and test">
    Click **Save**. Use the **Test Connection** button to verify.
  </Step>
</Steps>

## Step 4: Configure webhooks (if required)

Depending on your Vocalis setup, you may need to configure Twilio webhooks to point to Vocalis:

<Steps>
  <Step title="Go to your phone number settings">
    In the Twilio Console, navigate to **Phone Numbers** → **Manage** → **Active Numbers** and click your number.
  </Step>

  <Step title="Set the Voice webhook">
    Under **Voice Configuration**, set:

    * **A call comes in**: Webhook
    * **URL**: The webhook URL provided in your Vocalis integration settings
    * **HTTP Method**: POST
  </Step>

  <Step title="Save">
    Click **Save configuration**.
  </Step>
</Steps>

## Troubleshooting

| Issue                   | Solution                                                                                     |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| "Authentication error"  | Double-check your Account SID and Auth Token. Make sure there are no extra spaces.           |
| Calls not connecting    | Verify the phone number has voice capability and your Twilio account has sufficient balance. |
| Candidate hears nothing | Check that the webhook URL is correctly configured and reachable.                            |

## Next steps

<Columns cols={2}>
  <Card title="Create a Meeting" icon="calendar" href="/vocalis/getting-started/schedule-meeting">
    Schedule a phone call interview.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/vocalis/getting-started/quick-start">
    Run your first interview.
  </Card>
</Columns>