Всё, что стоит знать, и ничего лишнего.
Какие мероприятия она проводит
Два наиболее распространенных типа сообщений — это уведомления о доставке (DLR), которые сообщают, дошло ли каждое сообщение до устройства и почему произошла ошибка, и входящие сообщения, которые позволяют создавать двусторонние потоки и обрабатывать STOP-сообщения. См. /answers/what-is-dlr и /answers/what-is-mo-vs-mt.
Почему метод «push» лучше, чем метод «pollify»?
Опрос API для получения статуса приводит к нерациональному использованию запросов и увеличению задержки; веб-хук доставляет событие в момент его возникновения, поэтому ваши повторные попытки ввода одноразового пароля, поддержка маршрутизации и аналитика реагируют в режиме реального времени. См. /developers/webhooks.
Проверьте и защитите его.
Поскольку любой может отправить POST-запрос на общедоступный URL-адрес, подписать полезные данные веб-перехватчика (например, с помощью HMAC-SHA256) и проверить подпись, прежде чем доверять событию, и всегда предоставлять доступ к конечной точке по протоколу HTTPS. См. /answers/hmac-sha256-dlr-signing и /tools/webhook-signature-validator.
Сделайте его устойчивым
Возвращайте быстрый код 2xx и обрабатывайте асинхронно, ожидайте повторных попыток и случайных дубликатов (поэтому обрабатывайте события идемпотентно), и отслеживайте сбои, чтобы никогда незаметно не пропустить событие доставки. См. /developers/webhooks.