Voice numbers

A voice number connects a phone number to a voice agent. When someone dials it, they reach the bot, hear its greeting, and start a voice conversation.

The mapping

A voice number maps a phone_number to a bot_id. You can override the spoken voice (tts_voice) and set a per-number greeting, so the same agent can answer different lines with different openers. Create and manage these mappings in the dashboard or over the Voice API.

Inbound calls

Once a number is mapped, inbound calls are handled automatically — the agent answers, greets the caller, and the call becomes a voice conversation you can read and trace with the Conversations API (filter by channel=voice).

Outbound

Outbound calls are placed with the Calls API; caller ID and routing are resolved from the bot's outbound voice-number configuration, so you only pass the bot and the number to dial.