Channels / API & Webhooks

Build anything with Orqelo's API

Full REST API, webhook event bus, and scope-based API keys. Integrate Orqelo into any product, any workflow, any stack.

REST API

Programmatic access to everything

Send messages, manage conversations, query knowledge bases, and read analytics — all via a standard REST API with JSON responses.

Example — send a message via API

curl -X POST https://api.orqelo.com/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "api",
    "message": "Hello, I need help with my order",
    "visitor_id": "vis_abc123"
  }'

API base URL is a placeholder — the actual endpoint is shown in your dashboard under Settings → API Keys.

Webhooks

Receive events in real time

New message

Fires on every inbound message across all channels. Includes visitor ID, channel, message body, and conversation ID.

conversation.message.created

Human escalation

Fires when the AI escalates a conversation to a human agent. Includes escalation reason and assigned agent ID.

conversation.escalated

Conversation closed

Fires when a conversation is marked resolved by an agent or closed automatically. Includes CSAT score if collected.

conversation.closed

Webhook security

Every webhook payload is signed with HMAC-SHA256 using your webhook secret. Verify the X-Orqelo-Signature header before processing.

API keys

Scope-based access control

API keys are scoped to the minimum permissions you grant. Rotate them anytime from your dashboard.

Starter

Read-only keys

✓ Read conversations and messages
✓ Read analytics data
✗ Write messages or manage settings

Professional+

Full-access keys

✓ Read and write conversations
✓ Manage knowledge base content
✓ Configure webhooks and integrations
✓ Access usage analytics and billing data

Start building today

API keys available on all plans. Full docs in the developer portal.

See docs Start free