Create a client workspace
A client workspace connects one of your clients to the portal, so they get their own branded dashboard showing every call and chat their AI agents handle, and the value that work is worth. You set one up in a few minutes with the Add client wizard: paste the client’s provider API key, choose the agents and numbers that belong to them, set their region, and the dashboard is live. In the app, client workspaces are simply called clients.
Each client holds one provider connection, the agents and phone numbers their dashboard reports on, their country, currency and timezone, and their reporting and outbound settings. Each client’s data stays separate: a client user only sees the clients you assign to them.
- You
Create a key in the provider
In the client’s Retell AI, Vapi or ElevenLabs account.
- You
Paste the key and validate
On the first step of the Add client wizard.
- Voice AI Portal
Loads agents and numbers
It reads them straight from the provider account.
- You
Choose assets and settings
Pick what this client sees, then add the client.
- Voice AI Portal
Shows conversations live
Calls and chats load from the provider on every visit.
Before you begin
Section titled “Before you begin”- Access to the client’s provider account (Retell AI, Vapi or ElevenLabs) with at least one agent already built there. You build and edit agents in the provider; the portal reports on them.
- An API key from that account. See Connect Retell AI, Connect Vapi or Connect ElevenLabs for where to create it and which permissions it needs.
- The client’s country and timezone.
- Room on your plan. If you have used every client your plan includes, the Add client page shows Client limit reached with an Upgrade your plan link instead of the wizard.
Open the wizard
Section titled “Open the wizard”Go to Clients and select Add client. You can also start from Add a client under quick actions on your agency overview, or from Add client in the setup checklist.
The wizard has six steps, listed down the left side: Connection, Assets, Regional, Staff-time value, Outbound and Review. Each step has a Next button that checks the step before moving on. To go back, select Back or select an earlier step in the list.
Add the client
Section titled “Add the client”-
Name the client
On the Connection step, enter the Client name, usually the client’s business name, for example
Acme Dental. -
Choose the provider
Under Voice AI provider, select Retell AI, Vapi or ElevenLabs. Retell AI is selected to start with. If you switch provider, any key you typed is cleared.
-
Paste the API key and validate it
Paste the key from the client’s provider account into API key, then select Validate API Key and Load Assets. The button is available once the client name and the key are both filled in.
The portal uses the key to read the agents and phone numbers in that account. When it works, you see Connected and how many agents and phone numbers were found. If the provider rejects the key, an error appears under the button; see Troubleshooting. Select Next: Select assets.
-
Choose the agents and numbers
On the Assets step, select the cards for the agents and numbers that belong to this client. Their dashboard reports only on what you select.
- Voice agents: select at least one. Each card shows the agent’s name, its ID and the numbers it answers, for example Answers +44 20 7946 0000.
- Phone numbers: optional. Select the numbers this client’s agents answer or call from. Each card shows which agent answers it (Answered by), or that no agent answers it in the provider.
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.
As you select, a Setup check explains any choice that would hide calls from this client, for example a selected number answered by an agent you haven’t selected. Each item has a one-click fix such as Also select followed by the agent’s name, or Add this number. The check never blocks you; you can still continue. Select Next: Regional settings.
-
Set the region
On the Regional step, choose the client’s Country. It starts as United Kingdom. For listed countries, the Currency is set for you and you choose the Timezone (some countries have several). For any other country, choose Other (enter manually), type the country, enter a three-letter currency code such as
SGDand search for the timezone.Use the client’s timezone, not yours. Dashboards, peak-time charts and outbound calling windows all use it. Select Next: Staff-time value.
-
Decide on staff-time value
Clients always see the staff time their AI agents handled. Turn on Show estimated staff-time value to also show what that time is worth. It is off to start with. See Staff-time value settings below. Select Next: Outbound calling.
-
Turn on outbound calling, if needed
On the Outbound step, turn on Enable outbound calling if this client will run outbound campaigns. You can also turn it on later in Client settings. The step shows how many of the agents and numbers you selected are available for outbound.
You don’t need anything else here. Campaigns come from your campaign playbooks: once the client is added, you assign a playbook to them and choose which of their agents and numbers it uses. A bundle (one agent, numbers and a call template saved together) is optional and only kept for older campaigns. Your plan needs to include outbound calling for the switch to save. Select Next: Review.
-
Review and add the client
The Review step summarises Connection, Assets, Regional, Staff-time value and Outbound, with your agents and numbers listed by name. To change something, select Edit next to that section. If your agent and number choices would hide calls from this client, a Setup check repeats the warnings here with their one-click fixes.
For an ElevenLabs client, agency owners also see WhatsApp & web chat here, with a switch for Manage WhatsApp and website chat for this client. It is off to start with and can be changed later. See Set up web chat.
Select Create client. You see that the client is ready and its dashboard is live, for example Acme Dental is ready, with a button to open its dashboard and three next steps: Give Acme Dental access (the client user form opens with this client already chosen), Review client settings and Add another client.
Staff-time value settings
Section titled “Staff-time value settings”When you turn on Show estimated staff-time value, a Staff cost section opens. The fields are filled in with defaults for the client’s country, and you can change them:
| Field | What to enter |
|---|---|
| Receptionist hourly pay | Typical local pay for the role, for example about £13 in the UK or about $18 in the US |
| Employer taxes & benefits | A percentage, filled in with a regional default |
| Office space & equipment | A percentage, filled in with a regional default |
| Admin & recruitment | A percentage, starting at 0 |
Below the fields, a preview shows what one staff hour costs and an example value for 100 answered calls of 3 minutes, so you can check the rates make sense. See How staff time handled works.
After you add a client
Section titled “After you add a client”-
Give your client a login
Add a client user and give them access to this client. See Invite a client user.
-
Check what they will see
Open the client and select View as client in the Agency only box, or select the View as client icon on the client’s row in Clients.
-
Set up campaigns, if outbound calling is on
Go to Campaign playbooks, open a playbook’s client list and select Assign next to this client, then choose the agent and numbers it uses. Then decide what the client’s own users may do with campaigns in What this client can do, in Client settings. See Campaign playbooks and Client campaign permissions.
-
Make changes whenever you need to
Agents, numbers and every other setting live in the client’s Client settings: on Clients, select the settings icon on the client’s row. See Client settings reference and Manage workspace assets.
Can I change a client’s provider later?
Section titled “Can I change a client’s provider later?”No. The provider is fixed once the client is added, but you can replace the API key at any time. If a client moves to another provider, add them as a new client. See Update a provider API key.
Does the portal copy my client’s call data?
Section titled “Does the portal copy my client’s call data?”Not the content. Calls and chats load from the provider each time the dashboard opens. The portal saves the client’s settings, which agents and numbers they see, and statistics for each call (IDs, times, durations, categories and cost) for client billing, usage, results reports, client health checks and margin. It never stores recordings, transcripts or caller numbers.
Can two clients share an agent?
Section titled “Can two clients share an agent?”Yes. Select the agent for both clients. Its card shows Also tracked by with the other client’s name, and its calls appear in both dashboards.
Is outbound calling needed to report on calls?
Section titled “Is outbound calling needed to report on calls?”No. Inbound calls, chats and analytics work without it. Turn on Enable outbound calling only for clients who run outbound campaigns.
Troubleshooting
Section titled “Troubleshooting”| Problem | What to do |
|---|---|
| Validate API Key and Load Assets is greyed out | Enter the Client name and paste the key. The button needs both. |
| The key is rejected | Copy the full key again with no spaces, and check it comes from the provider you selected. For Vapi, use a private key. For Retell AI and ElevenLabs, check the key’s permissions. See the provider guides linked above. |
| The error mentions an API key ID | You pasted an ElevenLabs key’s ID instead of the key. Paste the secret key itself, which starts with sk_. |
| “This API key can’t read your agents and phone numbers.” | Give the key read access to agents and phone numbers in the provider’s dashboard, or create a key without restrictions, then validate again. |
| The provider “took too long to answer” | Try again in a moment. |
| No agents found in your provider account | The key works but the account has no agents yet. Build at least one agent in the provider, then validate again. |
| No phone numbers found in your provider account | The account has no numbers, or they are in another account. Phone numbers are optional, so you can carry on and add them later. |
| You see another client’s agents | The key belongs to a different provider account. Create the key while signed in to the right account. |
| A Setup check warns that calls won’t show | A selected agent and number don’t match: for example the number is answered by an agent you haven’t selected. Select the fix button on the warning, or change your selection. You can still continue. |
| Client limit reached | Your plan’s client limit is used up. Disable a client you no longer need, or upgrade from Platform subscription. |
| “Outbound calling not available on your plan” | Your plan doesn’t include outbound calling. Turn Enable outbound calling off to add the client, and email hello@voiceaiportal.com so we can turn it on for your plan. |
| The Review step says the client can’t be added for a billing reason | The message gives the reason, such as a paused subscription or a payment to update, with Open billing to sort it out. Once it is sorted, select Create client again. |