Build AI Support Into Your Product

Full REST API with 6 endpoint domains — messages, conversations, knowledge, settings, analytics, and webhooks. Streaming, structured errors, and pagination included.

Get your API key and send your first message in under 5 minutes.

Get API Key

29endpoints

6API domains

10webhook events

Developer API v1 surface. API key management is via the dashboard.

Send a message in 5 lines of code

const response = await fetch('https://api.rovixal.com/v1/messages', {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'How do I reset my password?'
  })
});

// Response: { data: { conversationId, message, source } }
// For streaming: POST to /v1/messages/stream (SSE)

One API, Six Domains

29 endpoints covering every aspect of your AI support system — from sending messages to configuring behavior programmatically.

2 endpoints

Messages

Send messages and receive AI responses. Stream via Server-Sent Events.

3 endpoints

Conversations

List, retrieve, and export conversations (JSON/CSV). Pagination and date filtering.

5 endpoints

Knowledge

List sources, inspect pages and chunks, trigger syncs, enable or disable sources.

5 endpoints

Settings

Control tone, response style, fallback behavior, confidence threshold, and widget appearance.

7 endpoints

Analytics

Dashboard, conversation trends, top questions, feedback, usage, and trust score.

7 endpoints

Webhooks

CRUD subscriptions, test delivery, inspect delivery logs, and retries.

Configure Everything Programmatically

The Settings API lets you control your chatbot's behavior and appearance without touching the dashboard.

Tone and response style (Professional, Friendly, Casual, Concise)
Fallback behavior (Try Anyway, Ask Clarify, Suggest Topics, Escalate)
Confidence threshold and citation style (None, Inline, Footer)
Widget appearance (colors, position, messaging)

PATCH /v1/settings/chat

{
  "tone": "FRIENDLY",
  "responseStyle": "CONCISE",
  "fallbackBehavior": "SUGGEST_TOPICS",
  "confidenceThreshold": 0.75,
  "conversationStarters": [
    "How do I get started?",
    "What's new this month?"
  ]
}

Webhook Events

Subscribe to real-time events and build integrations with your existing tools and workflows.

Delivery audit trail

Test events for debugging

Exponential backoff retries

conversation.startedFired when a new conversation begins

message.receivedFired when a user sends a message

message.sentFired when the bot responds

escalation.triggeredFired when a conversation is escalated to human

feedback.receivedFired when a user gives thumbs up/down

knowledge.syncedFired when knowledge sources finish syncing

conversation.endedFired when a conversation is closed

agent.joinedFired when a live agent joins a conversation

agent.message.sentFired when a live agent sends a message

handoff.resolvedFired when a live chat handoff is resolved

Built for Production

Structured errors, pagination, and date filtering — everything you need to build reliable integrations.

Structured Errors

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests.",
    "status": 429,
    "timestamp": "2025-06-15T09:23:41.000Z"
  }
}

Every error returns a machine-readable code, human message, HTTP status, and timestamp.

Pagination

{
  "data": [...],
  "meta": {
    "total": 142,
    "page": 2,
    "pageSize": 20
  }
}

List endpoints support pagination with configurable page size up to 100.

Date Filtering

GET /v1/analytics/top-questions
  ?startDate=2025-01-01
  &endDate=2025-01-31
  &limit=10

Filter conversations, analytics, and feedback by date range.

Production-ready from day one

IP-based rate limiting per endpoint

7 analytics endpoints with date filtering

Webhook retry with exponential backoff

Versioned API (v1)

Structured error responses with error codes

API key auth with immediate key deletion

Conversation export to JSON and CSV

Webhook test events and delivery logs

Knowledge gap analytics endpoints

Start building with the Rovixal API.

Get your API key in minutes. 29 endpoints across messages, conversations, knowledge, settings, analytics, and webhooks.

Get API Key Book a Demo

Free plan includes confidence-guided responses, Adversarial Testing, and Knowledge Gap Tracking.