Introduction
An AI Voice Agent on Vaaad AI is a configurable voice assistant that can make outbound calls or answer inbound calls on your behalf. Each agent has its own personality, script, language, voice, and optional knowledge base — and can handle thousands of conversations simultaneously.
This guide walks you through creating your first agent, crafting the perfect system prompt, designing a call flow, linking a Knowledge Base, and going live.
Video walkthrough — Building your first agent
Creating Your First Agent
Head to the Agents page in your dashboard and click + New Agent. You'll see a slide-out panel with every configuration option.
- Agent Name — internal label (e.g., “APEX Sales Bot”). Customers never see this.
- Description — a quick note for your team about what this agent does.
- Active toggle — keep off until you've tested. Only active agents can receive calls.
Writing the Perfect System Prompt
The System Prompt is the most important field. It's the instruction manual for your agent — telling it who it is, what it does, and how to behave. A well-written prompt is the difference between an agent that feels human and one that feels robotic.
Structure of a great prompt
We recommend breaking your prompt into clear sections:
# IDENTITY
You are a friendly, professional real estate assistant
named APEX, calling on behalf of Aditya Realty.
# OBJECTIVE
Qualify leads by asking 4 questions:
1. Are they buying or renting?
2. What's their budget range?
3. Preferred location?
4. Timeline to move?
# STYLE
- Warm, conversational, never pushy
- Use "aapka" (formal Hindi) not "tumhara"
- Keep each response under 20 seconds
- Acknowledge what the user says before responding
# RULES
- Never discuss price directly on the call
- If asked for specifics, say: "Our team will follow up
with details via WhatsApp"
- If the user asks to stop, end the call politelyWhat makes a prompt bad
- Too long — prompts over 4000 characters slow down response time
- Contradictions — “Be formal” + “Be casual and friendly”
- No identity — agent doesn't know its own name or company
- Missing objective — agent rambles instead of driving the conversation
Initial Greeting
The Initial Greeting is the first thing your agent says when the call connects. Keep it under 8 seconds and include three elements:
- Who is calling (name + company)
- Why they're calling (one-line context)
- A soft question or pause for the user to respond
Namaste, main APEX hoon, Aditya Realty se. Hum abhi Jaipur ke kuch properties ke liye calls kar rahe hain. Aapko ek minute ho sakta hai?Language & Voice
Vaaad AI supports 22 Indian languages. For each agent, pick:
- Language — Hindi, Hinglish, English, Tamil, Punjabi, Marathi, Bengali, Telugu, and 14 more
- Voice — each language has multiple voice options (male/female, warm/professional)
Hinglish works best for most Indian business calls — it sounds natural and switches between Hindi and English the way real people do.
Designing a Call Flow
Most effective agents follow a simple 5-step flow. Build your prompt around this structure:
- Open — greet + state reason for call
- Permission — “Is this a good time?” (respects the user)
- Qualify — 3-5 questions to understand the need
- Value — share the relevant info or offer
- Close — confirm next step (WhatsApp follow-up, meeting, callback)
Linking a Knowledge Base
If your agent needs to answer specific factual questions — product details, pricing, policies, addresses — attach a Knowledge Base document. The agent will only pull answers from your documents, never make things up.
How to link:
- Go to the Knowledge Base page and upload your docs (PDF, DOCX, TXT)
- Open your agent in the Agents page
- Scroll to Linked Documents and select the docs to attach
- Save. The agent will now use RAG to retrieve relevant info during calls.
Human Handoff
If the user asks to speak to a human (“transfer me”, “insaan se baat karao”), your agent can warm-transfer the call to a real person. Configure this in the agent settings:
- Transfer Number — the human's phone number (with country code)
- Trigger Phrase — optional custom phrase (Vaaad auto-detects 30+ phrases in English, Hindi, and Hinglish)
When triggered, the agent says “I'm connecting you to our team” and dials the human in 2-3 seconds.
Testing Your Agent
Before running a campaign, always test with your own number:
- Make your agent active
- Click New Call from any page
- Enter your own phone number and select the agent
- Answer the call and run through every branch of your script
- Review the recording and transcript in the Calls page
Iterate until it feels natural. Most good agents take 3-5 iterations on the system prompt before they're launch-ready.
Going Live
Once tested, your agent can be used for:
- One-off calls — via the New Call button anywhere in the dashboard
- Campaigns — upload a contact list and call thousands at once. See Call Campaigns
- Inbound — assign a phone number to the agent for incoming calls