Как изменить URL вебхуков WooCommerce без плагинов

Диагностика проблемы: зачем менять URL вебхуков WooCommerce?

WooCommerce по умолчанию создает вебхуки с URL, которые часто включают стандартные пути типа https://site.ru/wc-api/ или https://site.ru/wp-json/wc/v3/. Некоторые задачи требуют изменить эти URL для повышения безопасности, интеграции с нестандартными сервисами или обхода ограничений хостинга. Однако WooCommerce не предоставляет простого интерфейса для редактирования URL вебхуков, а плагины могут утяжелять сайт.

Как WooCommerce обрабатывает URL вебхуков

WooCommerce использует класс WC_Webhook и системные хуки WordPress для регистрации вебхуков и их эндпоинтов. По умолчанию URL формируется на основе hook topic и настроек сайта. Поэтому для изменения URL нужно вмешаться в регистрацию REST API маршрутов, на которые ссылаются вебхуки.

Основные точки входа для изменения URL

• Фильтр woocommerce_webhook_http_url — позволяет изменить конечный URL вебхука перед отправкой.
• Регистрация REST API маршрутов через register_rest_route — можно переопределить стандартный маршрут WooCommerce.

Пошаговое решение: изменение URL вебхуков WooCommerce через код

Мы изменим URL вебхуков, переопределив REST API маршрут и применим фильтр для формирования ссылки.

1. Переопределение REST API маршрута WooCommerce

Добавьте следующий код в файл functions.php вашей темы или в кастомный плагин:

add_action('rest_api_init', function() {
    // Удаляем стандартный маршрут обработки вебхуков
    remove_action('rest_api_init', array(WC()->webhooks, 'register_routes'), 10);

    // Регистрируем новый маршрут с нужным URL
    register_rest_route('custom-wc/v1', '/webhook/(?P<id>\d+)', array(
        'methods'  => 'POST',
        'callback' => array(WC()->webhooks, 'handle_webhook'),
        'permission_callback' => '__return_true',
    ));
}, 9);

В этом примере мы меняем маршрут с wc/v1/webhook/<id> на custom-wc/v1/webhook/<id>. Теперь вебхуки должны отправлять уведомления на новый URL вида https://site.ru/wp-json/custom-wc/v1/webhook/123.

2. Изменение URL вебхука перед отправкой

WooCommerce формирует URL вебхука динамически. Чтобы уведомить внешние сервисы о новом URL, используйте фильтр woocommerce_webhook_http_url:

add_filter('woocommerce_webhook_http_url', function($url, $webhook) {
    // Пример: меняем базовый путь wc-api на custom-webhook
    return str_replace('/wc-api/', '/custom-webhook/', $url);
}, 10, 2);

Этот фильтр подойдет, если вы создаёте вебхуки программно или хотите воздействовать на URL на уровне отправки.

Как проверить, что изменение URL сработало

• Добавьте новый вебхук в WooCommerce (WooCommerce > Настройки > Вебхуки).
• В поле URL укажите новый адрес, например, https://site.ru/wp-json/custom-wc/v1/webhook/123.
• Отправьте тестовое уведомление через интерфейс WooCommerce.
• Проверьте логи сервера и ответ вебхука — должен приходить статус 200.
• Проверьте в браузере доступность нового маршрута, например, по https://site.ru/wp-json/custom-wc/v1/ — должен отработать REST API (если включена авторизация, может потребоваться токен).

Частые ошибки и их исправление

• Ошибка 404 при обращении к новому URL вебхука
  Причина: старый маршрут не удалён или новый не зарегистрирован правильно.
  Решение: добавьте remove_action с правильными параметрами и регистрируйте маршрут с приоритетом 9.
• Вебхук не срабатывает или приходит 403
  Причина: не установлен корректный permission_callback для маршрута.
  Решение: используйте 'permission_callback' => '__return_true' для теста, потом добавьте проверку авторизации.
• URL вебхука не меняется при отправке
  Причина: фильтр woocommerce_webhook_http_url не добавлен или приоритет слишком низкий.
  Решение: добавьте фильтр с приоритетом 10 и убедитесь, что аргументы принимаются.

Практические советы по безопасности и производительности

• Внедряйте авторизацию для нового REST API маршрута, чтобы не допустить несанкционированных вызовов. Например, проверяйте секретный ключ в заголовках.
• Используйте кеширование для снижения нагрузки на сервер при частых вебхуках.
• Проверяйте, что внешние сервисы поддерживают ваш новый URL, и обновляйте их конфигурацию.
• Регулярно тестируйте вебхуки и логируйте успешные и ошибочные вызовы для быстрого выявления проблем.

Сравнение способов изменения URL вебхуков WooCommerce

Метод	Сложность	Гибкость	Риски
Использование фильтра woocommerce_webhook_http_url	Низкая	Средняя (меняет URL при отправке)	Может не менять конечный маршрут REST API
Переопределение REST API маршрута (через rest_api_init)	Средняя	Высокая (полный контроль над маршрутом)	Неправильная реализация приводит к 404 и поломке вебхуков
Установка плагина для переадресации URL	Низкая	Низкая (зависимость от стороннего кода)	Увеличение нагрузки и риски безопасности