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, limits and do-not-call​

Outbound calls follow your Guardrails:

  • Legal calling hours. Calls are only placed inside the legal calling hours for the callee's country, in the callee's local time. This built-in guardrail is always on. See Legal calling hours.
  • Your calling hours. To restrict calling hours further, add a Working and calling hours guardrail that applies to Outbound calls. See Working and calling hours.
  • Call limits. How many outbound calls a project dials per minute and how many run at once. See Call limits.
  • Do-not-call. Numbers on the project's do-not-call list are never dialled. See Do-not-call.

All of these are on the project's Guardrails page, in the project sidebar under Govern.

A call that a guardrail blocks is not dialled. In a workflow, the Outbound Call step reports it as blocked with the reason and, for calling hours, the next time calling opens, so the workflow can skip the number and try again later.

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?