Вебхук — это HTTPS-запрос, который шлюз отправляет на ваш эндпоинт при событии: доставке или ошибке сообщения, входящем ответе либо низком балансе; отдельно запрашивать статус не нужно.
Вместо постоянного опроса API вы регистрируете эндпоинт и получаете событие при изменении статуса. Событие содержит идентификатор, тип, время и данные; подпись позволяет проверить источник, а при отсутствии ответа шлюз повторяет доставку.
Рабочий обработчик сначала проверяет подпись, быстро отвечает успешным статусом, затем обрабатывает событие через очередь, устраняет дубли по идентификатору и учитывает время события: из-за повторных попыток одно событие может прийти несколько раз и не по порядку.
В SMSMeteor: события подписываются HMAC-SHA256 в заголовке X-Meteor-Signature, предусмотрено 6 попыток в течение 24 часов повторных попыток и ручной повтор из панели. Подробнее — на странице вебхуков.
Связанные термины
- HMAC-подпись вебхуков
- Отчёт о доставке (DLR)
- Экспоненциальная задержка повторных запросов
- Идентификатор запроса