Before you start
Have the following ready:- The Agent that should use the number.
- A test phone number that you control.
- The consent and opening disclosure required for the destinations you plan to call.
Number availability by country
- United States and Chile: you can select a number from current inventory and provision it directly under Integrations → Phone number → Add number, subject to availability and your plan’s number allowance.
- Other country: choose Other country, then select the country in the form. If Twilio offers voice-capable numbers there, Nexor shows whether it can add one directly or first needs company details and documents for a regulatory request. In the latter case, complete the form and wait for review. Submitting a request does not guarantee approval or final number availability.
- Unavailable country: if it is disabled in the country selector, you cannot request a number there through the form at that time. Compatible inventory or a provisionable option from Twilio may be missing. Contact Nexor Support to ask about alternatives, without assuming the number can be obtained.
Provision and assign a number
1
Open the Phone number integration
Go to Integrations → Phone number. Open the integration and select Add number. If your workspace already has numbers, open Manage first.
2
Choose an available number
Choose United States or Chile to see available numbers. For another country, choose Other country and select it in the form. If it is available with regulatory requirements, provide the requested details and documents; if it can be added directly, follow the on-screen steps. Disabled countries cannot proceed.
3
Review any charge
If the number exceeds the allowance included with your plan, Nexor shows the current recurring price before asking you to confirm. A regulatory request may remain pending before the number is provisioned. Do not rely on a price copied from an older document.
4
Assign the number to the Agent
Once the number is ready, select the agent and open Channels in the right pane. Use Add a channel to connect the phone number, or Assign if it’s already connected in your account.
5
Confirm the channel
Make sure the Calls row shows the assigned number. Every task of the Agent now calls from it. Connecting the number also turns on the Agent’s inbound router, so the Agent answers incoming calls on it. To configure how a task handles calls, open the task and go to Channels.
A messaging-capable number can also be used for SMS, but Voice and SMS are separate channels. Assigning or disabling one channel in Agent settings, or choosing Stop using for SMS, does not change the other channel’s assignment.
Change or remove the Agent’s number
The Agent’s number is managed from the Agent, not from each task. Select the agent, open Channels in the right pane, and use Change on the Calls row. The menu shows:- The account’s numbers. Pick one to make it the Agent’s number. When a number is already used by another Agent, it shows Used by and that Agent’s name.
- Connect new, to add a number.
- Use in every task, when some tasks of the Agent don’t use calls.
- Remove from agent, to release the Agent’s number.
A released number is still yours. No Agent calls from it or answers on it until you assign it again, and Integrations → Phone number shows it as Not in use: not assigned to any agent. Releasing a number never turns it into the account’s shared number.
When you assign a number from the Agent’s Channels, Nexor also releases numbers that were assigned to a single task of that Agent, so every task calls from the Agent’s number. Numbers that answer incoming calls and numbers managed by the Nexor team are not changed.
Numbers managed by the Nexor team
Some numbers are managed by the Nexor team. You can’t remove them from an Agent, or move them from another Agent, in the panel. When you try, a tooltip on the button says Nexor manages this number. Ask your KAM if you need to change it. Contact your account manager or Nexor Support to change it.Turn calls off for one task
Every task of the Agent can use the Agent’s number. To keep one task from calling, open the task, go to Channels, select Calls, and choose Stop using in this task. The row shows Not used here, and that task makes no calls. To turn calls back on, choose Use in this task. The number stays with the Agent either way.Answer incoming calls
The Agent’s number answers incoming calls while the Agent’s inbound router is on (in the app, Let your agent choose the task). There is no separate switch for calls.
The Agent’s default task answers the call when it has calls turned on. If it has calls turned off, the next task that has calls turned on answers instead. If no task of the Agent has calls turned on, the number does not answer, and Nexor shows No task of this agent has calls turned on. See Turn calls off for one task.
To choose who answers, open the Agent’s call settings: the Agent itself, the Agent with a transfer to a person, or a forward to another phone number. Forwarding to another number is the only way to keep the router on while the Agent does not answer.
Which number an Agent calls from
Each task that makes calls uses one number, chosen in this order:- A number assigned to that task.
- A number assigned to another task of the same Agent.
- The Agent’s number.
- The account’s shared number.
The integration summary, for example 1 of 1 number in use, counts the numbers at least one task calls from or that answer incoming calls. Incoming calls are separate from the number a task calls from: when a number answers incoming calls, the list also shows Incoming calls with the Agent that answers them.
Choose the language, voice, and gender
The agent’s language is set in Edit identity, the pencil next to the agent’s name, and applies to every task. Choose the language before choosing a voice. Changing it can change which voices appear in the voice list. To choose how the agent sounds on calls, open the task, go to Channels, and select the phone number. Each task keeps its own call settings. Under Voice, use the play button to preview the selected voice or a voice in the list when a sample is available. Then choose Female, Male, or Neutral under Gender. Female or Male filters the list when matching voices exist; Neutral keeps the language-compatible pool. If Clone a voice is available for your workspace, select it and upload voice recordings. Cloning is optional; the standard voice list remains available.Configure call behavior
Open the task, go to Channels, and select the phone number. The current controls include:- Agent speaks first?: When enabled, the opening message is used as soon as the call can begin. When disabled, the lead opens the call and the opening message is not used as the first utterance.
- If the lead says nothing, speak after (ms): Set how long the Agent waits before speaking when the lead is expected to open.
- Opening message: Write the first spoken message and insert Agent or lead variables with
@. - Voice speed: Adjust the pace. The dashboard marks the recommended range.
- Interruption sensitivity: Control how easily the Agent yields when it hears the other person. Test this with realistic background noise.
- Background ambience: Choose an available ambience or none.
- When a machine answers: Choose whether the Agent checks before hanging up, hangs up on the first sign of a machine, or does nothing special.
- Style: Add channel-specific speaking instructions.
For some calls to
+1 destinations, Nexor may wait for the recipient or a call-screening service before using the configured opener. This avoids speaking over the screening prompt.When the call reaches voicemail
When a machine answers decides what the Agent does when it hears a machine, a call-screening service, or a voicemail greeting:
With Leave a message, write the text in Message left in the voicemail (up to 500 characters). It accepts the same call variables as the opening message, such as the lead’s first name, the agent’s name, or the company name; a variable with no value is dropped, not read aloud. If the message is empty, the Agent uses a default message in its language. Through the API, use
voicemailPolicy and voicemailMessage in Configure an Agent Voice.
Place a real test call
1
Open the Playground
Select the agent, click Test this agent, choose the task, and select Call.
2
Confirm the destination
Enter or confirm a phone number you control. Review it carefully because Nexor will dial that number.
3
Answer and test the flow
Check the opener, voice, interruption behavior, required disclosures, and the Agent’s response to silence. Repeat with one configuration change at a time.
4
Review the result
The Playground follows the call and can report a completed call or a not-connected result such as no answer, busy, or voicemail reached.
Troubleshoot setup and tests
Phone is missing from Add channel
Phone is missing from Add channel
Provision a number under Integrations → Phone number, then reopen the Agent settings. If the integration or provisioning action is unavailable, ask an account administrator or contact Nexor Support.
I can't call a destination
I can't call a destination
To check whether you can obtain a local number, see Number availability by country. This section covers outbound calls from a Nexor number: destination support is evaluated when the call is placed and is separate from the availability of numbers to buy. Check the phone format, test with a number you control, and contact Nexor Support if the call fails. This guide does not promise a fixed list of enabled destinations.
The call reports no answer, busy, or voicemail
The call reports no answer, busy, or voicemail
These are real call outcomes, not simulated failures. Try again only with a destination you control. A voicemail outcome means the call reached a mailbox. The Agent leaves a message only when the task is set to Leave a message.
The opening timing is different on a +1 call
The opening timing is different on a +1 call
Nexor may wait for a person or call-screening service before speaking on some
+1 calls. Test the exact destinations your campaign will use.Check compliance before launch
Voice setup does not replace consent, calling-hour, AI disclosure, or recording requirements. Review these pages before using a US campaign:US outreach rules
Check consent, calling hours, opt-out, and state requirements.
AI disclosure and recording
Write a compliant opening line and understand recording consent.