Webhooks
Amobit отправляет message.created в ваш HTTPS-эндпоинт и подписывает тело HMAC-SHA256. Доставка асинхронная, с повторами.
Документация Amobit Chats для разработчиков
Amobit Chats собирает сообщения из мессенджеров и чата на сайте в одном окне и передаёт их вашей системе через webhooks. Ответы возвращаются в тот же диалог по HTTP API. Для AI-клиентов есть отдельный MCP-сервер с ограниченным доступом к диалогам.
HTTP API
Bearer-токен компании открывает отправку текста в существующий диалог. Ключ идемпотентности защищает от дублей при повторах.
MCP-сервер
Токен с ограничением по каналам даёт AI-клиенту поиск диалогов и историю. По умолчанию доступ только на чтение, отправка включается отдельно.
Безопасность и данные
Изоляция компаний, хранение токенов в виде хешей, защита от SSRF, журналы без текстов переписки, резервные копии и порядок раскрытия уязвимостей.
Как устроена интеграция
Внешняя система не получает доступ к базе Amobit Chats. Взаимодействие идёт в две стороны: события наружу, ответы внутрь.
Клиент → WhatsApp / Telegram / MAX / чат на сайте
↓
Amobit Chats (ваша компания)
│
webhook message.created (HTTPS + HMAC)
↓
ваша CRM / ERP / helpdesk
│
POST /api/v1/external-integrations/inbound/messages/
Authorization: Bearer amc_… (текст в существующий диалог)
↓
Amobit Chats → канал связи → клиентНастройка выполняется владельцем или администратором компании в кабинете: Профиль → Интеграции → API / Webhook. Там же выпускается токен и задаётся секрет подписи. Последние доставки возвращает API GET /api/v1/external-integrations/workspaces/{workspace_slug}/deliveries/ — нужна сессия владельца или администратора; в карточке интеграции журнал пока не отображается.
Что доступно сейчас
| Возможность | Статус | Где описано |
|---|---|---|
| Получать события о сообщениях: входящие и исходящие | Доступно | Webhooks |
| Отправлять текст в существующий диалог | Доступно | HTTP API |
| Читать диалоги и историю из AI-клиента | Доступно через MCP | MCP |
| Отправлять медиа через generic API | Не поддерживается | — |
| Начинать новый диалог с незнакомым контактом через публичный API (write-first) | Намеренно недоступно | Пояснение |
| Привязка к amoCRM / Kommo, Битрикс24, PulseCRM, Altegio | Отдельные коннекторы | Кабинет → Интеграции |
Почему нет write-first. Отправка первому лицу без входящего диалога затрагивает лимиты провайдера, согласие и антиспам-правила. Generic API её не делает — это осознанное ограничение, а не забытая функция.
Безопасность коротко
- Только HTTPS: webhook-адрес обязан быть публичным HTTPS без редиректов; localhost и приватные IP отклоняются.
- Подпись
HMAC-SHA256от{timestamp}.{raw_body}и заголовок с ключом идемпотентности в каждом событии. - Токены хранятся как хеши и показываются один раз; замена токена сразу отключает предыдущий.
- Каждый запрос и событие ограничены одной компанией: внешний токен не видит чужие диалоги и каналы.
- Тексты переписки и секреты не попадают в журналы доставки и аудита.
Подробный разбор — на странице «Безопасность и данные». Она написана так, чтобы разработчик клиента мог проверить утверждения по поведению API.
С чего начать
Быстрый старт
Подключите канал, создайте интеграцию, получите токен и проверьте первое событие. Открыть →
Справочник API
Точные поля запроса, коды ответов, идемпотентность и ограничения. Открыть →
Проверка подписи
Готовые примеры на Node.js, PHP и Python для webhook-эндпоинта. Открыть →
Машиночитаемое описание
Контракт отправки сообщений доступен как OpenAPI 3.1 (JSON). Событие вебхука описано в спецификации как webhooks.messageCreated. Описание можно использовать для генерации клиента, моков и проверки схемы.
Нужен пилот или нестандартный сценарий? Напишите на info@amobit.io: обсудим доступ на чтение, лимиты и совместную проверку интеграции.