Phone Numbers

Provision numbers and route calls.

Setup

  1. Add a number under Phone Numbers. You can connect a number from any supported carrier — Twilio, Vonage, Bandwidth, or any provider that supports SIP/webhook routing.
  2. Point the number's Voice webhook at the platform's inbound endpoint.
  3. Assign the number to a published voice agent in its Inbound Settings.

A Twilio local number runs ≈ $1.15/month, plus ≈ $0.0085/min for inbound voice and ≈ $0.0079/SMS — all passed through at cost. Pricing varies by carrier for bring-your-own numbers.

Tip · To test your agent without a real phone number, use Test Mode in the agent builder's Test panel. It simulates voice and text conversations without placing a real call.

Bring Your Own Number

You can connect a number you already own from any carrier — not just Twilio. Numbers from Vonage, Bandwidth, SignalWire, and other providers are supported. To use one:

  1. Enter the number in the Bring Your Own Number dialog. The platform saves it and generates a webhook endpoint.
  2. In your carrier's dashboard, configure call forwarding or a webhook to route inbound calls to that endpoint.
  3. Assign the number to a published voice agent in its Inbound Settings.

Carrier charges apply on your own account; the platform charges only the orchestration fee ($0.03/min voice, $0.003/message).

Tip · Validation warnings (e.g. 'number not found in Twilio') are expected if you haven't yet set up call forwarding — the number IS saved and the webhook is ready. The warning resolves once inbound calls are routed through.

Call routing

Inbound calls hit the webhook, which returns TwiML that streams the call to the voice server over a WebSocket. The agent answers; tools like transfer_call can hand off to a human or another number mid-call.