Manage a client's agents and numbers
A client’s assets are the agents and phone numbers their dashboard reports on. You choose them in Client settings, under Agents & numbers, from the client’s own Retell AI, Vapi or ElevenLabs account. Keeping them up to date means your client always sees every conversation their AI handles, and nothing that belongs to someone else. A built-in Setup check tells you when a choice would hide calls, and fixes it in one click.
How the selection decides what your client sees
Section titled “How the selection decides what your client sees”- Agents come first. A call or chat shows only if its agent is selected.
- Numbers narrow it down. Once you select at least one phone number, a call also has to be on one of the selected numbers to show.
- Chats aren’t tied to a number. Web chats, WhatsApp conversations and SMS show whenever their agent is selected.
- No numbers selected means every call from the selected agents shows, whichever number it used.
Before you begin
Section titled “Before you begin”- Build agents and buy numbers in the provider first. Agents and phone numbers are created in the client’s Retell AI, Vapi or ElevenLabs account, not in Voice AI Portal.
- Every client needs at least one agent selected. Phone numbers are optional.
Update a client’s agents and numbers
Section titled “Update a client’s agents and numbers”-
Open the client’s settings
Go to Clients and select the settings icon (Client settings) on the client’s row. You can also open the client and select Client settings in the Agency only box.
Everything about the client is on this one page. The section menu lists the Configuration sections first: Connection, Agents & numbers, Region, Staff-time value and Outbound calling.
-
Go to Agents & numbers
Select Agents & numbers in the section menu, or scroll down to it. The page opens with the saved selection straight away, then checks the provider account for new agents and numbers in the background. While it checks, the note at the top of the section reads Checking your provider account for new agents and numbers.
-
Refresh if you have just changed the provider account
Select Refresh at the top of the section to check the provider again.
-
Change the selection
Select a card to add that agent or number; selected cards are highlighted and show a tick. Select a highlighted card to remove it. Removing it only takes it off this client’s dashboard; it stays in the provider account.
Each agent card lists the numbers it answers (Answers followed by the numbers), and each number card shows Answered by and the agent’s name, so you can see which belong together. With more than one item, Select all and Clear appear. With more than six, a search box appears (Search agents or Search numbers), and Select all then selects only the matches. If another of your clients already reports on an agent, its card says Also tracked by and that client’s name, and that agent’s calls appear in both clients’ dashboards.
-
Save your changes
The section shows an Edited badge, and a bar at the bottom of the page reads Unsaved changes with the sections you edited. Select Save changes, or Discard to go back to the saved version. You see Changes saved, and your client sees the new selection the next time their dashboard loads.
The page checks every section when you save. If something needs fixing, for example no agent is selected, that section shows Needs attention and the page scrolls to it.
Fix Setup check warnings
Section titled “Fix Setup check warnings”As you select, the portal compares your choices with which agent answers each number in the provider account. It never stops you saving; it explains what your client would miss and offers a fix.
| Where | What it shows |
|---|---|
| Setup check, at the top of Agents & numbers | Warnings: choices that hide calls from this client’s dashboard, with “You can still save.” |
| Under an agent or number card | The same warning next to the card it’s about, with its fix button. |
| Setup tips, above Phone numbers | Tips and notes “based on which agent answers each number” in the provider. |
| Message | What to do |
|---|---|
| A number “is answered by” an agent “who isn’t selected, so its calls won’t show.” | Select Also select followed by the agent’s name, or deselect the number. |
| A selected agent “answers” or “makes calls from” a number “which isn’t selected, so” its “calls on it won’t show.” | Select Add this number, or leave it if you don’t want those calls on this client’s dashboard. |
| A selected agent “answers” a number, and no numbers are selected yet | A tip only: all its calls already show. Select Add this number if you want it listed on the client’s Numbers page. |
| An agent “makes calls from” a selected number “but isn’t selected, so those calls won’t show.” | Select Also select followed by the agent’s name if this client’s outbound calls should show. |
| A WhatsApp number “is answered by” an agent “who isn’t selected, so its chats won’t show.” | Select Also select followed by the agent’s name. |
| “No agent answers” a number in the provider, “so it won’t have calls.” | Link an agent to that number in the provider if it should take calls. |
| An agent “isn’t in your” provider “agent list, so it can’t be selected here.” | The agent linked to that number isn’t in this account’s agent list. Check the number in the provider. |
Chat agents for Retell AI clients
Section titled “Chat agents for Retell AI clients”Retell AI runs web chats and SMS on separate chat agents, and they appear in the same list as voice agents. Select the chat agent that answers the client’s chats, or those chats do not load in the client’s dashboard. Its chats then appear in the client’s Conversations, labelled Web chat or SMS.
For Vapi and ElevenLabs clients, chats come from the same agents as calls, so there is nothing extra to select. See Set up web chat.
Common changes
Section titled “Common changes”| Change | What to do in Client settings |
|---|---|
| Your client added a new agent in the provider | Select Refresh in Agents & numbers, select the new agent, then Save changes. |
| An agent is no longer used | Deselect it in Agents & numbers. If an outbound bundle uses it, update or remove that bundle in Outbound calling on the same page. Then Save changes; both changes save together. If a campaign playbook assigned to this client calls with that agent, select Change setup for this client in Campaign playbooks and choose another agent. |
| Your client started taking chats in Retell AI | Select Refresh, select the new chat agent, then Save changes. |
| A phone number was replaced | Add the new number in the provider account. Then select Refresh, swap the numbers in Agents & numbers, check any bundles in Outbound calling, and Save changes. For outbound campaigns, also update the numbers in the client’s playbook setup under Campaign playbooks. |
Check what is tracked
Section titled “Check what is tracked”The Connection section shows the provider with a Connected badge, when it was last synced, and how many agents and phone numbers the provider account has. The Agents & numbers section shows how many of each are available and how many are selected for this client.
Messages you might see
Section titled “Messages you might see”| Message | What it means and what to do |
|---|---|
| Some saved selections were deleted in your provider | An agent or number you had selected no longer exists in the provider account, so it has been taken off the list. Choose replacements and save. |
| Showing cached assets | The portal could not reach the provider just now, so only the saved selections are listed. Select Refresh to try again. |
| You must select at least one agent. | Select at least one agent before you save. |
| API Key Invalid (Connection section) | The provider rejected the saved API key. Select Change API Key, or Continue with Cached Data to keep editing. See Update a provider API key. |
| Unable to Connect (Connection section) | The provider may be temporarily unavailable. Select Retry Sync, or Continue Editing with the saved list. |
| Connection Error (Connection section) | The portal could not check the provider. Check your internet connection, then select Retry Sync. |
| Invalid bundles detected (Outbound calling section) | An outbound bundle uses an agent or number that is no longer selected. Update or remove that bundle before saving. |
| One or more selected agents or numbers aren’t in this client’s provider account. | Select Refresh, check your selection, then save again. |
| A bundle you removed is still used by a campaign. | Keep the bundle, or end that campaign first. |
Why can’t my client see some of their calls?
Section titled “Why can’t my client see some of their calls?”Check three things in Agents & numbers: the call’s agent is selected, the number it came in on is selected (when you have selected any numbers), and the Setup check has no warnings. Then check the time range on the client’s dashboard.
Does removing an agent delete its calls?
Section titled “Does removing an agent delete its calls?”No. It only takes the agent’s calls off this client’s dashboard. The agent and its calls stay in the provider account, and they show again if you select the agent again.
Do I need a new API key to see new agents?
Section titled “Do I need a new API key to see new agents?”No. Select Refresh in Agents & numbers. A new key is only needed when the old one stops working or you rotate it.