Chatbot API Documentation

Build and integrate AI chatbots into your applications

REST API
v1.0

Quick Start

Get your API key from the dashboard and make your first request

Rate Limits

50 requests per minute per API key

Base URL

https://dashboard.omnia-voice.com/api/v1

Authentication

All API requests require an API key to be passed in the X-API-Key header

X-API-Key: your_api_key_here

List Chatbots

GET
/chatbots

Retrieve all chatbots for your account

cURL
curl -X GET https://dashboard.omnia-voice.com/api/v1/chatbots \
  -H "X-API-Key: your_api_key_here"
Python
import requests

api_key = "your_api_key_here"
url = "https://dashboard.omnia-voice.com/api/v1/chatbots"

headers = {
    "X-API-Key": api_key
}

response = requests.get(url, headers=headers)
chatbots = response.json()
print(chatbots)
Node.js
const apiKey = 'your_api_key_here';

fetch('https://dashboard.omnia-voice.com/api/v1/chatbots', {
  headers: {
    'X-API-Key': apiKey
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Send Chat Message

POST
/chatbots/{id}/chat

Send a message to your chatbot and get an AI response

cURL Example
curl -X POST https://dashboard.omnia-voice.com/api/v1/chatbots/{id}/chat \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is your return policy?",
    "conversationId": "optional-conversation-id"
  }'

Available Endpoints

Complete list of chatbot API endpoints

GET
/chatbots
List all chatbots
POST
/chatbots
Create a new chatbot
GET
/chatbots/{id}
Get chatbot details
PATCH
/chatbots/{id}
Update chatbot
DELETE
/chatbots/{id}
Delete chatbot
POST
/chatbots/{id}/chat
Send chat message
GET
/chatbots/{id}/sources
List knowledge sources
POST
/chatbots/{id}/sources
Add knowledge source
GET
/chatbots/{id}/analytics
Get analytics data
GET
/chatbots/{id}/conversations
List conversations