Skip to main content
Phone numbers connect your Twilio numbers to TurnCall agents. Each number can route to a specific agent or to a webhook for dynamic routing.

Bind a Phone Number

Static routing (to an agent)

Dynamic routing (server URL)

Route calls to a webhook that decides which agent to use:
See Call Init for details on how dynamic routing works. Binding with a server_url returns a server_url_secret — TurnCall signs each call-init request with it so your endpoint can verify the source.

Update a Binding

Re-route a number in place — the phone id and its server_url_secret stay stable, so a call-init endpoint keeps verifying with the same secret across edits:
A secret is minted only when server_url appears on a number that never had one; it is never rotated implicitly.

Configure Twilio

After binding a number in TurnCall, set the Twilio webhook URLs:
  • Voice URL: https://your-host/webhooks/twilio/voice/inbound (POST)
  • Status URL: https://your-host/webhooks/twilio/status (POST)

SMS Support

Enable SMS on a phone number to handle both voice calls and text messages:
When sms_enabled: true is set on bind, TurnCall auto-configures the Twilio SMS webhook. See SMS / Chat for details.

WhatsApp Support

Enable WhatsApp on a phone number:
See WhatsApp for full setup instructions.