Overview
A Number is the phone number callers dial; it routes to whatever Speech Pipe it is attached to. Phone numbers in Unpod come from two sources:- Unpod Numbers (default) - provision directly from the Unpod platform. No carrier account, no trunk, no SIP.
- BYON (Bring Your Own Number) - route numbers you already own from any provider over a trunk you register once.
AgentRunner.
Support for Twilio, Telnyx, and Plivo numbers is coming soon - you will be able to import numbers from these providers directly into Unpod.
Number Sources
Getting Numbers from Unpod
Numbers provisioned through Unpod are immediately available in your account. You can browse and acquire them from the dashboard under Dev Platform -> Numbers. Once provisioned, list them via the SDK:Trunks
A Trunk is your carrier connection - the SIP capacity numbers ride on. Bring your own carrier (Twilio, Tata, …), register it once with its SIP credentials, then work with numbers, not SIP. BYON numbers arrive this way.1
Add the trunk
Dev Platform -> Telephony -> Add Trunk -> BYO SIP. Provide the carrier’s
SIP domain (e.g.
sip.your-carrier.com) and auth username / password.2
Point the carrier at Unpod
Set inbound routing to the Unpod SIP endpoint shown in the dashboard.
3
Sync
Click Sync on the trunk, or run
await client.numbers.sync(). The trunk’s
numbers appear in your account, ready to attach to a Speech Pipe.Register a trunk via the SDK
Field names match the dashboard.List and delete trunks
Sync numbers off a trunk
Listing Numbers
Number fields
Attaching a Number to a Speech Pipe
A number can be attached to exactly one Speech Pipe at a time. Inbound calls to that number are routed to the Speech Pipe’s configured runners.Detaching a Number
Common Patterns
Find the first free number and attach it
Rotate numbers across Speech Pipes
Next Steps
Voice Profiles
Choose the voice profile for your Speech Pipe.
Speech Pipe
Create and configure your Speech Pipe via the SDK.