Skip to main content

Phone numbers

Give an agent a phone number so people can call it, and so it can call them. You buy the number through VoisX on Twilio, Plivo or TryVox, and we host it for you. There is nothing to set up at the carrier: the number is configured automatically when you buy it.

The agent uses the same system prompt, voice, tools and knowledge on a phone call as it does in the Playground.

Already have numbers with a carrier or a PBX?

Keep them where they are and bring your own carrier over SIP instead of buying new numbers.

Before you start​

  • Your plan must include telephony. If it doesn't, the console asks you to upgrade.
  • Your organization needs credit. Number rental and call minutes are paid from it.
  • You need Contributor access or higher on the project.

Buy a number​

Numbers belong to a phone channel. The channel decides which agent answers the number.

  1. Open your project and go to Channels & numbers.
  2. Click New channel and choose Twilio, Plivo or TryVox.
  3. On the channel page, give the channel a name and choose the agent that answers its calls.
  4. Under Buy a number, pick a country and, optionally, an area code, then click Search numbers.
  5. Click Provision next to the number you want.

The number is bought right away and starts routing calls to the agent. You can also buy a number from the agent itself: open the agent, go to the Phone tab, connect a carrier, then search and provision.

Number search offers the United States, India, the United Arab Emirates, the United Kingdom, Canada and Australia. What is actually available depends on the carrier and on each country's rules. TryVox focuses on India: choose it when you want Indian local, mobile or toll-free numbers. Some countries need extra regulatory approval before numbers can be sold, and the search tells you when that is the case.

note

A phone channel can hold several numbers. They all go to the channel's agent. On the agent's Phone tab you connect one channel per carrier.

Number limits​

Each project and each organization can hold a set number of phone numbers. Numbers on your own SIP trunk count too. The Buy a number panel shows how many you have left. If you reach a limit, release a number you no longer need, or contact us to raise it.

Change which agent answers​

To send a number's calls to a different agent, change the agent on its channel. Every number on that channel follows. You can also attach a post-call workflow to a phone channel. It runs after each call ends, for example to update your CRM.

Release a number​

On the channel page or in Channels & numbers > Phone numbers, click Release next to the number. The number goes back to the carrier and stops reaching your agent. You may not get the same number again.

Deleting a phone channel stops its traffic, but its numbers stay in your project until you release them.

Inbound calls​

When someone dials your number, the call goes to the agent on the number's channel.

A call does not reach the agent when:

  • the number has no agent. The caller hears that the number is not in service.
  • your plan no longer includes telephony, or your organization has run out of credit. The caller hears that the service is unavailable.
  • your organization is already on as many simultaneous calls as its plan allows. The caller hears a short message and the call ends.

Outbound calls​

An agent can call people from its own number. The number it calls from is its caller ID. You can place outbound calls:

  • from the Playground: open the call panel, enter a number in E.164 format (for example +14155550123) and click Call now;
  • from the channel page, with Place a test call;
  • from a workflow, with the Outbound Call step.

On an outbound call the agent speaks first.

Calling hours​

Outbound calls are only placed inside the legal calling hours for the callee's country, in the callee's local time:

Callee's countryCalls allowed
India09:00 to 21:00
United Arab Emirates09:00 to 18:00
United States08:00 to 21:00
Canada08:00 to 21:00
Every other country08:00 to 21:00

These hours always apply. You can restrict them further for a project, but never widen them:

  1. Open the project's Settings > Calling hours.
  2. Turn on Restrict outbound calling hours.
  3. Choose a time zone, the days, and a start and end time. An end time earlier than the start time makes an overnight window, which belongs to the day it starts on.
  4. Optionally turn on Use the callee's local time when it is known.
  5. Click Save changes.

A call outside the allowed hours is refused. In a workflow, the Outbound Call step reports it as blocked together with the next time the window opens, so the workflow can skip the number and try again later.

Each project also has limits on how many outbound calls it can place per minute and how many can be in progress at once.

warning

You are responsible for having the right to call the people you dial and for following telemarketing and consent rules where they live.

Call settings​

These settings are on the agent, in the Call Settings tab. They apply to phone calls on any carrier, including your own SIP trunk.

SettingWhat it does
Live transferA phone number in E.164 format. When the agent decides a person is needed, it transfers the call there. Phone calls only.
End-call phrasesThe call ends as soon as the caller says one of these phrases. The match is instant and ignores case.
Hang up after silenceEnds the call when nobody has spoken for this many seconds (30 to 600). The agent says goodbye first. Leave it blank to use the default.
Max call durationThe longest a call can run, in seconds.
Silence timeoutHow long the caller must pause before their turn ends, in milliseconds. Applies to OpenAI realtime voices.
Barge-in sensitivityFrom 0 to 1. Higher lets callers interrupt the agent more easily. Applies to OpenAI realtime voices.
Keypad input (DTMF)Lets callers press keys. The agent receives them as text such as [Caller pressed: 1234]. Choose Collect until # or a pause, Each key immediately or Off, and optionally hide the digits in stored transcripts.
Recording noticeA sentence the agent says before anything else when the call is recorded. See below.

Your plan can also set a maximum call length. Shortly before it is reached, the agent says a short goodbye and the call ends.

Call recording​

Recording is set for the whole organization, not per number.

  1. Go to Organization settings > Data & privacy.
  2. Turn on Record calls.

When recording is on, the audio of phone and browser voice calls is stored. Project members can play and download recordings from Calls & transcripts > Recordings, and Admins and Owners can delete one early. Turning recording off stops new recordings and deletes all existing recordings in the organization. This can't be undone.

To tell callers they are being recorded, set a Recording notice on each agent, for example This call may be recorded for quality and training purposes. The agent speaks it only when recording is on.

warning

Agents using an ElevenLabs or Sarvam voice record calls but do not speak the recording notice yet. If you need a spoken notice, add it to the agent's greeting.

How long recordings are kept​

Recordings, transcripts, logs and metrics are deleted when their retention period ends. Your organization sets defaults in Organization settings > Data & privacy, and each project can set its own in Settings > Data retention, up to your plan's maximum. Days above your plan's included days are billed as storage.

Voice models on the phone​

Phone calls use the voice model chosen in the agent's voice settings. Agents using a Gemini voice model can't answer Plivo numbers yet; use a Twilio number or another voice model. ElevenLabs and Sarvam voices work on Twilio, Plivo and TryVox numbers and on SIP trunks.

Pricing​

A bought number has a monthly rental, and calls are billed per minute on top of the agent's voice model rate. Inbound and outbound minutes have different rates. Everything is paid from your organization's credit. See pricing for current rates.

Was this page helpful?