Создание веб-хуков: как связать WordPress с внешними сервисами

01.09.2026г.
Веб-разработка
145

#wordpress

Время на прочтение: 5 мин.

Создание веб-хуков помогает WordPress автоматически передавать данные во внешние сервисы. Это полезно для CRM, платежей, Telegram, аналитики и других систем. Разберём, как работает интеграция, где возникают ошибки и как их избежать. Если нужна надёжная интеграция, специалисты «Компьюти» помогут спроектировать и внедрить решение.

Что такое веб-хук и зачем он нужен

Создание веб-хуков начинается с простой идеи. Один сервис отправляет данные другому сразу после события.

Например, пользователь отправил форму на сайте. WordPress получает данные формы. Затем сайт отправляет запрос в CRM.

CRM принимает запрос и создаёт новую сделку.

Так работает автоматическая передача данных без ручных действий.

Обычно веб-хук использует HTTP-запрос. Чаще всего применяется метод POST.

В запросе передаётся набор данных. Обычно это JSON.

Пример данных заявки:

{
  "name": "Иван Петров",
  "phone": "+49 151 12345678",
  "email": "ivan@example.com",
  "source": "website",
  "created_at": "2026-09-01T14:30:00Z"
}

Получающий сервис анализирует данные. Затем он выполняет нужное действие.

Это может быть:

создание клиента;
создание заказа;
отправка уведомления;
запуск бизнес-процесса;
запись события в аналитику;
синхронизация с CRM;
передача данных в ERP;
запуск автоматизации.

Поэтому создание веб-хуков особенно полезно для бизнес-сайтов.

Когда создание веб-хуков действительно необходимо

Представьте типичную ситуацию.

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

Мы решаем её способом: подключаем веб-хук к форме WordPress.

Результат: новая заявка автоматически отправляется в CRM.

Но автоматизация полезна не только для заявок.

Интернет-магазин

После оплаты заказ нужно передать во внешнюю систему.

Веб-хук отправляет:

номер заказа;
сумму;
состав корзины;
данные покупателя;
способ оплаты;
статус заказа.

Внешний сервис получает данные сразу после события.

Онлайн-сервисы

Сайт может передавать события в стороннюю платформу.

Например:

регистрация пользователя;
изменение тарифа;
продление подписки;
отмена подписки;
завершение оплаты.

Маркетинг

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

Можно отправлять информацию о:

заполненной форме;
скачивании файла;
регистрации;
покупке;
повторном обращении.

Создание веб-хуков позволяет убрать промежуточные ручные операции.

Как работает создание веб-хуков

Схема интеграции выглядит просто:

Событие → WordPress → HTTP POST → Webhook URL → внешний сервис → ответ

Например, посетитель отправляет форму.

WordPress формирует JSON.

Затем сайт отправляет его на адрес:

https://api.example.com/webhook

Внешний сервис получает запрос.

Если всё прошло успешно, он возвращает код 200.

Пример ответа:

{
  "success": true,
  "id": "12345"
}

Однако создание веб-хуков требует учитывать ошибки.

Например, внешний API может быть временно недоступен.

Тогда WordPress должен понимать, что данные не доставлены.

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

WordPress позволяет отправлять HTTP-запросы через встроенные функции.

Для этого удобно использовать wp_remote_post().

Простой пример:

function send_order_webhook($order_id) {
    $url = 'https://api.example.com/webhook';

    $data = [
        'order_id' => $order_id,
        'status'   => 'paid',
    ];

    $response = wp_remote_post($url, [
        'timeout' => 10,
        'headers' => [
            'Content-Type' => 'application/json',
        ],
        'body' => wp_json_encode($data),
    ]);

    if (is_wp_error($response)) {
        error_log($response->get_error_message());
        return false;
    }

    $status_code = wp_remote_retrieve_response_code($response);

    return $status_code >= 200 && $status_code < 300;
}

Такой подход подходит для простых интеграций.

Но реальный проект обычно требует дополнительной логики.

Нужно проверить данные перед отправкой.

Нужно защитить endpoint.

Нужно записывать ошибки.

Нужно повторять неудачные запросы.

Нужно контролировать таймауты.

Именно поэтому создание веб-хуков лучше проектировать заранее.

Какие данные передавать через веб-хук

Передавайте только необходимые данные.

Это снижает риски и упрощает поддержку.

Для заявки может хватить такого объекта:

{
  "event": "lead.created",
  "lead": {
    "name": "Иван Петров",
    "phone": "+49 151 12345678",
    "email": "ivan@example.com"
  }
}

