Вебхук не доставляет данные: как найти причину и починить

Интеграция с внешней системой настроена, но данные не приходят. Замерщик создал заявку, а в учётной программе её нет. Владелец просит разобраться, в чём дело. Открываете раздел интеграций — и видите только переключатель «Использовать webhook». Где смотреть ошибки и как проверить, что отправка вообще работает?

Где искать причину

В Komplekt.com есть отдельный экран для системного администратора — сводка по вебхукам. Там видно очередь событий, ошибки доставки и конфигурации. Чтобы открыть его, нужен доступ с правами администратора.

На экране три блока: процессор, очередь и компании. Если процессор не работает, события копятся и не отправляются. Если в очереди есть ошибки — смотрим, какие именно.

Проверяем очередь и повторяем отправку

Очередь показывает события, которые программа пыталась отправить. У каждого события есть статус. Если статус «Ошибка» — доставка не удалась.

Что делать:

• Откройте очередь и найдите события с ошибкой.
• Посмотрите описание ошибки — там будет причина: неверный адрес, недоступен сервер, неверный формат данных.
• Исправьте причину на стороне принимающей системы.
• Вернитесь в Komplekt.com и повторите отправку конкретного события.

Если ошибок много, можно повторить отправку всех проваленных событий разом.

Тестируем вебхук

Чтобы убедиться, что интеграция работает, отправьте тестовый запрос. Это делается из раздела конфигураций вебхуков.

Выберите нужный вебхук и запустите тестовую отправку. Если принимающая сторона получила запрос — проблема была в конкретных событиях. Если нет — проверьте настройки: адрес, ключи, доступность сервера.

Что в итоге

Вы видите очередь вебхуков, находите ошибки доставки и повторяете отправку. Тестовый запрос подтверждает, что интеграция работает. Данные снова поступают в учётную систему без сбоев.