A voice AI agent on NetSapiens is not a separate phone system. It is a new item in your Manager Portal, its own user and extension on the customer's domain, and a number from the domain's own inventory. Calls reach it through the answering rules you already use, and it hands callers to real users, queues and auto attendants. Nothing in the PBX is replaced.
This guide walks through how that works, step by step, for the provider who has to install it, sell it and support it. (Searchers call this an AI receptionist. We call it a voice AI agent, because it does more than answer.)
Last reviewed: November 5, 2026.
How does a voice AI agent plug into a NetSapiens portal?
You add one script line to your portal configuration. Every customer domain then gets a new nav item, named whatever you choose.
- Same login. Your customers open it with their existing portal login. There is no new password and no second app.
- Same roles. An Office Manager gets full control: setting up the agent, its knowledge and its tools. A Basic User gets the inbox, the calls and the reports.
- Your brand. The plugin carries your name for the agent, your logo and your accent color.
- Always current. The portal loads the latest release every time, so there is nothing to upgrade on your side.
What does a customer see before they turn it on?
Their own missed calls. A customer who hasn't activated yet sees how many calls they missed in the last 30 days and their busiest missed-call times, taken from their own call records, next to a trial offer at the price you set.
That screen does the first part of the selling for you. If you would rather set customers up yourself, you can provision them through the partner API instead and skip the pitch.
What does the 3-click deploy change in the PBX?
Three things, each on the customer's own domain:
- It creates the agent's own user. The agent gets a NetSapiens user like any other subscriber, with its own extension. Extensions start at 40000, so they never collide with your staff.
- It sets one answering rule on that user. Calls to the agent's extension always go to the agent.
- It assigns a number from the domain's DID inventory. No porting and no new carrier. The number is one the customer already has.
Each step turns green when it is done. A business can have more than one agent, for example one for the main line and one for after hours, and each gets its own extension and inbox.
Do I have to change my answering rules, hours or auto attendant?
No. Hours, auto attendants and voicemail stay in the PBX, where your team already manages them. You point the calls you choose at the agent's extension:
- After hours. Route the after-hours time frame to the agent instead of voicemail.
- Overflow. Send calls a queue can't answer to the agent.
- An auto attendant option. "Press 3 for scheduling" can ring the agent.
- The main line. Or let the agent answer everything first.
The agent knows the business hours you give it, so it can tell a caller whether the office is open right now.
How does the agent hand callers to real people?
It reads the domain's real directory, so transfers go to the same users, call queues and auto attendants your customer already has.
- Ring a person or send to voicemail. "Ring user" follows that person's own answering rules. "Send to voicemail" drops the caller into their NetSapiens voicemail box.
- Dial by name. A caller can ask for "Sarah in accounting" and the agent finds her. It searches the users listed in the audio directory.
- Plain-language rules. You describe when to transfer ("billing questions go to the billing queue"), and the agent can say a short line before it does.
- Messages. When nobody should be interrupted, the agent takes the caller's name, number, reason and when to call back. The alert can reach your customer while the caller is still on the line.
How does warm transfer work on NetSapiens?
We switch warm transfer on for your cluster with one setting on our side. Then it works like this:
- The agent puts the caller on hold with music.
- It calls the staff member as its own NetSapiens line, so the call uses the customer's dial plan and caller ID, and it shows in their call history like any other call.
- It briefs the staff member on who is calling and why, and answers their questions.
- It connects the caller and leaves the call.
If the staff member declines, doesn't answer within 30 seconds, doesn't speak within 15 seconds, or the call reaches their voicemail, the caller comes back to the agent. Nobody is left on hold with nothing.
What else can the agent do on NetSapiens?
- Place calls from its own line. Your customers' AI assistants and automation tools can ask the agent to call someone. The call goes out from the agent's own NetSapiens line, with the business's caller ID, one call at a time. It uses the same setting on our side as warm transfer.
- Check who is calling before it shares anything. The agent can verify a caller before it reads back account or order details: with a code texted to the calling number, or by matching an order number or email to the business's online store.
- Answer your customers' questions about itself. An in-portal helper, named after your agent, answers questions about calls, the inbox and settings. It can also review the agent's instructions against its real calls and suggest changes, which stay drafts until someone publishes them.
What stops a bad change from reaching callers?
Changes are drafts until someone publishes them.
- Draft and Publish. Edits go live only when published. Calls already in progress keep the version they started with.
- One-click revert. The last 10 published versions are kept, and any of them can be restored.
- A test panel. Type to the agent, preview its texts, and watch each action it takes, before a real caller hears it.
For a full review routine, see how to QA a voice AI agent.
What does my support team see when something goes wrong?
Every call lands in an inbox with the recording, the transcript, a summary and each action the agent took.
- Attention required. A queue of calls that need a human: callback requests and calls that went wrong.
- Why each call ended. Caller hung up, transferred, transfer failed, no answer, silence, spam declined, and more.
- Insights. Calls the agent resolved on its own, calls it transferred, what callers wanted, the most common reasons calls didn't resolve, and a short list of calls worth a look.
- Spam Shield. Robocalls and automated sales pitches are politely declined and counted, so they don't fill the inbox.
Most "the AI got it wrong" tickets start here. The answer is usually a missing fact in the knowledge base or a transfer rule that needs a sentence more, and the customer can see that for themselves.
What does it cost, and what do I charge?
You set the price. You keep one rate card, and each customer's usage shows your price next to our wholesale cost, so your margin is visible per account. The cost card inside the plugin shows your customers your rate, never ours.
See what you can charge for how providers package it.
What do I set up as the provider?
- Add the script line to your portal configuration.
- Brand it: the agent's name, your logo, your color, and your activation text and prices.
- Set your rate card.
- Optionally, connect your own messaging account so agents can text links and send text alerts.
- Ask us to turn on warm transfer for your cluster.
- Let customers activate themselves, or provision them through the API.
Want to see it in your own portal? Book a demo.
FAQ
Does a voice AI agent replace my auto attendant or IVR?
No. Your auto attendant, hours and voicemail stay in the NetSapiens PBX. You point the calls you choose at the agent's extension, for example one auto attendant option, the after-hours time frame or queue overflow.
Does the customer need a new phone number?
No. The deploy step assigns a number from the domain's own DID inventory, and you can also route the numbers they already use to the agent's extension through answering rules.
Can one business have more than one agent?
Yes. Each agent gets its own extension, starting at 40000, and its own inbox, so a business can run one for the main line and another for after hours.
Which languages does the agent speak?
English and Spanish. The agent follows the caller between the two in the middle of a call.
What happens if the person the agent transfers to doesn't pick up?
With a warm transfer, the caller comes back to the agent if the staff member declines, doesn't answer within 30 seconds or the call reaches voicemail. With a regular transfer, the call follows that person's own answering rules.
Do my customers' staff need training?
Very little. Staff open the same portal they already use and work an inbox. Office Managers set the agent up from the business's Google profile or website, then adjust it in plain language.
