Skip to main content

​
Quickstart

This guide walks you through creating your first AI voice agent on Movoice — from sign-up to a live phone call.

​
Prerequisites

  • A Movoice AI account — Sign up free
  • (Optional) A Twilio or Exotel account if you want BYOC telephony
1

Create an Agent

  1. Log in to the Movoice Dashboard.
  2. Click Agent Studio in the left sidebar.
  3. Click + New Agent.
  4. Choose a template — Receptionist, Sales Qualifier, or Appointment Booker — or start from scratch.
  5. Give your agent a name (e.g., “Priya — Dental Receptionist”).
2

Write Your Agent Prompt

The prompt is the system instruction that controls your agent’s behavior. Write it clearly:
You are Priya, a polite receptionist for Sharma Dental Clinic in Bhubaneswar.
Your job is to:
1. Greet callers warmly in Hindi or Odia based on how they speak.
2. Book, reschedule, or cancel appointments.
3. Answer basic questions about clinic hours (Mon–Sat, 9am–7pm).

Always confirm the caller's name and phone number before ending the call.
If you cannot help, transfer to a human agent.
See the Prompting Guide for best practices on writing effective prompts for Indian callers.
3

Configure Voice & LLM

In the Agent Studio sidebar:
  1. Voice: Browse voices filtered by language (Hindi, Odia, English). Look for the Low Latency tag for best performance.
  2. LLM: Select the brain of your agent.
    • Gemini 1.5 Flash — best speed-to-quality ratio for most use cases
    • GPT-4o mini — reliable fallback
    • Claude 3.5 Sonnet — best for complex multi-turn conversations
  3. Language: Set your agent’s primary language. Movoice auto-detects language switching mid-call.
4

Test Your Agent

Before going live, test in the browser:
  1. Click Test Audio in the bottom-right of Agent Studio.
  2. Allow microphone access when prompted.
  3. Have a conversation with your agent — try questions it should handle and ones it shouldn’t.
  4. Check the Live Transcript panel on the right to review what was heard and said.
If responses feel slow, switch to Gemini Flash or a Sarvam AI voice — both are optimized for Indian server routing.
5

Assign a Phone Number

To receive or make real calls:
  1. Go to Phone Numbers in the sidebar.
  2. Click Buy Number to purchase an Indian number directly, or click Connect Existing to use your Twilio/Exotel account.
  3. Under Assign Agent, select the agent you just created.
6

Make Your First Call

Inbound — call the number you just assigned. Your agent will pick up.Outbound — trigger a call via the API or dashboard:
curl -X POST https://api.movoice.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_xxxxx",
    "recipient_phone": "+919876543210",
    "variables": {
      "name": "Rahul",
      "appointment_time": "Tomorrow at 3 PM"
    }
  }'

​
Next Steps

Inbound Call Setup

Configure phone numbers and routing for inbound calls.

Outbound Calls

Trigger calls via API and send bulk campaigns.

Prompting Guide

Write better prompts for Indian callers.

Webhooks

Get notified in real-time when calls complete.