These docs describe the current Dante AI platform. On the earlier platform? Your API reference is api-v2.dante-ai.com/openapi.json, and your key goes in the x-api-key header.
AI Voice
Let visitors talk to your agent in real time. A voice agent answers with a natural voice, uses the same knowledge as your chat agent, and can even take phone calls.
What is a voice agent?
A voice agent is a speaking version of one of your existing agents. It answers from the same knowledge sources and follows the same behaviour instructions, but the conversation happens out loud: the visitor talks, the agent listens and replies with a natural-sounding voice.
Voice conversations are available on every plan, and Free includes 10 minutes of voice each month.
Free Starter Advanced Pro
Create a voice agent
- Open AI Voice in the sidebar. This lists your voice agents.
- Under Create a voice agent, give it a name (for example, "Sales voice").
- Pick the chat agent it should speak for. The voice agent inherits that agent's knowledge and instructions. If that agent has not learned anything yet, the form says so: add knowledge to it first, or callers will not get answers about your business.
- Click create. The new voice agent appears in the list, showing its voice and the chat agent it answers from, and a confirmation is shown; you stay on the list so you can create several in a row. Open the new agent from the list to customise how it sounds.
Choose a voice and style
A new voice agent starts with the Alloy voice, and you can pick a different voice on its page.
On the voice agent's page you can shape the whole spoken experience:
- Voice: pick a voice provider and one of its preset voices.
- Speaking style: describe how it should sound, for example "Speak warmly and unhurried".
- Extra instructions: behaviour that only applies on calls, on top of the connected agent's instructions.
- Greeting: the first thing callers hear, for example "Hi! Ask me anything about our plans".
You can test a call right from the editor or the Sandbox before your visitors ever hear it.
Only teammates who can publish (owner, admin, or Editor + deploy) can change what a live voice agent says: its personality prompt, welcome message and voice instructions. Teammates who can edit but not publish can still rename a voice agent and change its voice, but they cannot bind it to a phone number, delete it once it answers a phone number or a widget call, or run auto-build. The same limit applies to the chat agent a voice agent is built on: a teammate who can edit but not publish cannot delete a chat agent that is live, or that has a voice agent answering a phone number or a widget call, because deleting the chat agent would take the voice agent with it.
How visitors start a call
Connecting a voice agent does not by itself put a call button on your site. To add one, open the voice agent and turn on Enable voice calls in the widget in the Widget power-up card. The chat widget then shows a voice-call button in the message bar. One click starts the call; the in-call screen shows who they are talking to and how long the call has been running. The visitor can end the call at any time and continue in text.
Voice credits
Voice conversations cost 5 credits per minute, deducted from the same workspace credit balance as chat messages. If your workspace runs out of credits, calls can no longer be started until credits renew or you top up. See Understanding credits.
In the browser, the call asks for microphone access before it starts. If access is not allowed, or no microphone is found, the call does not start and nothing is charged.
You only pay for calls where the caller's microphone connects. If a call never connects, for example because the caller left before their microphone was connected, the minute charged when it started is refunded and shows as "Voice call did not connect (refunded)" in your credit history.
Phone numbers
On Advanced and Pro you can give a voice agent a real phone number, so customers can simply call you and reach the agent:
- Advanced: rent 1 phone number. Advanced
- Pro: rent up to 3 phone numbers. Pro
Phone numbers are currently available for the United Kingdom only. Calls are understood in English.
Go to AI Voice → Phone numbers, search for an available number, and rent it. The number's monthly rental price is shown before you confirm and is billed on top of your subscription. Assign the number to a voice agent and inbound calls are answered by that agent. Call minutes use the same 5 credits per minute.
If number search is not available yet on your account, the page says so and shows Request a number. It opens an email to our team with your workspace and voice agents filled in; add the country or area code you want and send it. Your request reaches our team, and we reply on that email thread with the next steps.
Transcripts and insights
Every call is transcribed. Read past calls under AI Voice → Conversations, the voice equivalent of chat history.
On Advanced and Pro, AI Voice → Insights adds aggregate analytics across your voice sessions: how often people call, how long calls last, and what they ask about.
Advanced Pro
Still stuck? We'll help.
Every plan, including Free, comes with human support. If something isn't behaving the way you expect after following the steps above, send us a note and we'll get back to you promptly.