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