Guide
Connect a phone number
A number that rings and reaches your assistant. Through Twilio, or through your own SIP trunk.
15 minutes 5 steps
A phone number in the console, routed to a published assistant.
- A published assistant (the previous guide).
- A Twilio account with an Account SID and Auth Token, if you want to buy or import a number.
- Or your SIP trunk details: host, port, transport and credentials.
Add the telephony credential under Connections
There is no separate “telephony account” screen. Go to Platform → Connections, find the Twilio card in the telephony category and press Connect. One warning: the credential field labels are still in English even with the interface in another language.
Platform → Connections → Twilio → Connect → Account SID, Auth token
Buy or import a number
The number list has two buttons. Buy searches the carrier by country, type and area code, and the list of available numbers comes back from them live — if it is empty, the carrier genuinely has nothing matching. Import brings across the numbers you already own there.
Telephony → Numbers → Buy / Import from Twilio
Or bring your own SIP trunk
The trunk wizard has nine steps and covers the things that genuinely differ between carriers: gateways with priority and weight, authentication mode, an inbound ACL, outbound number formatting, codecs, SRTP and DID mapping. On the inbound step the source ACL is required by default — leave it empty and no call gets in.
Telephony → SIP trunks → Create (nine steps: Type · Gateway · Authentication · Inbound · Outbound · Codec · Security · DID mapping · Test)
Route the number to the assistant
Open the number and, in the shortcuts section, pick the assistant or the squad directly. Set the busy-and-out-of-hours destination while you are there; it is the first thing everybody forgets.
Telephony → Numbers → your number → Shortcuts → Assistant
Ring it
There is no substitute for this. Call it from your own phone and listen. Then open the call in the console and read the timeline: if something went wrong, it is written there to the millisecond.
Engage → Calls → your call → Timeline
How to tell it worked
- The number appears in the list with the assistant as its destination.
- A test call reaches call.connected in the timeline rather than stopping at call.ringing.
- On the trunk, the OPTIONS ping action comes back with a response rather than a timeout.
What does not work yet
Every guide has this section. If it were missing, it would mean we had not looked hard enough.
- Of the nine carrier ids in the enum, only Twilio has buying and importing that actually work. The Telnyx and DIDWW buttons are disabled and say why on hover.
- SIP trunking has not been tested against a real carrier trunk in this build. Signalling was verified against a local FreeSWITCH, with 11 of 14 SIPp scenarios passing.
- The credential field labels under Connections are English whatever the interface language. That is a known miss, not a choice.