Twilio Voice
An existing Twilio phone number connects incoming callers to a Connic voice agent.
On this page
voice_config.How it works
Connic configures the number's incoming-call webhook and streams audio in both directions. Only incoming calls are supported.
The Twilio account and phone number belong to the customer. Model credentials, prompts, tools, and voice settings remain in Connic's existing project and agent configuration. See Voice agents for supported models and configuration limits.
The run details show the conversation transcript and the tools the agent used. Trace timings and errors help identify where a response was delayed or a tool failed.
Setup
Deploy a voice agent
Add
voice_configto an LLM agent using a supported realtime model, save the provider credentials in the project, and deploy it to the target environment.Prepare the Twilio number
In Twilio, open an existing voice-capable number and check its active incoming-call region. Clear any existing incoming-call routing in that region before connecting the number to Connic.
Save the Twilio connection
Select Twilio Voice from the marketplace when adding a connector to the agent. Create a Twilio connection with the Account SID, region, and that region's Auth Token. Reuse the saved connection for other numbers in the same account and region.
Select the number and call
Choose the phone number, create the connector, and link the voice agent. Connic sets the incoming-call webhook with HTTP POST automatically. Call the number and open the resulting run to inspect the conversation.
Settings and credentials
| Setting | Value |
|---|---|
| Region | US1 (United States), IE1 (Ireland), or AU1 (Australia). Defaults to US1; must match the number's incoming-call region. |
| Account SID | The Twilio account identifier, starting with AC. |
| Auth Token | The selected region's Auth Token, not an API key SID or secret. |
| Phone number | An existing voice-capable number from the selected connection. |
Connic uses the Account SID and Auth Token to validate the account, list numbers, and update their webhooks. The Auth Token also verifies the signatures on incoming Twilio requests. Twilio credentials are regional; see Manage Regional API Credentials to find the matching token.
Changes and troubleshooting
Edit the saved Twilio connection to change credentials or region. Edit the agent's Twilio connector to select another saved connection or number. When changing numbers, Connic installs the new webhook and removes its webhook from the previous number. Deleting the connector removes the number's webhook only if it still points to Connic.
- If creation reports an existing incoming-call webhook, clear it in the selected Twilio region. Editing the same number in another region does not clear that webhook.
- If credentials fail, check that the Auth Token belongs to the selected region and the account is active.
- If a call fails, check that the connector is enabled and linked to exactly one deployed voice agent. Inspect the run error and Twilio's call error details.