Quickstart

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:

Create an agent
Make a test call
Embed the widget on your site

Prerequisites — You need an Orova account and an API key.

1. Create an agent

Dashboard
API

Go to Agents

In the Orova dashboard, navigate to Agents in the sidebar.

Create a new agent

Click Create Agent and give it a name.

Add a system prompt

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.

Configure providers

Choose your LLM, TTS, and STT providers. Defaults work great to start:

LLM: OpenAI GPT-4o-mini
TTS: ElevenLabs
STT: Deepgram

Set a first message

Add a greeting like: “Hi there! Thanks for calling Acme Corp. How can I help you today?“

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?"
  }'

2. Make a test call

Web Call (Browser)
Phone Call

The fastest way to test. In the agent detail page, click Talk to Agent to start a WebRTC call directly in your browser.

Add a phone number

Go to Phone Numbers → search and buy a Twilio number, or import your own.

Assign to agent

Assign the phone number to your agent with inbound or outbound mode.

Call it

For inbound: call the number from your phone. Your agent answers automatically.For outbound via API:

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"
  }'

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

<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.

See Widget Configuration for all customization options including themes, colors, and positioning.

Next steps

Agent Configuration

Fine-tune LLM, TTS, and STT providers

Integrations

Connect HubSpot, Salesforce, Slack, and more

Phone Numbers

Set up inbound and outbound calling

API Reference

Full REST API documentation

Get Started

Agents

Calls

Widget

Brain (Knowledge Base)

Tools

Integrations

Phone Numbers

Contacts

Overview

1. Create an agent

2. Make a test call

3. Embed the widget

Next steps

Agent Configuration

Integrations

Phone Numbers

API Reference

Get Started

Agents

Calls

Widget

Brain (Knowledge Base)

Tools

Integrations

Phone Numbers

Contacts

Documentation Index

​Overview

​1. Create an agent

​2. Make a test call

​3. Embed the widget

​Next steps

Agent Configuration

Integrations

Phone Numbers

API Reference

Overview

1. Create an agent

2. Make a test call

3. Embed the widget

Next steps