Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vozagent.ai/llms.txt

Use this file to discover all available pages before exploring further.

A phone number on its own does not do anything — it needs to be connected to an AI assistant so VozAgent knows how to handle calls on that number. Each phone number supports separate assistant assignments for inbound and outbound use.

​
How Assignments Work

Every phone number in VozAgent has two independent assignment slots:
  • Inbound Assistant — The AI assistant that answers incoming calls to this number
  • Outbound Assistant — The AI assistant that uses this number as its caller ID when placing outbound calls in campaigns
You can assign the same assistant to both, assign different assistants, or leave one slot empty. For example, you might have your receptionist assistant handle inbound calls while a separate follow-up assistant uses the same number for outbound campaigns.

​
Assigning an Inbound Assistant

  1. Go to Phone Numbers in the sidebar.
  2. Click on the phone number you want to configure. This opens the Phone Number Settings panel.
  3. Scroll to the Inbound Settings section.
  4. Click the Assistant dropdown and select the assistant you want to answer incoming calls on this number. If you want to remove the current assignment, select None.
  5. Click Save Changes.
Once saved, any call to this number will be routed to the selected assistant. The assistant will answer using its configured greeting, voice, and conversation flow.

​
Setting a Fallback Destination

Below the assistant dropdown, you will see the Fallback Destination field. This is a phone number where calls will be forwarded if the assistant is unavailable for any reason. Enter a phone number using the country selector and number input. This is typically your personal cell phone or your office landline, so you never miss a call.

​
Assigning an Outbound Assistant

  1. In the same Phone Number Settings panel, scroll down to the Outbound Settings section.
  2. Click the Assistant dropdown and select the assistant that will handle outbound calls from this number.
  3. Optionally, set the Outbound Phone Number field if you want outbound calls to show a different caller ID.
  4. Click Save Changes.
The outbound assistant is the one that will run conversations when this number is used in a campaign.

​
Assigning a Number During Assistant Creation

When you create an outbound assistant using the assistant wizard, one of the setup steps asks you to choose a phone number. You have two options:
  • Get a new phone number (recommended) — VozAgent automatically provisions a new local number and assigns it to your assistant. You will see how many numbers you have remaining on your plan.
  • Use an existing outbound number — If you already have a number assigned to another outbound assistant, you can reassign it to the new one.
Important: If you reassign an existing number, it will be detached from its current assistant. That assistant will no longer be able to make outbound calls until you assign it a new number.

​
What Happens When a Number Is Assigned

​
For inbound calls

When someone dials your VozAgent number:
  1. VozAgent looks up which assistant is assigned to that number for inbound calls.
  2. The assigned assistant answers and runs its configured conversation flow — greeting, caller questions, booking, transfers, etc.
  3. If no assistant is assigned, the call has no handler. Make sure every active number has an inbound assistant assigned.

​
For outbound calls

When a campaign places a call:
  1. VozAgent uses the outbound phone number as the caller ID so the recipient sees a real number on their phone.
  2. The assigned outbound assistant runs the campaign conversation.
  3. If no outbound assistant is assigned, the number cannot be used for campaigns.

​
Tips for Multi-Number Setups

  • One number, two assistants — You can assign different assistants for inbound and outbound on the same number. The inbound assistant handles calls that come in, and the outbound assistant handles calls that go out.
  • Dedicated campaign numbers — If you run outbound campaigns, consider having a separate number so that return calls from campaign recipients are handled by the right assistant.
  • Label your numbers — When you have several numbers, give each one a descriptive label (e.g., “Main Office Line,” “Campaign - Spring Promo”) so you can quickly identify them. See Managing Phone Numbers for details.