> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Webhook

> Надсилайте дані лідів у будь-яку CRM або зовнішню систему через HTTP

## Огляд

Custom Webhook — найпростіша інтеграція: вона надсилає HTTP-запити на будь-яку вказану URL-адресу. Використовуйте для передачі даних лідів у CRM, запуску автоматизацій у Zapier/Make або підключення до будь-якої системи з API.

Без OAuth, без SDK — лише цільова URL-адреса та опціональні заголовки.

## Налаштування

<Steps>
  <Step title="Додайте інтеграцію">
    Перейдіть в **Інтеграції** → **Додати інтеграцію** → оберіть **Custom Webhook** з категорії CRM.
  </Step>

  <Step title="Налаштування">
    | Поле               | Обов'язкове | Опис                                                                      |
    | ------------------ | ----------- | ------------------------------------------------------------------------- |
    | **Webhook URL**    | Так         | Ендпоінт для надсилання даних                                             |
    | **Webhook Secret** | Ні          | Секрет для HMAC-SHA256 підпису запитів                                    |
    | **Headers**        | Ні          | Кастомні HTTP-заголовки (JSON формат, напр., `Authorization: Bearer ...`) |
  </Step>

  <Step title="Тестування">
    Натисніть **Test Connection**. Revol надсилає тестовий payload та перевіряє, що URL відповідає зі статусом 2xx.
  </Step>
</Steps>

## Інструменти агента

| Інструмент        | Опис                                                                                                                                |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `send_payload`    | Надіслати структуровані JSON-дані (інформація про ліда, дані форми) на webhook URL. Підписується HMAC-SHA256 при наявності секрету. |
| `test_connection` | Перевірити, що webhook URL доступний та відповідає коректно                                                                         |

## Формат payload

Коли агент викликає `send_payload`, Revol надсилає POST-запит з JSON-тілом. Вміст визначається AI-агентом на основі інформації, зібраної під час розмови:

```json theme={null}
{
  "event": "lead_captured",
  "timestamp": "2026-03-07T14:30:00Z",
  "company_id": 5,
  "agent_id": 12,
  "conversation_id": "conv_abc123",
  "data": {
    "name": "Іван Петренко",
    "email": "ivan@example.com",
    "phone": "+380501234567",
    "message": "Цікавить Enterprise план",
    "source": "website_widget",
    "utm_campaign": "spring_promo"
  }
}
```

## Підпис запитів

Якщо ви вказали **Webhook Secret**, кожен запит підписується HMAC-SHA256:

* Підпис передається у заголовку `X-Webhook-Signature`
* Для верифікації на вашому сервері обчисліть `HMAC-SHA256(тіло_запиту, ваш_секрет)` та порівняйте

## Використання у workflow-нодах

Інструменти вебхуків працюють як будь-які інші інструменти агента:

1. Підключіть webhook-інтеграцію та протестуйте URL
2. Інструменти з'являться у вкладці **Tools** агента
3. Додайте `send_payload` до **custom node** у workflow-редакторі
4. LLM вирішує, коли надсилати дані, на основі контексту розмови

**Приклад workflow:** Агент збирає інформацію про ліда (ім'я, email, телефон, інтерес) → при завершенні розмови використовує `send_payload` для передачі даних у вашу CRM.

## Приклади використання

* **Інтеграція з CRM** — Передача кваліфікованих лідів у Pipedrive, HubSpot, Salesforce або будь-яку CRM з webhook/API ендпоінтом
* **Zapier / Make** — Запуск багатокрокових автоматизацій з подій розмов
* **Slack / Discord** — Сповіщення при захопленні цінних лідів
* **Кастомний бекенд** — Виклик вашого API для створення замовлень, оновлення записів або запуску внутрішніх процесів
* **Аналітика** — Надсилання результатів розмов у ваше сховище даних