Блокировка вебхуков МоимСкладом при некорректном ответе

При работе с МойСклад иногда могут приходить уведомления следующего вида:

Ваш аккаунт ***** использует вебхуки.

Проверьте самостоятельно или убедитесь вместе с разработчиком, что вы настроили получение вебхуков согласно документации и отправляете ответ с кодом 200 или 204 в течение 1500 миллисекунд.

Вебхуки для проверки: [идентификаторы_вебухуков]

Что это означает?

Данное уведомление говорит о том, что один из вебхуков, зарегистрированных в аккаунте МойСклад, перестал корректно отвечать на запросы.

Важно: этот вебхук может быть не связан с модулем синхронизации.

Что нужно проверить?

В уведомлении указывается идентификатор проблемного вебхука. С помощью интерфейса модуля обмена вы можете найти этот вебхук и проверить ссылку, на которую он отправляет запросы.

Информацию обо всех вебхуках, используемых в аккаунте МойСклад, можно получить в административной части модуля. Для этого перейдите в раздел «Вебхуки и агенты», на вкладку «Менеджер вебхуков» и нажмите кнопку «Загрузить все вебхуки»:

После нажатия кнопки в этом же окне ниже отобразится список всех вебхуков, зарегистрированных в учетной записи. С помощью поиска по странице в браузере вы можете найти вебхук по его идентификатору и посмотреть, какая ссылка для него используется.

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

1. Ссылка ведёт на другой домен Ссылка вебхука не соответствует текущему домену сайта, на котором установлен модуль.

В этом случае необходимо:

• проверить, доступен ли сайт по указанному домену;
• убедиться, что он корректно обрабатывает запросы и возвращает статус 200 или 204.

Также возможно, что данный вебхук вообще не связан с модулем синхронизации.

2. Ссылка ведёт на текущий домен, но не относится к модулю Вебхук указывает на текущий сайт, но не используется модулем синхронизации.

В таком случае рекомендуется:

• определить, какой скрипт обрабатывает данный вебхук;
• обратиться к разработчику или системе, которая его использует;
• проверить, почему он возвращает некорректный ответ.

3. Ссылка используется модуль, но сайт был временно недоступен

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

МойСклад отправляет такие уведомления, если в течение нескольких попыток не получает корректный ответ (200 или 204). Причиной могут быть:

• временные сбои сайта;
• проблемы с хостингом;
• недоступность сервера в момент обращения.

В этом случае рекомендуется проверить доступность сайта и логи сервера за соответствующий период.

Важно учитывать, что обработка вебхуков в модуле, как правило, занимает минимальное время. Даже при возникновении ошибок в процессе обработки модуль всё равно возвращает корректный HTTP-ответ (200).

Если используется обработка вебхуков через очередь, то при получении запроса от МойСклад модуль лишь сохраняет информацию о запросе в базу данных, без выполнения дополнительной логики в момент обращения.

Благодаря этому обработка выполняется максимально быстро, и в таких случаях также всегда возвращается корректный ответ 200.