> ## Documentation Index
> Fetch the complete documentation index at: https://docs.movoice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Build and deploy your first Voice AI agent in 5 minutes.

# 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](https://app.movoice.ai)
* (Optional) A Twilio or Vobiz account if you want BYOC telephony

***

<Steps>
  <Step title="Create an Agent">
    1. Log in to the [Movoice Dashboard](https://app.movoice.ai).
    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").
  </Step>

  <Step title="Write Your Agent Prompt">
    The prompt is the system instruction that controls your agent's behavior. Write it clearly:

    ```text theme={null}
    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.
    ```

    <Tip>
      See the [Prompting Guide](/guides/prompting) for best practices on writing effective prompts for Indian callers.
    </Tip>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Note>
      If responses feel slow, switch to Gemini Flash or a Sarvam AI voice — both are optimized for Indian server routing.
    </Note>
  </Step>

  <Step title="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/Vobiz account.
    3. Under **Assign Agent**, select the agent you just created.
  </Step>

  <Step title="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:

    ```bash theme={null}
    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"
        }
      }'
    ```
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Inbound Call Setup" icon="phone-incoming" href="/guides/inbound-setup">
    Configure phone numbers and routing for inbound calls.
  </Card>

  <Card title="Outbound Calls" icon="phone-outgoing" href="/guides/outbound-calls">
    Trigger calls via API and send bulk campaigns.
  </Card>

  <Card title="Prompting Guide" icon="pencil" href="/guides/prompting">
    Write better prompts for Indian callers.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks">
    Get notified in real-time when calls complete.
  </Card>
</CardGroup>