Skip to main content

​
What are AI Voice Agents?

AI Voice Agents are intelligent conversational AI systems that can conduct natural phone conversations with your customers. They can understand speech, respond contextually, detect intents, and complete tasks autonomously.

​
Key Features

Natural Conversations

Engage in human-like conversations with context awareness

Intent Detection

Automatically detect and act on user intents

Multi-language

Support for multiple languages and accents

Real-time Transcription

Live transcription and sentiment analysis

​
Creating Your First Agent

​
Step 1: Access Agent Configuration

  1. Log in to your Mindhunters dashboard at https://your-tenant.mindhunters.ai
  2. Navigate to Agents in the main menu
  3. Click “Create New Agent”

​
Step 2: Configure Basic Settings

Give your agent a descriptive name (e.g., “Customer Support Agent”, “Appointment Scheduler”)
Choose from multiple voice options:
  • Gender: Male, Female, Neutral
  • Accent: US, UK, Australian, etc.
  • Tone: Professional, Friendly, Formal
Select the primary language for conversations:
  • English (US, UK, Australian)
  • Spanish
  • French
  • German
  • And more…

​
Step 3: Define Agent Behavior

The agent prompt defines how your AI behaves during conversations. Example Prompts: 
You are a helpful customer support agent for Acme Corporation.

Your role:
- Greet customers warmly
- Listen to their concerns
- Provide accurate information about products and services
- Escalate complex issues to human agents when needed

Guidelines:
- Be polite and professional
- Ask clarifying questions
- Confirm understanding before taking action
- Thank customers for their time

If you cannot help, say: "Let me connect you with a specialist who can better assist you."

​
Step 4: Configure Intent Detection

Intents are specific actions or goals users express during conversations. Common Intents:
IntentDescriptionExample Phrases
transfer_to_humanUser wants to speak with a person”Can I talk to someone?”, “I need a human”
request_callbackUser wants a callback”Call me back”, “Can someone call me later?“
billing_inquiryQuestions about billing”Check my bill”, “Payment question”
cancel_serviceUser wants to cancel”Cancel my subscription”, “Stop service”
technical_supportTechnical help needed”It’s not working”, “Technical issue”
Setting up Intents:
  1. Go to Agent Settings → Intents
  2. Click “Add Intent”
  3. Define:
    • Intent name
    • Trigger phrases
    • Action to take (trigger webhook, transfer call, etc.)

​
Step 5: Test Your Agent

Before deploying, test your agent:
  1. Click “Test Agent” in the dashboard
  2. Call the test number provided
  3. Have a conversation
  4. Review the transcription
  5. Refine prompts and settings as needed

​
Using Agents via API

Once your agent is created, you can initiate calls programmatically: 
curl -X POST https://your-tenant.mindhunters.ai/api/v1/call \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "550e8400-e29b-41d4-a716-446655440000",
    "participant": {
      "number": "+1234567890",
      "name": "John Doe"
    },
    "greetingMessage": "Hello! This is a call from Acme Corp."
  }'

​
Agent Analytics

Track agent performance in real-time:

​
Available Metrics

  • Total Calls: Number of calls handled
  • Average Duration: Mean call length
  • Success Rate: Percentage of successful completions
  • Intent Detection: Most common intents triggered
  • Sentiment Analysis: Overall sentiment distribution
  • Transcription Quality: Speech recognition accuracy

​
Viewing Analytics

  1. Go to Agents → Select your agent
  2. Click “Analytics” tab
  3. Choose date range
  4. Export data as needed

​
Best Practices

  • Be specific about agent’s role and capabilities
  • Include example responses
  • Define boundaries (what agent should NOT do)
  • Use bullet points for clarity
  • Test with various conversation scenarios
  • Include edge cases and unusual requests
  • Test with different accents and speech patterns
  • Review transcriptions for accuracy
  • Always provide a path to human assistance
  • Set up transfer intents
  • Configure callback options
  • Train agents when to escalate
  • Review transcriptions regularly
  • Track success and failure rates
  • Identify common issues
  • Iterate on prompts based on data
  • Don’t collect unnecessary personal information
  • Inform users they’re speaking with AI
  • Comply with recording consent laws
  • Follow GDPR and data privacy regulations

​
Common Use Cases

​
Customer Support

Agent Prompt
You are a customer support agent for [Company Name].

Capabilities:
- Answer questions about products and services
- Help with account issues
- Process refund requests
- Schedule callbacks

If customer needs:
- Password reset → Guide them to reset link
- Refund → Collect order number and reason
- Technical issue → Transfer to tech support
- Billing question → Verify account and provide info

Always be patient, empathetic, and helpful.

​
Appointment Scheduling

Agent Prompt
You are an appointment booking assistant for [Business Name].

Process:
1. Greet customer: "Hello! I can help you schedule an appointment."
2. Confirm their name and phone number
3. Ask for preferred date and time
4. Check availability (Mon-Fri, 9 AM-5 PM)
5. Confirm appointment details
6. Provide confirmation number

If slot unavailable, offer 2-3 alternatives.
If they need to reschedule, collect existing appointment details first.

​
Lead Qualification

Agent Prompt
You are a sales qualification assistant.

Your goal: Qualify leads by gathering information.

Questions to ask:
1. What product/service are you interested in?
2. What's your timeline for making a decision?
3. What's your budget range?
4. Who else is involved in the decision?

Based on answers:
- High priority: Budget >$10k, timeline <30 days → Schedule demo
- Medium priority: Budget $5-10k → Send information packet
- Low priority: Just researching → Add to newsletter

Be conversational, not interrogative.

​
Troubleshooting

​
Agent Not Responding

  • Check agent is activated
  • Verify phone number format (E.164)
  • Check API token is valid
  • Review error logs in dashboard

​
Poor Transcription Quality

  • Ensure good audio quality
  • Check for background noise
  • Verify language setting matches caller
  • Test with different voice options

​
Intent Not Detecting

  • Add more trigger phrases
  • Make phrases more specific
  • Test intent configuration
  • Review transcriptions for actual phrases used

​
Next Steps

API Reference

See full API documentation

Webhooks

Get real-time conversation updates

Campaigns

Create agent-powered campaigns

Monitoring

Track agent performance