Исходящие вебхуки

Исходящие вебхуки передают данные лидов из LeadHub на внешний URL при возникновении события лида. Используйте их для синхронизации с CRM, запуска Zapier-процессов или уведомления внешних систем.

---

Принцип работы исходящих вебхуков

1. Вы создаёте исходящий вебхук с целевым URL и событиями для отслеживания.
2. Когда происходит выбранное событие (например, создаётся новый лид), LeadHub отправляет HTTP POST-запрос на ваш URL.
3. Данные запроса — JSON-объект с полными данными лида.

---

Создание исходящего вебхука

1. Перейдите в Интеграции → Исходящие вебхуки.
2. Нажмите Новый исходящий вебхук.
3. Настройте:

Поле	Описание
Название	Внутреннее имя (например, «Синхронизация с HubSpot»)
URL	Внешняя конечная точка для получения POST-запроса
События	Какие события активируют вебхук (см. ниже)
Secret	Необязательный HMAC-секрет для проверки подписи
Активен	Переключатель для включения/отключения

4. Нажмите Сохранить.

---

Доступные события

Событие	Когда срабатывает
lead.created	Создаётся новая запись лида
lead.updated	Лид изменяется
lead.deleted	Лид удаляется
lead.stage_changed	Лид переходит на новый этап воронки
lead.assigned	Лид назначается пользователю
form.submitted	Получена отправка формы

---

Формат данных

Все исходящие вебхуки отправляют JSON-тело:

{
  "event": "lead.created",
  "occurred_at": "2026-04-29T10:30:00Z",
  "lead": {
    "id": 123,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "+1-555-000-0000",
    "source": "web_form",
    "status": "new",
    "lead_score": 45,
    "pipeline": "Sales Pipeline",
    "stage": "New Lead",
    "assigned_to": "[email protected]",
    "tags": ["vip", "from-webinar"],
    "created_at": "2026-04-29T10:30:00Z"
  }
}

---

Проверка HMAC-подписи

Если вы установили Secret, LeadHub подписывает каждый запрос подписью HMAC-SHA256. Подпись передаётся в заголовке X-LeadHub-Signature.

Пример проверки на PHP:

$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

---

Доставка и повторные попытки

LeadHub доставляет вебхуки асинхронно через очередь. Если внешняя конечная точка возвращает ответ не-2xx, доставка повторяется до 3 раз с экспоненциальным откатом.

Смотрите Журнал вебхуков для просмотра истории доставки.

---

Отключение и удаление

• Отключить: Переключите Active в off — события не отправляются, но конфигурация сохраняется.
• Удалить: Безвозвратно удаляет конфигурацию вебхука.