Skip to main content
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.
Twilio is only required for phone call interviews. If you only use Google Meet, you can skip this setup.

Prerequisites

Step 1: Get your Twilio credentials

1

Log in to Twilio Console

2

Find your credentials

On the Console dashboard, locate:
  • Account SID — Starts with AC
  • Auth Token — Click the eye icon to reveal it
3

Copy both values

You’ll enter these in Vocalis.

Step 2: Get a phone number

If you don’t already have a Twilio phone number:
1

Go to Phone Numbers

Navigate to Phone NumbersManageBuy a number.
2

Choose a number

Select a number with Voice capability. Choose a local number in a region appropriate for your candidates.
3

Purchase

Click Buy to add the number to your account.

Step 3: Connect to Vocalis

1

Open Vocalis settings

Log in to vocalis.witting.ai and go to SettingsIntegrations.
2

Enter Twilio credentials

In the Twilio section, enter:
  • Account SID
  • Auth Token
  • Phone Number (the Twilio number that will be the caller ID)
3

Save and test

Click Save. Use the Test Connection button to verify.

Step 4: Configure webhooks (if required)

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

Go to your phone number settings

In the Twilio Console, navigate to Phone NumbersManageActive Numbers and click your number.
2

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
3

Save

Click Save configuration.

Troubleshooting

IssueSolution
”Authentication error”Double-check your Account SID and Auth Token. Make sure there are no extra spaces.
Calls not connectingVerify the phone number has voice capability and your Twilio account has sufficient balance.
Candidate hears nothingCheck that the webhook URL is correctly configured and reachable.

Next steps