API & Webhooks

orain.ai Dashboard

Build. Connect. Automate. In real time.

A powerful API for full control over your AI agents

The orain.ai API gives you complete programmatic access to your AI agents, conversations, and knowledge. Create, configure, and control agents dynamically — trigger actions, ingest data, or connect external systems without limitations. Built for developers who need flexibility, speed, and reliability in production environments.

Build. Connect. Automate. In real time.

Real-time events with Webhooks — no polling required

Webhooks notify your systems instantly when something happens inside your AI agents. Instead of polling APIs, events are pushed to your infrastructure in real time — enabling immediate reactions, automations, and human handoffs. Perfect for CRM sync, monitoring, analytics, and custom workflows.

Build. Connect. Automate. In real time.

Secure by design — built for enterprise workflows

All API and webhook communication is secured using modern authentication and HMAC-based signature verification. Each webhook delivery is signed, timestamped, and uniquely identifiable — enabling secure validation, replay protection, and idempotent processing. Your integrations remain reliable, auditable, and production-safe.

Everything you need to integrate AI into your systems

001.

Full REST API Access

Manage chatbots, conversations, sessions, and knowledge programmatically.

002.

Real-Time Webhook Events

Receive instant notifications for conversation, message, knowledge, and handoff events.

003.

Conversation Lifecycle Events

All API and webhook communication is secured using modern authentication and HMAC-based signature verification. Each webhook delivery is signed, timestamped, and uniquely identifiable — enabling secure validation, replay protection, and idempotent processing. Your integrations remain reliable, auditable, and production-safe.

004.

Human Handoff Events

Trigger workflows when users request a human or when escalation is detected automatically.

005.

Knowledge Base Events

React instantly when documents or URLs are added or removed from the knowledge base.

006.

Secure Signature Verification

Every webhook is signed using HMAC-SHA256 to ensure authenticity and integrity.

007.

Event Idempotency & Delivery Tracking

Use event IDs and delivery IDs to safely handle retries and duplicate events.

008.

Fast, Reliable Delivery

Webhooks are delivered over HTTPS with timeout handling and delivery logs for monitoring.

009.

EU-Based, GDPR-Compliant Infrastructure

All API and webhook data is processed and stored securely within the EU.

Three steps to real-time AI integration

001.

Create API keys and webhook endpoints

Generate credentials and configure secure endpoints in your infrastructure.

002.

Choose what matters

Select the events you want to receive — conversations, messages, knowledge updates, or handoffs.

003.

React instantly

Trigger workflows, route conversations, sync data, or notify teams the moment events occur.

Frequently Asked Questions

What events can I receive via webhooks?

Conversation lifecycle events, message events, knowledge base updates, and human handoff requests.

Are webhooks delivered securely?

Yes. Every webhook is signed with HMAC-SHA256 and includes timestamps and delivery IDs for verification.

Can I connect multiple systems to the API?

Absolutely. The API is designed to support complex, multi-system integrations.

Do webhooks retry on failure?

Yes. Failed deliveries are logged and retried according to delivery rules visible in the dashboard.

Can I process events asynchronously?

Yes — and it’s recommended. Respond immediately with 200 OK and process events asynchronously to avoid timeouts.

Is the API suitable for enterprise use?

Yes. Authentication, security, rate limits, and auditability are designed for production and enterprise environments.

Build real-time AI integrations without limits.