API Mabel для бизнеса

Версия 1. Подключите Mabel к сайту, CRM или приложению бизнеса.

Начало

На сайте управления, в разделе «API для разработчиков», создайте ключ и отметьте его права. Ключ начинается сmabel_ и показывается только один раз. Отправляйте его в каждом запросе:

Authorization: Bearer mabel_...

Ключ принадлежит вашему серверу, а не браузеру. Для чата на сайте используйте строку чата с сайта управления — ей ключ не нужен.

Права

ПравоЧто оно позволяет
askЗадать Mabel вопрос клиента, и она ответит на основе знаний бизнеса
leadsЧитать лиды и добавлять лид
appointmentsЧитать записи, которые сделала Mabel
actionsСпросить, разрешено ли действие по правилам бизнеса, и проверить, одобрил ли менеджер
summaryПолучить сводку за последние 24 часа

Маршруты

POST /api/v1/ask

Вопрос клиента. Можно отправить question один, или messages с разговором до этого момента.

curl -X POST https://YOUR-SERVER/api/v1/ask \
  -H "Authorization: Bearer mabel_..." \
  -d '{"question": "Какие у вас часы работы?"}'

{ "reply": "С воскресенья по четверг, с 8:00 до 19:00...", "actions": [] }

GET /api/v1/leads

До 200 последних лидов, от новых к старым.

{ "leads": [ { "id": "aB3x", "at": "2026-10-06T07:40:00Z", "name": "Дана", "phone": "0501234567", "need": "окрашивание", "channel": "phone", "consent": true, "called": null, "handled": null } ] }

POST /api/v1/leads

Добавляет лид. Нужно name или phone. Поле consent ставьте true только если клиент действительно согласился, чтобы ему перезвонили.

{ "name": "Дана", "phone": "0501234567", "need": "окрашивание волос", "consent": true }

GET /api/v1/appointments

{ "appointments": [ { "id": "Q9s1", "name": "Яэль", "phone": "0521112222", "when": "завтра в 10:00", "reason": "чистка зубного камня", "channel": "phone", "status": "confirmed" } ] }

POST /api/v1/actions/check

Прежде чем ваша система сделает что-то от имени бизнеса, она спрашивает Mabel. Ответ — allowed, needs_approval (с requestId) или blocked. Расход денег никогда не allowed.

{ "action": "give_discount", "detail": "10% постоянному клиенту" } { "decision": "needs_approval", "requestId": "k2Jd81xQ" }

POST /api/v1/actions/status

{ "requestId": "k2Jd81xQ" } { "status": "approved", "by": "Михаль" }

GET /api/v1/summary

{ "text": "За последние 24 часа было 3 обращения клиентов...", "counts": { "asks": 3, "leads": 2, ... } }

Уведомления (webhooks)

На сайте управления добавьте адрес https и выберите события. Mabel отправляет POST на каждое событие и не ждёт ответа.

СобытиеКогда
lead.createdПришёл новый лид (телефон, сайт, API или вручную)
appointment.confirmedMabel записала на приём
request.pendingДействие ждёт одобрения менеджера
request.decidedМенеджер одобрил или отклонил
POST https://your-system/hook x-mabel-signature: 5f2c... (HMAC-SHA256 тела запроса, с секретом, который вы получили) { "event": "lead.created", "at": "2026-10-06T07:40:00Z", "company": "Клиника «Улыбка»", "data": { "id": "aB3x", "name": "Дана", "phone": "0501234567", "need": "отбеливание", "channel": "phone", "consent": true } }

Проверка подписи в Node:

const ok = crypto.createHmac('sha256', SECRET).update(rawBody).digest('hex') === req.headers['x-mabel-signature'];

Пример: агент ElevenLabs, который спрашивает разрешения у Mabel

Голосовой агент ElevenLabs может работать по правилам бизнеса: прежде чем дать скидку или что-то назначить, он спрашивает Mabel. В ElevenLabs добавьте агенту инструмент типа Webhook:

ПолеЗначение
Nameask_mabel_permission
Method · URLPOST https://YOUR-SERVER/api/v1/actions/check
HeadersAuthorization: Bearer mabel_... (как Secret в ElevenLabs, с ключом, у которого есть только право actions)
Body parametersaction (например give_discount), detail

И в инструкциях агента: «Перед скидкой или обязательством клиенту вызови ask_mabel_permission. Если ответ needs_approval, скажи клиенту, что команда подтвердит и свяжется с ним. Если blocked, не делай этого». Так все агенты бизнеса работают по одним правилам, а каждый запрос записывается в журнал Mabel.

Ошибки и ограничения

КодКогда
401Нет ключа, или он отозван
403У ключа нет права на этот маршрут
429Больше 60 запросов в минуту на один ключ
400Неверный запрос. Причина в поле error

Каждое действие через API записывается в журнал действий бизнеса от имени ключа.