Docs
Set up your voice agent
Everything you need to get an agent answering, in the order you will need it.
What AdoVoice does
AdoVoice gives your business an AI agent that picks up the phone. It greets the caller, answers questions from the information you gave it, completes a booking or an order, and records what happened. You read every conversation in the dashboard.
The agent only answers from what you have written for it. If a caller asks something it does not know, it says so and offers to take a message for your team.
Quick start
- Open the dashboard and create your account. The first account sets up the workspace.
- Go to Agent studio and choose New agent. Enter your business name, type and city.
- Write what the agent should know: timings, services, prices, staff, address and any rules.
- Go to Voices, press play on a few voices in your language, and choose one.
- Open Talk to it on the home page, pick your business and make a test call.
- Read the call under Conversations and adjust what the agent knows until it answers the way you want.
Try a call
The live call on the home page runs in your browser. Pick a business, allow the microphone, and speak. You can also type. A call lasts up to three minutes.
- Speaking works in Chrome and Edge. In other browsers, type instead.
- Choose the language before you start the call. The agent follows you if you switch language while talking.
- The panel on the right shows what the agent captured and what it did.
Agents
An agent is one business line: its name, what it knows and how it sounds. Four sample agents are included so you can try things straight away. You can edit them, reset them, or create up to 12 of your own.
| Field | What to put there |
|---|---|
| Business name | The name the agent says when it answers. |
| Type and city | For example "Dental clinic" and "Pune". The agent speaks the way people there do. |
| What the agent knows | The facts it may use. See the next section. |
| How it should sound | Optional notes, such as "always offer the earliest slot first". |
Changes apply to the next call. A call already in progress is not affected.
Writing what it knows
Write the way you would brief a new receptionist. Short, plain lines work best.
Timings: Monday to Saturday, 10 AM to 8 PM. Closed Sunday.
Services and prices: consultation ₹300, teeth cleaning ₹1,200.
Staff: Dr. Iyer (general), Dr. Mehta (braces, Tue and Thu only).
Slots are 30 minutes. Assume a slot is free unless noted here.
Address: 2nd floor, MG Road, next to the metro station.
We do not give medical advice on the phone.
- Include prices. Callers ask, and the agent will not guess.
- State the rules. Last order time, minimum booking notice, advance payment.
- Say what it must not do. For example, no medical advice or no discounts.
- Keep it current. Update it for holidays and offers.
Voices
Under Voices you choose one voice for each language. Press play to hear a voice say the sample sentence, or type your own sentence. Speed makes it slower or faster. Expression makes it livelier or steadier. The voice marked "In use" is the one callers hear.
Voices need a voice service key on the server. Without it, the live call falls back to the browser's built-in voice.
Languages
The agent speaks English, Hindi, Tamil, Telugu, Kannada and Malayalam, and mixes such as Hinglish. It replies in the language the caller uses and uses everyday spoken wording, keeping common English words like "booking" and "slot".
Phone line
Connect a real phone number so the agent answers calls and can call people. AdoVoice works with Plivo, which rents Indian numbers, and with Twilio. The agent, its knowledge and its voice are the same as in the browser call.
Indian numbers with Plivo
- Create a Plivo account and choose the India data region. This cannot be changed later.
- Submit one business document: a GST certificate, a Certificate of Incorporation, or an Udyam registration. Only businesses registered in India can rent Indian numbers.
- Rent a number. 080 and 022 landline numbers are for service calls such as bookings and reminders, not for promotions.
- Put the AdoVoice server on a public https address. For a test on your own computer, a tunnel tool such as ngrok or cloudflared gives you one.
- Add four lines to the server's
.envfile and restart it:PLIVO_AUTH_ID=your auth ID PLIVO_AUTH_TOKEN=your auth token PLIVO_NUMBER=+9180XXXXXXXX PUBLIC_URL=https://your-public-address - Open Phone line in the dashboard. In Plivo, create an Application under Voice, paste the two addresses the dashboard shows as its Answer URL and Hangup URL (both POST), and attach your number to that application.
- Choose which agent answers and the language callers usually speak. Then call the number.
Using Twilio instead
Set TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_NUMBER and PUBLIC_URL, then paste the two addresses from the dashboard into your number's Voice configuration. If both providers are set, Plivo is used; set PHONE_PROVIDER=twilio to choose Twilio.
How a call works
The agent greets the caller, the phone provider turns what the caller says into text, the agent replies, and this repeats until the goodbye. Every call appears under Conversations with the caller's number and the transcript.
- Language. The line listens in the language you chose. If the agent switches language to follow the caller, the line switches too. A caller who starts in a different language may be misheard on the first sentence.
- Silence. If the caller says nothing, the agent asks once whether they are there, then ends the call.
- Voice. With a voice key the caller hears the voice you chose under Voices. Without one, the phone provider's basic voice is used.
- Confirmations. On the phone the agent says the team will confirm the booking. It does not promise a WhatsApp message, because none is sent yet.
Calling out
Under Phone line, enter a number with its country code, choose an agent and say why it is calling, for example "Remind about the appointment tomorrow at 5 PM". The agent introduces itself as an AI assistant and explains the reason. These are real calls charged by your phone provider. Only call people who expect your call, during permitted hours, and follow do-not-disturb rules.
Security
The phone addresses only accept requests signed by your phone provider account. Keep the auth token secret, and change it with the provider if it is ever exposed.
The dashboard
| Screen | What it shows |
|---|---|
| Overview | Calls, bookings, after-hours calls and call-backs for the last 24 hours. |
| Conversations | Every call and website chat, with its transcript. |
| Bookings | Appointments, orders and rides the agents completed. |
| Inbox | Demo requests and support tickets from your website. |
| Agent studio | Create and edit agents. |
| Voices | The voice for each language. |
| Phone line | Connect a number, choose who answers, and place calls. |
| Settings | Your name and password. |
Campaigns and Billing are previews: they show sample data and are not connected yet.
Conversations
Each row is one call or one website chat. Click it to read the full transcript, the details the agent captured and the actions it took. Use the search box to find a name, a slot or a phrase, and the chips to filter by outcome or by type.
| Outcome | Meaning |
|---|---|
| Booked | The agent completed a booking, order or reservation. |
| Call back | The caller needs your team. Read the call and phone them. |
| Answered | The caller got an answer and nothing was booked. |
| Live | The conversation is happening now. |
Rows tagged "sample" are example calls included so the screens are not empty.
Inbox
Demo requests from the home page form and tickets from the support page arrive here. Mark an item done when you have dealt with it. Nothing is emailed automatically yet, so check the inbox regularly.
Account and sign-in
- The first account created becomes the workspace owner. After that, new sign-ups are closed.
- To let more people create accounts, set
OPEN_SIGNUP=trueon the server. All accounts see the same workspace. - You stay signed in for 7 days. Change your password under Settings; this signs out your other devices.
- There is no "forgot password" email yet. If you lose the password, the server owner must remove the account file and create it again.
Limits
| Item | Limit |
|---|---|
| Live demo call length | 3 minutes or 14 caller turns |
| Agents you can create | 12 |
| What the agent knows | 6,000 characters per agent |
| Website chat | 20 messages per conversation |
| Requests per visitor | 20 call turns a minute |
Running the server
AdoVoice runs as one Node.js server. It needs Node 22 or newer.
npm install
npm start
Settings go in a file named .env next to the server:
| Setting | Purpose |
|---|---|
ANTHROPIC_API_KEY | Required. Runs the agent and the website chat. |
SARVAM_API_KEY | Optional. Native Indian voices. |
AGENT_MODEL | Optional. The model that runs calls. |
PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN, PLIVO_NUMBER, PUBLIC_URL | Optional. Real phone calls with an Indian number. See Phone line. |
OPEN_SIGNUP | Optional. true lets more people create accounts. |
PORT | Optional. Defaults to 4173. |
Run npm test to check everything works. Data is stored as files in the data folder; back it up.
Common questions
Does it connect to a real phone number?
Yes. Follow Phone line to connect an Indian number through Plivo. Without it, the agent runs in the browser only.
Are bookings real?
The agent records the booking in the dashboard for your team to confirm. It does not yet write to your calendar or send a WhatsApp message.
Why did the agent say it was closed?
It knows the current date and time and follows the timings you wrote.
The agent gave a wrong answer. What do I do?
Open the call under Conversations, find the question, and add or correct the fact in Agent studio.
Still stuck?
Raise a ticket on the support page or ask the chat assistant in the corner of this page.