Полезно добавить тип события.

Например:

lead.created
order.created
order.paid
user.registered
subscription.cancelled

Так внешний сервис понимает назначение запроса.

Также полезно передавать уникальный идентификатор.

{
  "event": "order.paid",
  "event_id": "evt_84921",
  "order_id": "12548"
}

Идентификатор помогает избежать дублей.

Это особенно важно при повторной отправке.

Безопасность веб-хуков

Создание веб-хуков нельзя сводить только к отправке JSON.

Webhook URL должен быть защищён.

Иначе злоумышленник может отправить поддельный запрос.

Используйте секретный токен

Один из простых вариантов — передавать токен в заголовке.

$token = 'your-secret-token';

$response = wp_remote_post($url, [
    'headers' => [
        'Content-Type'  => 'application/json',
        'Authorization' => 'Bearer ' . $token,
    ],
    'body' => wp_json_encode($data),
    'timeout' => 10,
]);

Получающий сервис проверяет токен.

Без правильного токена запрос отклоняется.

Используйте HTTPS

Webhook URL должен работать через HTTPS.

Не отправляйте данные на обычный HTTP.

Особенно это важно для:

телефонов;
email;
адресов;
заказов;
платёжной информации;
идентификаторов клиентов.

Проверяйте входящие запросы

Если WordPress принимает веб-хук, проверяйте запрос.

Минимально стоит проверить:

HTTP-метод;
Content-Type;
авторизацию;
структуру JSON;
обязательные поля;
уникальность события.

Не доверяйте данным только потому, что запрос пришёл на известный URL.

Обработка ошибок при интеграции

Это один из главных этапов.

Внешний сервис может временно не отвечать.

Он может вернуть ошибку 500.

API может ограничить количество запросов.

Может истечь таймаут.

Поэтому создание веб-хуков должно учитывать повторную отправку.

Простой вариант:

for ($attempt = 1; $attempt <= 3; $attempt++) {
    $response = wp_remote_post($url, [
        'headers' => [
            'Content-Type' => 'application/json',
        ],
        'body' => wp_json_encode($data),
        'timeout' => 10,
    ]);

    if (!is_wp_error($response)) {
        $code = wp_remote_retrieve_response_code($response);

        if ($code >= 200 && $code < 300) {
            break;
        }
    }

    sleep($attempt * 2);
}

В продакшене лучше использовать очередь задач.

Она не блокирует пользователя во время отправки.

Это особенно важно для интернет-магазинов.

Синхронная и асинхронная отправка

Есть два основных подхода.

Подход	Преимущества	Недостатки
Синхронный	Простая реализация	Зависит от ответа API
Асинхронный	Надёжнее для массовых операций	Требует очереди
С очередью	Хорошая масштабируемость	Сложнее разработка
С повторными попытками	Меньше потерянных событий	Нужен контроль дублей

Для небольшого сайта иногда хватает синхронного запроса.

Для магазина с большим количеством заказов лучше использовать очередь.

Идемпотентность: защита от дублей

Это важный момент, который часто забывают.

Допустим, WordPress отправил событие.

Внешний сервис его получил.

Но ответ потерялся из-за сетевой ошибки.

WordPress повторяет запрос.

В итоге внешний сервис получает одно событие дважды.

Без защиты могут появиться две сделки.

Или два заказа.

Или два платежных события.

Решение — использовать event_id.

Например:

{
  "event_id": "evt_84921",
  "event": "order.paid",
  "order_id": 12548
}

Внешний сервис сохраняет обработанные идентификаторы.

Если приходит тот же event_id, повторная обработка не выполняется.

Создание веб-хуков с идемпотентностью значительно повышает надёжность.

Логирование и мониторинг

Интеграция должна быть прозрачной для разработчика.

Если данные не ушли, это нужно увидеть.

Минимальный лог может содержать:

2026-09-01 14:30:12
Webhook: order.paid
Order: 12548
Response: 200
Duration: 0.42 sec

При ошибке:

2026-09-01 14:31:03
Webhook: order.paid
Order: 12549
Response: 500
Attempt: 2

Логи помогают быстро найти проблему.

Но не записывайте в них секреты и пароли.

Также осторожно работайте с персональными данными.

Статистика: почему автоматизация важна

Исследования по автоматизации продаж регулярно показывают рост скорости обработки лидов после внедрения автоматических процессов. На практике даже несколько минут задержки могут влиять на вероятность быстрого контакта с потенциальным клиентом.

