Twilio supplies the phone numbers your voice agents answer on. LiveKit carries the audio once a call is connected — you need both for voice.

​
Get Twilio credentials

1

Find your Account SID and Auth Token

Both are on the Twilio Console home page. The Auth Token is hidden until you reveal it.
2

Decide which account to connect

If you use Twilio subaccounts to separate customers, connect the subaccount whose numbers this workspace should manage — not the parent.

​
Connect

Twilio does not use OAuth. In your workspace, go to Settings → Integrations, find Twilio, and enter the Account SID and Auth Token. You can also give the connection a name, which helps when a workspace holds more than one Twilio account. GoConva validates the pair against Twilio and stores them encrypted.
An Auth Token grants full control of the Twilio account, including the ability to spend money on calls and numbers. Rotate it in the Twilio Console if it is ever exposed, and reconnect afterwards.

​
Working with phone numbers

Once connected, the workspace’s Phone numbers page lists the numbers already in your Twilio account alongside the ones registered in GoConva. From there you can import an existing Twilio number, purchase a new one, or release a number you no longer need.

​
Assign an agent to a number

A number does nothing until an agent — and optionally a conversational flow — is assigned to it. Assignment is what routes an inbound call to a particular agent. Assign from the Phone numbers page: pick the number, then choose the agent that should answer it.

​
Voice webhooks

Set VOICE_WEBHOOK_URL in your environment to the publicly reachable URL Twilio should call when a call arrives. For local development, expose your server with a tunnel — Twilio cannot reach localhost.

​
Troubleshooting