voice or video agent first; see the voice agent quickstart.
1
Open Phone Numbers
Telephony → Phone Numbers → Import number. One dialog walks through the rest.
2
Connect the carrier account
Pick Plivo, Exotel, Vobiz or Twilio, name the account, and enter its credentials: Plivo, Vobiz and Twilio take an Auth ID or Account SID and an auth token; Exotel takes Account SID, API Key, API Token, region and subdomain. Click Connect.Talqing verifies the credentials, then builds the SIP trunk on the carrier (“Setting up call routing”). Credentials are stored as encrypted secrets. Over the API this is
POST /v1/telephony/accounts followed by POST /v1/telephony/accounts/{account_id}/provision; the account must reach ready before numbers work.3
Import the number
The dialog lists the numbers the account owns, read live from the carrier. Tick yours and click Import. Each number reports its own result; common failures are
not found on this {carrier} account and already registered on this platform.A +91 number is hosted in the in region and every other number in us.4
Assign the agent
Choose the agent under Answer calls with and click Assign, or later use the Answered by dropdown on the number’s row. Only published voice and video agents are offered. Assignment is refused for a draft (
publish the agent before assigning a number) and for an agent with a required variable that has no default, since an inbound call has nothing to supply it. See variables.5
Exotel only: finish setup in the Exotel console
Exotel hands incoming calls only to a Flow, so it needs one manual step per account. The carrier’s card shows the four steps: create a custom app in App Bazaar, add the Connect applet on Call Start, paste the
sip: address shown into Dial Whom → Dial phone number(s), and attach the Flow to your ExoPhones. Then click I’ve done this.Until you confirm, the number dials out but never rings inbound, shows Setup needed, and cannot be assigned. Plivo, Vobiz and Twilio need nothing in their consoles.6
Check the badge reads Live
Live is the only state in which inbound calls are answered. Otherwise see the table below. Then call the number from your phone.
7
Place an outbound test call
Click the phone icon on the number’s row, enter To in E.164 (
+14155550123), pick the agent and click Call.The dialog links to the call record: transcript, tool calls, latency, cost and recording. Every call also appears under Monitor → Calls.When the number is not live
If the carrier account itself is not
ready, number operations fail with this carrier account is not set up yet; finish its setup first; use Finish setup on the carrier card.
Next
Phone numbers
Import, provision, assign and per-number settings.
Outbound calls
Placing calls from the API with userdata and vars.
Telephony troubleshooting
No inbound audio, failed setup, expired credentials.