Поэтому создание веб-хуков имеет прямую бизнес-ценность.

Сайт перестаёт быть изолированной системой.

Он становится частью цифровой инфраструктуры компании.

Типичные ошибки при создании веб-хуков

Ошибка 1. Нет проверки ответа

Запрос отправили — и забыли проверить статус.

Так нельзя.

Всегда проверяйте HTTP-код и тело ответа.

Ошибка 2. Нет повторных попыток

Временный сбой превращается в потерянную заявку.

Добавьте очередь или retry-механику.

Ошибка 3. Нет защиты

Открытый endpoint может принимать поддельные данные.

Используйте токены или подпись запроса.

Ошибка 4. Нет идентификатора события

Повторный запрос может создать дубль.

Добавляйте уникальный event_id.

Ошибка 5. Слишком много данных

Передача лишней информации увеличивает риски.

Отправляйте только нужные поля.

Ошибка 6. Нет тестовой среды

Изменения сразу проверяются на рабочем сайте.

Это опасно.

Сначала тестируйте интеграцию отдельно.

Чек-лист перед запуском

Перед релизом проверьте создание веб-хуков по списку:

URL работает через HTTPS.
Данные передаются в JSON.
Есть авторизация.
Проверяется HTTP-ответ.
Настроены таймауты.
Есть повторные попытки.
Используется уникальный event_id.
Предусмотрена защита от дублей.
Ошибки записываются в лог.
Секреты не попадают в логи.
Есть тестовый сценарий.
Проверены нештатные ответы API.
Настроен мониторинг критичных событий.

Такой чек-лист снижает вероятность проблем после запуска.

Когда стоит доверить задачу веб-студии

Простую передачу одного поля можно сделать самостоятельно.

Сложные интеграции требуют системного подхода.

Особенно если сайт связан сразу с несколькими сервисами.

Например:

WordPress → CRM → платёжная система → аналитика → Telegram

Здесь появляются зависимости между системами.

Меняется API.

Возникают повторные события.

Добавляются требования к безопасности.

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

Мы решаем её способом: анализируем API, проектируем события и создаём надёжный механизм обмена.

Результат: данные передаются автоматически, а ошибки можно контролировать.

В «Компьюти» мы можем реализовать создание веб-хуков под конкретную бизнес-задачу. Мы работаем с WordPress, PHP, REST API, CRM и сторонними сервисами.

Что подготовить перед разработкой

Чтобы ускорить запуск интеграции, подготовьте:

Название внешнего сервиса.
Документацию его API.
Список нужных событий.
Формат передаваемых данных.
Требования к безопасности.
Примеры успешных ответов.
Примеры ошибок.
Требования к повторной отправке.

Эти данные позволяют быстро оценить объём работ.

Также специалисты смогут определить архитектуру.

Иногда достаточно одного webhook.

В другом проекте потребуется полноценная интеграционная прослойка.

Заключение

Создание веб-хуков помогает связать WordPress с CRM, аналитикой, платежами и другими системами. Хорошая интеграция не просто отправляет данные. Она контролирует безопасность, ошибки, повторы и дубли.

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

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

Автор

Токмаков Александр

Подробнее об авторе →

Приглашаем поучаствовать в обсуждении статьи:

Комментариев 0

Создание веб-хуков: как связать WordPress с внешними сервисами

Что такое веб-хук и зачем он нужен

Когда создание веб-хуков действительно необходимо

Интернет-магазин

Онлайн-сервисы

Маркетинг

Как работает создание веб-хуков

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

Какие данные передавать через веб-хук

Безопасность веб-хуков

Используйте секретный токен

Используйте HTTPS

Проверяйте входящие запросы

Обработка ошибок при интеграции

Синхронная и асинхронная отправка

Идемпотентность: защита от дублей

Логирование и мониторинг

Статистика: почему автоматизация важна

Типичные ошибки при создании веб-хуков

Ошибка 1. Нет проверки ответа

Ошибка 2. Нет повторных попыток

Ошибка 3. Нет защиты

Ошибка 4. Нет идентификатора события

Ошибка 5. Слишком много данных

Ошибка 6. Нет тестовой среды

Чек-лист перед запуском

Когда стоит доверить задачу веб-студии

Что подготовить перед разработкой

Заключение

Приглашаем поучаствовать в обсуждении статьи:

Отменить ответ

Рубрики

Самые популярные статьи

Теги