Сначала откройте Вебхуки в личном кабинете: у каждой доставки виден HTTP-ответ или ошибка, которую мы получили. Чаще всего проблема — один из случаев ниже.
Ничего не отправляется
У проекта нет URL вебхука. Добавьте его в настройках проекта: мы отправляем только на адрес, сохранённый в проекте.
Доставки не проходят
- Адрес не публичный или без https. Обычный http, локальные адреса и частные сети не принимаются.
- Редиректы. Мы по ним не переходим. Укажите конечный адрес — с правильным www и слешем в конце.
- Блокирует файрвол или защита от ботов. Пропускайте наши POST-запросы на этот путь.
- Неверный ответ. Засчитывается только статус 2xx. Отвечайте за несколько секунд, а медленную работу делайте после.
- Падает ваш код. Посмотрите лог ошибок сервера на момент неудачной доставки.
Подпись не совпадает
- Используйте секрет подписи вебхуков, а не секрет API.
- Считайте подпись по сырому телу запроса ровно в том виде, в каком оно пришло, до любого разбора.
- После создания нового секрета вебхуков обновите его на сервере.
Повторы и уведомления
Неудачные доставки повторяются около двух дней. После трёх неудач подряд по боевым событиям владелец проекта получает одно письмо; уведомление снова включается после следующей успешной доставки.
Исправили?
Нажмите Повторить у неудачных доставок в разделе Вебхуки или Отправить test.ping на странице проекта, чтобы проверить эндпоинт. Не получается? Напишите нам через страницу контактов и укажите ID доставки.