Skip to main content
Every phone number connected to your agent is listed in Agent Studio under Integrations > Telephony. Use this tab to add numbers, choose the environment and variant each one reaches, and delete numbers you no longer need.
The Numbers tab on the Voice page has been replaced by the Telephony tab. Handoffs moved with it: click Handoffs on the Telephony tab to open them.

The numbers table

The tab lists each connection with its numbers. A SIP trunk or contact center connection appears as a card that you can expand to see its numbers and connection details. Sandbox has no phone numbers. Test there with an in-app call or simulation tests. See Environments.

Add a number

Click Add number and choose how calls should reach your agent. See Telephony for every option. To add a number to a SIP trunk you already have, open the trunk card’s actions menu (⋯) and click Add number. See Add numbers and extensions.
Use separate numbers for each environment so test calls never reach Live.

Change the environment

Click the number’s Environment value and pick a new one. The change saves immediately, and the next call to the number reaches that environment.

Change the variant

  1. Open the number’s actions menu (⋯) and click Change variant.
  2. In the Change assigned variant panel, pick a variant under Assigned variant, or leave it on Default (no variant) to follow the agent’s default variant.
  3. Click Save change. Calls to the number route to that variant as soon as the change saves.
A variant is listed once a version that contains it is running in the number’s environment. If none are listed, publish to Live or move your Branch to Staging first.

Turn on SMS

If your project has SMS set up, a number bought through PolyAI can also send and receive texts. Open the number’s actions menu and click Turn on SMS. The number then shows SMS under Channels. Click Turn off SMS in the same menu to stop. Some numbers that predate the Telephony tab can’t have SMS changed here. The menu says so when that applies. See SMS and Number availability.

Delete a number

  1. Open the number’s actions menu and click Delete number.
  2. Confirm.
Calls to the number stop reaching your agent. A number bought through PolyAI is also released, so you can’t get it back. A number on your own SIP trunk, Twilio account or contact center stays with your provider.
Deleting a Live number takes effect immediately. You can’t undo it.

Automate with the Agents API

Use the Agents API to provision numbers in bulk or to change routing as part of a deployment. A connector binds phone numbers to voice infrastructure, and each number is an E.164 string routed through a connector.
See Connectors and Phone numbers for the full endpoint list. To manage SIP trunks and their extensions in code, use the SIP Trunking API.

Troubleshooting

Telephony

Every way to connect a number to your agent

Handoffs

Transfer callers to your team

Variants

Run one agent across several sites or brands

Outbound calling

Have your agent place calls
Last modified on November 17, 2026