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

# Quickstart

> Create your first AI agent and make a call in 5 minutes

## Overview

Create a voice agent with a simple prompt, attach a phone number, and make your first call. You'll also learn how to embed the widget on your website.

In this quickstart, you'll:

1. Create an agent
2. Make a test call
3. Embed the widget on your site

<Info>
  **Prerequisites** — You need an [Orova account](https://app.orova.ai) and an API key.
</Info>

## 1. Create an agent

<Tabs>
  <Tab title="Dashboard">
    <Steps>
      <Step title="Go to Agents">
        In the Orova dashboard, navigate to **Agents** in the sidebar.
      </Step>

      <Step title="Create a new agent">
        Click **Create Agent** and give it a name.
      </Step>

      <Step title="Add a system prompt">
        ```text theme={null}
        You are a friendly phone support assistant for Acme Corp.
        Greet the caller and offer help. Keep responses under 30 words.
        If a transfer is requested, confirm the reason first.
        ```
      </Step>

      <Step title="Configure providers">
        Choose your LLM, TTS, and STT providers. Defaults work great to start:

        * **LLM**: OpenAI GPT-4o-mini
        * **TTS**: ElevenLabs
        * **STT**: Deepgram
      </Step>

      <Step title="Set a first message">
        Add a greeting like: *"Hi there! Thanks for calling Acme Corp. How can I help you today?"*
      </Step>
    </Steps>
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://app.orova.ai/api/agents \
      -H "x-api-key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Support Agent",
        "llm_provider": "openai",
        "llm_model": "gpt-4o-mini",
        "tts_provider": "elevenlabs",
        "stt_provider": "deepgram",
        "system_prompt": "You are a friendly phone support assistant.",
        "first_message": "Hi there! How can I help you today?"
      }'
    ```
  </Tab>
</Tabs>

## 2. Make a test call

<Tabs>
  <Tab title="Web Call (Browser)">
    The fastest way to test. In the agent detail page, click **Talk to Agent** to start a WebRTC call directly in your browser.
  </Tab>

  <Tab title="Phone Call">
    <Steps>
      <Step title="Add a phone number">
        Go to **Phone Numbers** → search and buy a Twilio number, or import your own.
      </Step>

      <Step title="Assign to agent">
        Assign the phone number to your agent with **inbound** or **outbound** mode.
      </Step>

      <Step title="Call it">
        For inbound: call the number from your phone. Your agent answers automatically.

        For outbound via API:

        ```bash theme={null}
        curl -X POST https://app.orova.ai/api/optimus/phone-call \
          -H "x-api-key: YOUR_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "assistantId": "AGENT_ID",
            "phoneNumber": "+1234567890",
            "phoneNumberId": "PHONE_NUMBER_ID"
          }'
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 3. Embed the widget

Add the Orova widget to any website with a single script tag:

```html theme={null}
<script
  src="https://app.orova.ai/widget/orova-widget.js"
  data-api-key="YOUR_API_KEY"
  data-agent-id="AGENT_ID"
  data-server-url="https://app.orova.ai"
  data-mode="voice"
  data-title="Acme Support"
></script>
```

That's it. A floating button appears on your site. Users can chat, call, or video call your agent.

<Tip>
  See [Widget Configuration](/widget/configuration) for all customization options including themes, colors, and positioning.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Agent Configuration" icon="sliders" href="/agents/configuration">
    Fine-tune LLM, TTS, and STT providers
  </Card>

  <Card title="Integrations" icon="plug" href="/integrations/overview">
    Connect HubSpot, Salesforce, Slack, and more
  </Card>

  <Card title="Phone Numbers" icon="phone" href="/phone-numbers/overview">
    Set up inbound and outbound calling
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/overview">
    Full REST API documentation
  </Card>
</CardGroup>