Вебхуки

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

Что такое вебхуки?

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

Вебхуки используются для интеграции сайта со сторонними сервисами и API.

Вебхуки в WooCommerce

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

Важно: поддержка не распространяется на кастомные доработки. Для сложных изменений лучше обратиться к разработчику.

Также можно использовать вебхуки вместе с экшенами WooCommerce. Например, создать вебхук, который будет срабатывать при добавлении товара в корзину, используя экшен woocommerce_add_to_cart.

Вебхуки позволяют интегрировать WooCommerce со сторонними приложениями.

Создание вебхуков

Чтобы создать новый вебхук:

1. Перейдите в WooCommerce → Настройки → Дополнительно → Вебхуки.
2. Нажмите Добавить вебхук. Откроется форма Данные вебхука.

3. Заполните поля:
   • Название — описание вебхука. Если оставить пустым, будет создано автоматически, но его можно изменить позже.
   • Статус —
     • Активен — вебхук работает
     • Приостановлен — временно не работает
     • Отключен — отключён из-за ошибок
   • Тема — определяет событие, при котором срабатывает вебхук (заказы, товары, купоны, клиенты или Действие). Список зависит от установленных плагинов.
   • Пользовательская тема — только для продвинутых пользователей. Можно добавить свои события через фильтр woocommerce_webhook_topic_hooks.
   • Событие действия — появляется, если выбрано Действие. Позволяет указать конкретный экшен (например woocommerce_add_to_cart).
   • URL доставки — адрес, на который отправляются данные вебхука.
   • Секрет — ключ для подписи запроса. По умолчанию используется секрет API текущего пользователя.
4. Нажмите Сохранить вебхук.

Примечание: при первом сохранении активного вебхука отправляется тестовый запрос (ping) на указанный URL.

WooCommerce автоматически отключит вебхук, если произойдёт более 5 подряд неудачных попыток доставки. Ошибка — это любой ответ, кроме 2xx, 301 или 302 (например, коды 4xx или 5xx).

Изменить лимит ошибок можно через фильтр woocommerce_max_webhook_delivery_failures.

Редактирование и удаление вебхуков

Вебхуки отображаются в списке, как записи или товары.

1. Найдите нужный вебхук.
2. Наведите курсор на название — появятся опции ID, Изменить и Удалить навсегда.
3. Выберите нужное действие или используйте массовые операции (Массовые действия).

Логи вебхуков

WooCommerce сохраняет логи всех срабатываний вебхуков. Они находятся в WooCommerce → Состояние → Логи.

Если логов много, выберите источник webhooks-delivery в списке «Все источники», чтобы отфильтровать записи. Также можно воспользоваться поиском.

Логи помогают посмотреть отправку данных и ответы сервера, что упрощает интеграцию и отладку.