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.confirmed | Mabel записала на приём |
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:
| Поле | Значение |
|---|---|
| Name | ask_mabel_permission |
| Method · URL | POST https://YOUR-SERVER/api/v1/actions/check |
| Headers | Authorization: Bearer mabel_... (как Secret в ElevenLabs, с ключом, у которого есть только право actions) |
| Body parameters | action (например give_discount), detail |
И в инструкциях агента: «Перед скидкой или обязательством клиенту вызови ask_mabel_permission. Если ответ needs_approval, скажи клиенту, что команда подтвердит и свяжется с ним. Если blocked, не делай этого». Так все агенты бизнеса работают по одним правилам, а каждый запрос записывается в журнал Mabel.
Ошибки и ограничения
| Код | Когда |
|---|---|
401 | Нет ключа, или он отозван |
403 | У ключа нет права на этот маршрут |
429 | Больше 60 запросов в минуту на один ключ |
400 | Неверный запрос. Причина в поле error |
Каждое действие через API записывается в журнал действий бизнеса от имени ключа.