Skip to content
All models
BetaREST

Telephony

Managed phone numbers for your voice agents.

Buy US local numbers and route them to an Omni agent from the console or API - no separate carrier contract. Connected minutes bill at $0.01/min on a 1-minute pulse; carrier-side recording is off because PyAI captures and transcribes the media itself. Inbound call bridging is rolling out.

Price
$0.01/min
Endpoint
POST /v1/telephony/numbers
Scope
telephony:manage
Model id
-

What you get

A number, routed in seconds

Search available US numbers by area code, provision one, and bind it to an agent - all from the console or one API call.

One bill, by the minute

Connected minutes bill at $0.01/min on a 1-minute pulse - no per-number carrier negotiation, no separate telco invoice.

Recording handled for you

Carrier recording stays off; PyAI records and transcribes in its own media bridge, so Trace scorecards and transcripts are the system of record.

US local numbers Search by area code Route to an agent Recording in PyAI's bridge Release anytime

Numbers provision in seconds. Inbound call bridging into the agent's realtime session is rolling out.

Start in minutes

cURL
# 1) Find a San Francisco number, 2) provision + route it to an agent
curl 'https://api.pyai.com/v1/telephony/available?area_code=415' \
  -H "Authorization: Bearer $PYAI_KEY"

curl https://api.pyai.com/v1/telephony/numbers \
  -H "Authorization: Bearer $PYAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+14155550123","agent_id":"front_desk"}'

FAQ

Which countries are supported?

US local numbers today. Tell us the coverage you need and we'll prioritize it.

Are calls recorded?

Recording is handled in PyAI's media bridge (off at the carrier), so recordings, transcripts, and Trace scorecards all come from one place.

How is it billed?

Connected minutes bill at $0.01/min on a 1-minute pulse, on top of the call's Omni/agent minutes.

Build with Telephony today.

Start free with $50.00 in credit - no card. Your test key works instantly.

No credit card - OpenAI-compatible - cancel anytime