Build on Top of Oravio

Quick Start

Get your first API call working in under 5 minutes. You'll need an API key from your Oravio dashboard under Settings → Developer → API Keys.

# List recent conversations
curl https://api.oravio.in/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "conv_01HXYZ123",
      "contact_phone": "+919876543210",
      "status": "active",
      "last_message": "Bhai, aapka salon Sunday ko open hai-,
      "last_message_at": "2026-05-10T08:23:41Z",
      "ai_handled": true
    }
  ],
  "meta": { "total": 248, "page": 1, "per_page": 20 }
}

Authentication

Oravio uses Bearer token authentication. Pass your API key in the Authorization header of every request.

Authorization: Bearer orv_live_xxxxxxxxxxxxxxxxxxxx

API Key Types

Base URL & Versioning

https://api.oravio.in/v1

The current API version is v1. We follow semantic versioning - breaking changes result in a new major version (v2), and old versions are supported for a minimum of 12 months after deprecation notice.

Request Format

Errors & Status Codes

Oravio uses standard HTTP status codes. All error responses include a JSON body with a machine-readable code and a human-readable message.

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key. Check your Authorization header."
  }
}

Messages

Send messages to any contact using your connected WhatsApp number. Supports text, templates, and media.

Request Body

curl -X POST https://api.oravio.in/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "type": "text",
    "text": "Namaste! Aapki appointment kal 3 baje confirm ho gayi hai. ✅"
  }'

Webhooks

Oravio sends POST requests to your webhook URL whenever a key event happens - new message received, lead captured, booking created, or human escalation triggered.

Webhook Events

{
  "event": "lead.captured",
  "timestamp": "2026-05-10T08:41:12Z",
  "data": {
    "lead_id": "lead_01HXYZ789",
    "name": "Rahul Verma",
    "phone": "+919876543210",
    "source": "whatsapp",
    "intent": "appointment_booking",
    "conversation_id": "conv_01HXYZ123"
  }
}

SDKs & Libraries

Official SDKs wrap the REST API with idiomatic interfaces. Community libraries are listed below - they are not officially maintained.

Rate Limits

Rate limits are applied per API key. When exceeded, requests return 429 Too Many Requests. Use the response headers to track your current usage.

Rate Limit Headers

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 287
X-RateLimit-Reset: 1715334600

Changelog