Messaging API для интеграторов и клиентских проектов
Если вы внедряете коммуникационный контур в клиентский продукт, не нужно тащить отдельные куски под отправку, webhook и статусы. Достаточно поднять один рабочий маршрут и показать клиенту первый живой результат.
Старт без карты: можно быстро показать клиенту рабочий контур до закупки и масштабирования.
Сценарий: интегратор запускает клиенту первое исходящее сообщение
Интегратор подключает MAX-профиль клиента, отправляет тестовое сообщение из backend клиента и принимает webhook со статусом, чтобы доказать работоспособность интеграции.
Поднимаете профиль клиента
Создаете рабочий профиль и подключаете MAX как первый канал, не размазывая старт по нескольким мессенджерам.
Встраиваете один endpoint
Клиентский backend вызывает один POST-запрос на отправку и не пишет отдельный слой вокруг канала вручную.
Отдаете статус обратно
Webhook приходит в систему клиента, а интегратор сразу показывает сквозной результат на демо или пилоте.
Нужный минимум для запуска без обвязки вручную
MAX как первый канал
Удобно стартовать с одного канала, а потом уже подключать Telegram, WhatsApp или VK без пересборки базового процесса.
Webhook
Статусы и входящие события можно сразу прокинуть в CRM, helpdesk или слой интеграции клиента.
Очередь
Если у клиента всплески нагрузки, сообщения не начинают хаотично теряться или дублироваться на ровном месте.
Статусы
Интегратору проще сдавать проект, когда статус отправки и доставки виден в одном формате.
SDK
Можно быстро встроиться в стек клиента через готовые SDK для Node.js, Python и PHP, а не генерировать клиент заново.
Пример запроса для первого клиентского проекта
Минимальный curl, который интегратор может использовать как proof-of-concept перед переносом логики в SDK или production-код.
curl -X POST \
https://api.relaya.ru/v1/profiles/{profileId}/integrations/max/messages \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone": "+79991234567",
"message": "Здравствуйте! Интеграция подключена, уведомления из вашего сервиса уже работают."
}'Дальше этот же маршрут можно завернуть в SDK и встроить в рабочий слой интеграции без изменения самого сценария.