AI Assistants & Agents
AI Assistants (also called Agents or Prompts) are intelligent voice and SMS agents that automate conversations, handle customer inquiries, schedule appointments, and extract information. They use advanced AI to understand context, respond naturally, and route calls intelligently.
Common Use Cases
24/7 Receptionist
Answer incoming calls, greet callers, collect information, and route to appropriate departments or agents. Never miss a call, even after hours.
Lead Qualification
Qualify leads automatically by asking targeted questions, identifying hot prospects, and flagging them for immediate follow-up.
Appointment Scheduling
Schedule appointments, confirm availability, send calendar invites via Cal.com integration, and send SMS reminders.
Campaign Follow-ups
Follow up with leads from campaigns, confirm interest, answer questions, and book sales calls or demos automatically.
Customer Support
Handle common support questions, provide account information, escalate complex issues, and route to specialized teams.
Data Collection
Extract structured data from conversations (names, emails, preferences, feedback) and automatically save to your CRM or database.
Key Benefits
Always Available
Your assistant never sleeps. Handle calls 24/7/365, including holidays and after-hours, ensuring you never miss an opportunity.
Cost Effective
Reduce staffing costs by automating routine calls and conversations. One AI assistant can handle hundreds of calls simultaneously.
Consistent Experience
Every caller receives the same high-quality, professional experience. No mood swings, no bad days—just consistent, friendly service.
Instant Responses
No hold times, no voicemail waiting. Calls are answered instantly with immediate, intelligent responses to customer questions.
Scalable
Handle peak call volumes without hiring additional staff. Your assistant scales automatically to meet demand.
Creating Your First Assistant
Follow these steps to create and configure your AI assistant. Once created, you can add advanced features like data extraction, call forwarding, and automated templates.
Step 1: Basic Configuration
-
1
Navigate to Prompts: Go to Prompts in the main navigation and click Create Prompt.
-
2
Select Phone Number: Choose the phone number this assistant will use. This number must already be purchased in your Numbers section.
Tip: Each number can have multiple assistants (inbound and outbound), but only one assistant per type per number.
-
3
Choose Type: Select either Inbound (receives calls) or Outbound (makes calls via campaigns).
- Inbound: For receiving calls. Best for receptionist, support, and customer service scenarios.
- Outbound: For making calls through campaigns. Includes voicemail detection and messaging.
-
4
Enable Scheduling (Optional): Check Is Scheduled if this assistant should only operate during specific times. Leave unchecked for 24/7 operation.
Use Case: Use scheduling to activate an assistant only during business hours, or to pause it during maintenance windows.
Step 2: First Message (Greeting)
The first message is what your assistant says when a call begins or is answered. Keep it concise, friendly, and informative.
Good Examples
- • "Hello! Thank you for calling Acme Corp. I'm your AI assistant. How can I help you today?"
- • "Hi! This is Sarah, your virtual assistant. I can help you schedule an appointment, answer questions, or connect you with our team. What would you like to do?"
- • "Good morning! Welcome to Tech Solutions. I'm here to assist you. Are you calling to book a consultation, check on an existing order, or something else?"
What to Avoid
- • Too long: Keep under 20 seconds. Long greetings annoy callers.
- • No clear purpose: Always explain what you can help with.
- • Technical jargon: Use simple, conversational language.
Step 3: Content (AI Instructions)
The content field contains detailed instructions for your assistant's behavior, personality, and decision-making. This is the "brain" of your assistant. Write clear, specific instructions (minimum 100 characters, recommended 500-2000).
Content Structure Template
You are [ASSISTANT_NAME], a friendly and professional AI assistant for [COMPANY_NAME].
YOUR ROLE:
- [Primary purpose: e.g., "Schedule consultations for our sales team"]
- [Secondary tasks: e.g., "Answer common questions about our services"]
CONVERSATION FLOW:
1. Greet the caller warmly (using the first message)
2. Ask for their name and reason for calling
3. [Specific task steps]
4. [How to handle common scenarios]
5. [When to transfer to a human]
INFORMATION TO COLLECT:
- Full name
- Phone number
- Email address
- [Other relevant info]
RULES:
- Always be polite and professional
- If unsure, ask clarifying questions
- Never make up information
- [Additional rules specific to your use case]
WHEN TO TRANSFER:
- [Conditions for transferring to a human agent]
- [Conditions for scheduling a callback]
Content Examples by Use Case
Receptionist Assistant
You are Emma, a friendly receptionist for Acme Consulting. Your role is to greet callers, collect basic information, and route calls to the appropriate department.
CONVERSATION FLOW:
1. Greet warmly: "Hello! Thank you for calling Acme Consulting. I'm Emma. How can I assist you today?"
2. Ask for caller's name: "May I have your name, please?"
3. Determine their need: "What brings you to call today? Are you looking to schedule a consultation, inquire about our services, or speak with someone specific?"
4. Based on response:
- Scheduling: Collect preferred date/time and email, confirm details
- Service inquiry: Answer basic questions, offer to schedule consultation
- Specific person: Ask for their name and department, offer to transfer
5. Thank them: "Thank you for calling! Is there anything else I can help you with?"
INFORMATION TO COLLECT:
- Full name
- Phone number (if not available from caller ID)
- Email address
- Reason for calling
- Preferred contact method
RULES:
- Always be polite and professional
- Speak clearly and at a moderate pace
- If you don't know something, say "Let me connect you with someone who can help with that"
- Never provide pricing or contract details without speaking to a consultant
WHEN TO TRANSFER:
- Caller requests to speak with a specific person
- Questions require detailed technical knowledge
- Caller is upset or requires escalation
Lead Qualification Assistant
You are Alex, a lead qualification specialist for Tech Solutions. Your goal is to determine if a caller is a qualified sales lead and gather essential information for the sales team.
CONVERSATION FLOW:
1. Greet: "Hi! I'm Alex with Tech Solutions. I understand you're interested in our services. Is that correct?"
2. Qualifying questions (ask 3-5):
- "What type of business are you with?"
- "How many employees does your company have?"
- "What's your current solution, if any?"
- "What's your timeline for implementing a new solution?"
- "What's your budget range?"
3. Based on answers, categorize:
- HOT LEAD: Ready to buy, has budget, timeline within 30 days
- WARM LEAD: Interested, needs more information, timeline 30-90 days
- COLD LEAD: Just browsing, no immediate need
4. For HOT/WARM: "Great! I'd like to schedule a 15-minute consultation with one of our specialists. When works best for you?"
5. For COLD: "I'd be happy to send you some information. What's your email address?"
INFORMATION TO COLLECT:
- Company name
- Contact name and title
- Phone number and email
- Company size (employees)
- Current solution
- Budget range (if appropriate to ask)
- Timeline
- Primary pain points
RULES:
- Be conversational, not robotic
- Listen carefully to answers
- Don't be pushy with cold leads
- Flag hot leads immediately for priority follow-up
- Use the data extraction feature to save all collected information
WHEN TO TRANSFER:
- Lead is ready to speak with sales immediately
- Complex technical questions arise
- Request for specific pricing or contracts
Appointment Scheduling Assistant
You are Sam, an appointment scheduler for HealthCare Clinic. Your role is to help patients book, reschedule, or cancel appointments efficiently.
CONVERSATION FLOW:
1. Greet: "Hello! Thank you for calling HealthCare Clinic. I'm Sam, your virtual scheduler. How can I help you today?"
2. Determine action:
- "Are you calling to schedule a new appointment, reschedule an existing one, or cancel?"
3. For NEW appointments:
- Ask: "What type of appointment do you need?" (List options: General Checkup, Specialist Consult, Follow-up)
- Ask: "Do you have a preferred date or time?"
- Ask: "Do you have a preferred provider, or would you like me to find the next available?"
- Collect: Name, DOB, Phone, Email, Reason for visit
- Confirm: "I have you scheduled for [DATE] at [TIME] with [PROVIDER]. Does that work?"
4. For RESCHEDULE:
- Ask for appointment confirmation number or date of current appointment
- Ask for new preferred date/time
- Confirm changes
5. For CANCEL:
- Ask for appointment details
- Confirm cancellation and offer to reschedule
INFORMATION TO COLLECT:
- Patient name
- Date of birth
- Phone number
- Email address
- Appointment type
- Preferred date/time
- Provider preference
- Reason for visit (if appropriate)
RULES:
- Always confirm appointment details before finalizing
- Be flexible with scheduling
- If preferred time unavailable, suggest alternatives
- Remind about cancellation policy (24 hours notice)
- Mention any required documents or preparations
WHEN TO TRANSFER:
- Medical emergency (transfer to urgent care)
- Complex medical questions
- Insurance verification issues
- Requests for medical records
Step 4: Voice Selection
Choose a natural-sounding AI voice for your assistant. Each voice has a unique tone and personality. You can preview voices before selecting.
- Elliot: Male, professional, confident - Good for business and sales
- Cole: Male, friendly, conversational - Good for customer service
- Lily: Female, warm, welcoming - Good for hospitality and support
- Savannah: Female, energetic, enthusiastic - Good for sales and marketing
- Hana: Female, calm, professional - Good for healthcare and professional services
- Paige: Female, friendly, approachable - Good for general customer service
- Harry: Male, clear, authoritative - Good for announcements and information
- Rohan: Male, warm, trustworthy - Good for consultation and advice
Tip: Click the play button next to the voice selector to preview how the voice sounds before making your selection.
Step 5: Voicemail Message (Outbound Only)
For outbound assistants only. If the call goes to voicemail, this message will be left automatically.
Example Voicemail Message
"Hi [Name], this is [Your Company]. We tried reaching you but couldn't connect. We'd love to discuss how we can help with [specific value proposition]. Please call us back at [your number] at your earliest convenience, or reply to this message if you'd prefer. Thank you!"
Best Practices: Keep voicemail messages under 30 seconds, include your callback number, and clearly state your value proposition.
Step 6: Save Your Assistant
Click Save Prompt to create your assistant. After saving, you'll be redirected to the editing page where you can add advanced features like data extraction, call forwarding, and post-call templates.
After Saving
Once saved, your assistant is automatically created in VAPI and ready to use. You can:
- Start receiving calls immediately (inbound) or use it in campaigns (outbound)
- Add data extraction to automatically collect information
- Configure forwarded numbers for human handoff
- Set up post-call templates for SMS/Email follow-ups
Advanced Features (After Creation)
Once you've created your assistant, you can enhance it with these powerful features. Access them by editing your prompt.
Data Extraction
Automatically extract structured data from conversations and save it to your database. Perfect for collecting customer information, survey responses, or lead details.
How It Works
During the conversation, your assistant will identify and extract specific information based on key-value pairs you define. The extracted data is automatically saved and can be used in templates, campaigns, or exported to your CRM.
Setting Up Data Extraction
-
Open the Data Extraction section: After creating your assistant, click on the Data Extraction accordion in the editing page.
-
Define Key-Value Pairs: Add pairs that specify what information to extract.
- Key: The name/label for the data (e.g., "customer_name", "email_address", "budget_range")
- Value: Instructions for the AI on how to identify and extract this information
-
Example Pairs:
Key: customer_name | Value: Extract the caller's full name when they introduce themselvesKey: email | Value: Capture the email address mentioned by the callerKey: phone_number | Value: Get the phone number if caller provides an alternate contact numberKey: appointment_date | Value: Extract the date and time when caller mentions their preferred appointment slotKey: lead_score | Value: Based on conversation, rate lead as hot, warm, or cold -
Save Your Extraction Pairs: Click Save Data to activate data extraction for this assistant.
Best Practices
- Be Specific: Clear, specific value instructions help the AI extract accurately. Instead of "name", use "Extract the caller's full name when they introduce themselves or provide it".
- Use Context: Provide context in your value field. For example, "Extract the budget amount if the caller mentions their budget or how much they're willing to spend".
- Limit Complexity: Don't extract too many fields at once. Focus on 5-10 key pieces of information per conversation.
- Update Content: Make sure your assistant's content instructions mention asking for information you want to extract.
Use Cases
Lead Qualification
Extract: company_name, company_size, budget, timeline, pain_points
Appointment Booking
Extract: patient_name, appointment_type, preferred_date, preferred_time, email
Customer Feedback
Extract: satisfaction_score, feedback_text, product_name, issue_category
Support Tickets
Extract: issue_description, account_number, urgency_level, preferred_contact_method
Forwarded Numbers (Call Transfer)
Configure phone numbers where calls can be transferred when your assistant determines a human agent is needed. Perfect for escalation, complex questions, or specific department routing.
How It Works
When your assistant's content instructions determine that a call should be transferred (based on conditions you define), it will automatically transfer to one of your configured forwarded numbers. The assistant will play a transfer message to the caller before connecting.
Setting Up Forwarded Numbers
-
Open the Forwarded Numbers section: In the prompt editing page, expand the Forwarded Numbers accordion.
-
Add Phone Numbers: Click Add Number to add a forwarding destination.
- Phone Number: Enter in any format (e.g., 1234567890, +1234567890, (123) 456-7890). The system automatically converts to E.164 format.
- Extension (Optional): If the number requires an extension, enter it here.
- Transfer Message: What the assistant says before transferring. Example: "Let me transfer you to our specialist who can better assist you."
-
Add Multiple Numbers: You can configure multiple forwarding numbers for different scenarios (e.g., sales department, support team, billing department).
-
Save Your Numbers: Click Save Number for each configured forwarding destination.
Configuring Transfer Logic in Content
Update your assistant's content instructions to specify when transfers should occur:
WHEN TO TRANSFER:
- When caller explicitly requests to speak with a human agent
- When caller asks technical questions beyond your knowledge
- When caller is upset or requires escalation
- When caller needs specific information (pricing, contracts) that requires human approval
- When caller wants to speak with a specific person or department
TRANSFER PROCESS:
1. Acknowledge: "I understand. Let me connect you with someone who can help."
2. Provide context: "I'm transferring you to [department/agent name] who specializes in [topic]."
3. Transfer the call to the configured forwarded number
Common Scenarios
Single Department Transfer
One forwarded number for all escalations. Simple setup for small teams.
Multiple Department Routing
Different numbers for sales, support, billing. Your assistant routes based on caller needs mentioned in conversation.
Business Hours Transfer
Forward during business hours, voicemail after hours. Combine with scheduling feature.
Best Practices
- Clear Transfer Messages: Always explain why you're transferring and what to expect. "Let me connect you with our billing specialist who can review your account details."
- Test Numbers: Verify all forwarded numbers work correctly before going live.
- Monitor Transfers: Review call logs to see transfer patterns and optimize routing logic.
- Emergency Routing: Consider having an emergency/urgent transfer number for time-sensitive situations.
Post-Call Templates (Automated Follow-up)
Automatically send SMS or Email templates after calls complete. Perfect for sending appointment confirmations, follow-up information, receipts, or thank-you messages.
How It Works
After a call ends, your assistant can automatically trigger one or more templates to be sent via SMS or Email. Templates can include variables like the caller's name, appointment date, or extracted data. You can set a default template or let the assistant choose based on conversation context.
Setting Up Post-Call Templates
-
Create Templates First: Before adding templates to your assistant, ensure you have created the templates you want to use in the Templates section.
-
Open the Select Post Template section: In the prompt editing page, expand the Select Post Template accordion.
-
Select Templates: Choose one or more templates from the dropdown. You can select multiple templates to send a sequence of follow-up messages.
- Templates are shown as cards with their name and trigger input
- You can select multiple templates for a sequence
- Set one template as "Default" to send if no specific trigger is detected
-
Set Default Template: Click Set Default on the template you want sent automatically after every call. Other templates will be sent based on trigger inputs or conversation context.
-
Save Templates: Click Save Templates to link them to your assistant.
Template Variables
Use variables in your templates to personalize messages with data from the conversation:
{name} - Caller's name{phone_number} - Caller's phone number{email} - Caller's email (if collected){appointment_date} - Scheduled appointment date{appointment_time} - Scheduled appointment time{company_name} - Your company name{extracted_data_key} - Any data extracted via Data Extraction (use the key name)
Use Cases
Appointment Confirmation
Send SMS immediately after scheduling: "Hi {name}, your appointment is confirmed for {appointment_date} at {appointment_time}. Reply CONFIRM to confirm or RESCHEDULE to change."
Follow-up Information
Send email with requested information: "Thank you for calling, {name}. As promised, here's the information about [topic]. [Link to resources]"
Thank You & Next Steps
Send after lead qualification: "Thanks for your interest, {name}! A specialist will contact you within 24 hours. In the meantime, check out: [link]"
Receipt/Confirmation
Send after purchase/booking: "Your order is confirmed, {name}. Order #: {order_number}. Estimated delivery: {delivery_date}. Track here: [link]"
Template Trigger Input
When creating templates, you can set a "Trigger Input" that tells your assistant when to send that specific template. This allows conditional sending based on conversation outcomes.
Example Triggers:
- appointment_booked - Send appointment confirmation template
- quote_requested - Send pricing information template
- demo_scheduled - Send demo preparation template
- support_ticket_created - Send ticket confirmation template
- lead_qualified_hot - Send priority follow-up template
In your assistant's content, instruct it to set trigger inputs based on conversation outcomes. For example: "If the caller books an appointment, set trigger_input to 'appointment_booked'."
Best Practices
- Immediate Follow-up: Send templates immediately after calls for best engagement. Don't wait hours.
- Personalization: Always use variables to personalize messages. Generic messages feel robotic.
- Clear CTAs: Include clear next steps or calls-to-action in your templates.
- Sequence Templates: For complex follow-ups, create a sequence: immediate confirmation, 1-day follow-up, 3-day reminder, etc.
- Test Templates: Send test messages to yourself before going live to verify formatting and variables.
Editing & Managing Assistants
To edit an assistant, go to Prompts, find your assistant in the list, and click Edit. The editing page uses collapsible sections for easy navigation.
Prompt Configuration Section
This section (expanded by default) contains all basic settings:
- Phone Number: Cannot be changed after creation (disabled). To use a different number, create a new assistant.
- Type: Cannot be changed after creation. Create a new assistant for a different type.
- Is Scheduled: Can be toggled on/off anytime.
- First Message: Can be updated to change the greeting.
- Content: Can be updated to refine behavior, add instructions, or fix issues.
- Voicemail Message: Can be updated for outbound assistants.
- Voice: Can be changed to try different voice options.
Tip: After updating content or settings, click Update Prompt to save changes. Changes take effect immediately.
Data Extraction Section
Available after creating your assistant. Collapsible section for managing extraction pairs:
- Add New Pairs: Click "Add Pair" to create new extraction fields.
- Edit Existing: Modify key or value fields and save changes.
- Remove Pairs: Click the trash icon next to any pair to delete it.
- Remove All Extraction: Click "Remove Data Extraction" to completely remove extraction from this assistant.
Forwarded Numbers Section
Collapsible section for managing call transfer destinations:
- Add Numbers: Click "Add Number" to add new forwarding destinations.
- Edit Numbers: Update phone number, extension, or transfer message.
- Remove Numbers: Click the trash icon to remove a forwarding number.
- Remove All Forwarding: Click "Remove Forwarded Number" to disable call forwarding completely.
Select Post Template Section
Collapsible section for managing automated follow-up templates:
- Add Templates: Select from dropdown (supports multiple selection).
- Remove Templates: Deselect from dropdown or click "Set Default" to remove default status.
- Change Default: Click "Set Default" on a different template to change the default.
- View Template Details: Each template card shows name and trigger input for reference.
Common Scenarios & Solutions
Assistant isn't answering calls correctly
Possible Causes & Solutions:
- Content too vague: Make your content instructions more specific. Include explicit steps for common scenarios.
- First message unclear: Ensure your first message sets proper expectations and guides the conversation.
- Missing context: Add more context about your business, services, and common questions to the content field.
- Test with sample calls: Make test calls and review transcripts to identify where conversations break down.
Data extraction not working
Checklist:
- Value field clarity: Make sure your value instructions are clear and specific about what to extract.
- Content mentions extraction: Your assistant's content should instruct it to ask for information you want to extract.
- Key names: Use descriptive, unique key names without spaces or special characters.
- Conversation flow: Ensure your assistant actually asks for the information during conversations.
- Review call logs: Check if the information is being mentioned in conversations but not extracted.
Calls not transferring to forwarded numbers
Troubleshooting Steps:
- Verify number format: Check that forwarded numbers are correctly formatted and saved.
- Check content instructions: Your assistant's content must explicitly state when to transfer calls.
- Test number: Verify the forwarded number can receive calls independently.
- Review transfer conditions: Ensure transfer conditions in content are clear and testable.
- Check call logs: Review if conversations are reaching transfer conditions but transfers aren't happening.
Templates not sending after calls
Verification Checklist:
- Templates linked: Confirm templates are selected and saved in the assistant.
- Default template set: Ensure at least one template is set as default.
- Template active: Verify templates themselves are active in the Templates section.
- Trigger inputs: If using triggers, ensure assistant sets trigger inputs correctly.
- Caller contact info: Templates require phone number (SMS) or email (Email) to send.
- Check call completion: Templates only send after calls complete successfully.
Assistant sounds robotic or unnatural
Improvement Tips:
- Add personality: In content, specify tone: "Be friendly and conversational, like a helpful colleague."
- Use natural language: Write content instructions as if talking to a human, not programming a robot.
- Allow variations: Instruct: "Vary your responses slightly. Don't repeat the exact same phrase every time."
- Voice selection: Try different voices to find one that matches your brand personality.
- Conversational flow: Allow for natural back-and-forth. Don't script every response.
Outbound calls going to voicemail immediately
This is Normal Behavior:
When using assistants in outbound campaigns, calls that go to voicemail are handled automatically. The assistant will leave your configured voicemail message. This is expected behavior and helps you reach contacts even when they're unavailable.
To improve answer rates:
- Call during business hours for better answer rates
- Use local numbers when possible (higher answer rates)
- Ensure your voicemail message is compelling and encourages callbacks
- Review call logs to identify optimal calling times for your audience
Best Practices & Tips
Content Writing
- Start simple: Create a basic working assistant first, then add complexity gradually.
- Be specific: Vague instructions lead to inconsistent behavior. Be explicit about what to do in each scenario.
- Provide examples: Include example conversations or responses in your content to guide the AI.
- Test iteratively: Make small changes, test, review results, then refine. Don't rewrite everything at once.
- Document edge cases: Think about unusual scenarios (angry callers, wrong numbers, language barriers) and provide instructions.
Testing
- Make test calls: Regularly call your assistant to experience what callers experience.
- Review call logs: Check call transcripts to identify areas for improvement.
- Test edge cases: Try unusual requests, interruptions, or difficult scenarios to ensure robust behavior.
- Get feedback: Have team members or trusted customers test and provide feedback.
- Monitor metrics: Track call completion rates, transfer rates, and customer satisfaction.
Performance Optimization
- Keep content concise: While detailed instructions help, overly long content can slow responses. Aim for 500-2000 characters for most use cases.
- Limit extraction fields: Extract only essential data. Too many fields can confuse the AI and slow conversations.
- Optimize transfer logic: Clear transfer conditions reduce unnecessary hold times and improve customer experience.
- Regular updates: Review and update your assistant monthly based on call logs and feedback.
Security & Compliance
- Never collect sensitive data: Don't ask for credit card numbers, SSNs, or passwords during calls.
- Comply with regulations: Ensure your assistant complies with Do Not Call lists, GDPR, and local telemarketing laws.
- Secure forwarded numbers: Only forward to verified, secure numbers.
- Data handling: Ensure extracted data is stored securely and handled according to privacy regulations.
Related Resources
Phone Numbers
Learn how to purchase and manage phone numbers for your assistants.
Campaigns
Use assistants in outbound campaigns to automate lead follow-up and outreach.
Templates
Create SMS and Email templates for automated post-call follow-ups.
Call Logs
Review call logs, transcripts, and analytics to optimize your assistants.