API уведомлений для заказов и оплат
Когда продукту нужно отправить пользователю понятное сервисное сообщение, лучше не строить отдельный контур. Один API-запрос, один webhook и одна модель статусов закрывают базовый запуск.
Бесплатный старт без карты: можно проверить реальный сценарий до оплаты.
Сценарий: статус заказа ушел пользователю автоматически
Ваш backend меняет статус заказа на «передан в доставку», Relaya ставит уведомление в очередь, отправляет его через MAX и возвращает событие со статусом.
Событие в продукте
После оплаты, сборки или передачи заказа в доставку backend создает одно уведомление.
Отправка через API
Relaya принимает запрос, валидирует payload и отправляет сообщение через подключенный MAX-профиль.
Webhook и статус
Ваш сервис получает результат и может обновить таймлайн заказа без ручных проверок.
Нужный минимум для запуска без обвязки вручную
MAX для уведомлений
MAX выступает первым каналом для уведомлений, когда важен быстрый запуск и локальный пользовательский путь.
Webhook
События по доставке и ошибкам приходят обратно в систему и не теряются в ручной перепроверке.
Очередь и retry
Пики нагрузки и временные ошибки не ломают отправку: уведомления остаются в очереди и повторяются штатно.
Статусы доставки
Можно одинаково работать со статусами отправлено, в очереди, ошибка и доставлено.
SDK
Сценарий одинаково доступен через curl и через SDK на Node.js, Python или PHP.
Пример запроса для уведомления о доставке
Этот запрос подходит для первого рабочего сценария: уведомить клиента, что заказ уже передан в доставку.
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": "Заказ #4312 передан в доставку. Курьер свяжется с вами перед приездом."
}'Если этот сценарий проходит стабильно, дальше можно наращивать шаблоны, очереди и дополнительные каналы без смены базовой схемы.