Berlay Documentation

Guides, API references, and integration recipes for building on top of the Berlay platform.

Get startedAPI reference

Available now

Quick Start

Get your first conversation into Berlay in under five minutes.

Get started

Custom Webhooks

Push events from any app into Berlay using a simple API key and HTTP endpoint.

Read guide

REST API v1

Full reference for conversations, messages, contacts, ratings, and API key management.

View reference

AI & LLM

Machine-readable markdown exports and llms.txt index for every docs section.

llms.txt

Push a message in 30 seconds

No OAuth. No SDK. One HTTP request from any language.

Full guide →
http
POST https://api.berlay.app/api/webhooks/custom/{channelId}
Content-Type: application/json
x-berlay-api-key: brly_your_key_here

{
  "messageId":      "msg_001",
  "conversationId": "session_abc",
  "from":           { "externalId": "user_42", "name": "Jane Smith" },
  "content":        "Hi, I need help with my order."
}

Coming soon

More guides on the way

Helpdesk & Ticketing

Ticket queues, SLAs, and escalation rules.

Knowledge Base

Articles, categories, and SEO publishing.

AI Agent

Training, tone, and response configuration.

Alerting & Automations

Trigger-based rules and routing logic.

Channel integrations

Crisp, email, Slack, and more.

Analytics

Metrics, agent performance, and CSAT.

Team & permissions

Roles, invites, and org management.

Workspace concepts

Orgs, billing accounts, and workspace types.

Berlay · 2026

berlay.ioDashboardllms.txtGitHub