phone-volumePhone Number Management

Provision, route, and manage phone numbers that connect inbound calls to specific agent services and configurations.

Phone numbers are the entry point for inbound calls. Each number is provisioned through the platform and routed to a specific service, which determines which context graph and agent configuration handle the call.

Provisioning

Phone numbers are purchased and managed through the platform. You can:

  • Search for available numbers by area code or region

  • Purchase numbers and assign them to services

  • Route multiple numbers to the same service (for example, different clinic locations sharing one scheduling agent)

  • Release numbers you no longer need

Routing

When a call arrives on a provisioned number, the platform routes it to the service associated with that number. The service determines:

  • Which context graph governs the conversation flow

  • Which voice settings (tone, speed, keyterms) apply

  • Which world model workspace provides patient context

  • Which escalation rules and safety monitors are active

A single service can have multiple phone numbers pointing to it, but each phone number routes to exactly one service.

circle-info

Developer Guide - For API endpoints, SDK examples, and integration details, see the Phone Numbersarrow-up-right in the developer guide.

Last updated

Was this helpful?