Skip to main content

​
Build Your First Voice Agent

Get started with Hamsa by creating a simple customer support agent. This guide will have you up and running in about 10 minutes.
1

Choose Agent Type

For this quickstart, we’ll create a Single Prompt Agent - the fastest way to get started.Navigate to Agents → Create New Agent → Single Prompt
2

Name Your Agent

Give your agent a descriptive name:
Agent Name: Customer Support Bot
3

Write the Greeting

Set the first message callers will hear:
Greeting: "Thank you for calling! I'm here to help. How can I assist you today?"
Choose Static for greeting type.
4

Write the Preamble

This is your agent’s core instructions. Copy and paste this template:
## Identity
You are a helpful customer support assistant for Acme Corporation.

## Style Guardrails
- Be concise (keep responses under 2 sentences unless explaining complex topics)
- Be conversational and friendly
- Use natural language and contractions
- Be empathetic and patient

## Response Guidelines
- Ask only one question at a time
- Confirm understanding by paraphrasing
- If you don't know something, be honest

## Task
Your goal is to help customers with:
1. General product questions
2. Account inquiries
3. Technical support issues

If the issue requires human assistance, politely inform the caller
that you'll connect them with a specialist.
5

Select Voice & Language

  • Language: English (US)
  • Voice: Choose any voice - try aura-asteria-en for a friendly female voice
Preview voices before selecting to find the perfect match for your brand
6

Configure Call Settings

Use these recommended settings for natural conversation:
  • Response Delay: 400ms (default)
  • Allow Interruptions: ON
  • User Inactivity Timeout: 15 seconds
  • Max Call Duration: 300 seconds (5 minutes)
7

Test Your Agent

Click Test Agent in the top right.Browser Test:
  1. Click “Start Test” in browser
  2. Allow microphone access
  3. Have a conversation with your agent
  4. Check real-time logs in the sidebar
Phone Test (Optional):
  1. Click “Test via Phone”
  2. Enter your phone number
  3. Receive a call from your agent
8

Deploy (Optional)

To make your agent live:
  1. Go to Phone Numbers tab
  2. Purchase or connect a phone number
  3. Assign it to your agent
  4. Save changes
Your agent is now live and ready to take calls!

​
What You Built

Congratulations! You just created a functional voice agent that can:
  • Greet callers professionally
  • Handle general inquiries
  • Maintain natural conversation flow
  • Handle interruptions and silence appropriately

​
Next Steps

Add Knowledge Base

Upload company FAQs and documentation

Add Custom Tools

Integrate with your APIs and systems

Advanced Settings

Fine-tune voice, timing, and behavior

Build Flow Agent

Create complex conversation workflows

​
Common Next Steps

​
Add a Knowledge Base

Give your agent access to company information:
  1. Navigate to Knowledge Bases → Create New
  2. Upload documents (PDF, DOC, TXT) or add web URLs
  3. Return to your agent settings
  4. Select the knowledge base in Knowledge Base tab
  5. Test with questions about your content

​
Add Custom Tools

Integrate with your systems:
  1. Go to Tools → Create New Tool
  2. Configure your API endpoint
  3. Define parameters
  4. Add the tool to your agent
  5. Update the preamble to mention when to use the tool

​
Enable Smart Features

Enhance your agent’s capabilities:
  • Smart Call End: Automatically end when conversation concludes
  • Gender Detection: Personalize responses based on caller gender
  • Agentic RAG: Advanced knowledge retrieval with reasoning

​
Troubleshooting

  • Check microphone permissions
  • Verify voice is selected
  • Ensure preamble is not empty
  • Try refreshing the page
  • Try different voice providers (ElevenLabs, PlayHT)
  • Adjust response delay (lower = more responsive)
  • Enable “Thinking Voice” for natural pauses
  • Increase response delay to 600-800ms
  • This gives users more time to complete thoughts
  • Verify phone number format (+1XXXXXXXXXX)
  • Check your workspace has calling credits
  • Try browser test first to verify agent works

​
Video Tutorial

​
Need Help?

Join Our Discord Server Community

Ask questions, share experiences, and get help from the Hamsa community
Ready to build something more complex? Check out our Flow Agent Guide to learn about visual conversation design.