---
title: "Як налаштувати webhook для стартової ноди"
description: "Інструкція налаштування тригера Webhook для стартової ноди в Scenario Builder — URL, параметри, інтеграція з CRM та формами."
---

# Як налаштувати webhook для стартової ноди?

Тригер **Webhook** запускає секцію при надходженні HTTP-запиту на згенерований URL. Підходить для інтеграції з CRM, формами на сайті та зовнішніми API.

## Коли знадобиться

- Форма на сайті надсилає дані в ConnectiveOne.
- CRM або інша система викликає сценарій по HTTP.
- Зовнішній сервіс має запустити логіку бота.

## Що важливо знати

- **Webhook URL** — адреса, на яку зовнішня система надсилає запит. Генерується платформою після публікації сценарію.
- **call_node** — API-ендпоінт платформи для виклику ноди. URL має вигляд: `.../call_node/{bot_id}/{node_id}`.
- **Параметри в URL** — можна передавати `channel`, `chat_id` та додаткові query-параметри.

## Перед початком

- [x] Ви увійшли з правами інтегратора або адміністратора.
- [x] У вас є секція з доданою стартовою нодою.
- [x] Сценарій опубліковано — URL webhook генерується після публікації (нода отримує постійний ID).

## Покрокова інструкція

### 1. Обрати тип тригера Webhook

1. Виберіть стартову ноду на полотні.
2. У Node Inspector у полі **Тип тригера** виберіть **Webhook**.

### 2. Опублікувати сценарій

1. Натисніть **Зберегти** та **Опублікувати** сценарій.
2. Після публікації webhook URL з’явиться в налаштуваннях ноди.

### 3. Скопіювати та використати URL

**Базовий URL** (без прив’язки до конкретного чату):

```
{адреса_платформи}/kw/api/call_node/{bot_id}/{node_id}
```

**URL з прив’язкою до чату** (для відправки повідомлень у конкретний діалог):

```
{адреса_платформи}/kw/api/call_node/{bot_id}/{node_id}/{channel}/{chat_id}?param1=val1&param2=val2
```

**Параметри:**

| Параметр | Опис |
|----------|------|
| `bot_id` | ID бота |
| `node_id` | ID стартової ноди (з’являється після публікації) |
| `channel` | Канал (telegram, viber, widget тощо) — опціонально |
| `chat_id` | ID чату клієнта — опціонально |
| `param1=val1` | Додаткові параметри в query-string |

**Приклад:**

```
.../call_node/18/3/telegram/313145?name=John&surname=Whale
```

### 4. Налаштувати зовнішню систему

1. У формі на сайті, CRM або іншій системі вкажіть URL webhook як endpoint для відправки даних.
2. Використовуйте метод **POST** або **GET** залежно від вимог інтеграції.
3. Додаткові параметри передавайте в query-string або в тілі POST-запиту.

## Що відбувається після

При надходженні HTTP-запиту на URL секція запускається. Дані з запиту доступні в контексті сценарію (параметри, тіло запиту).

## Як переконатися, що все працює

- Перевірте, чи сценарій опубліковано.
- Надішліть тестовий запит (наприклад, через Postman або curl) на URL.
- Переконайтеся, що URL доступний ззовні (не блокується firewall).

## Типові помилки

| Проблема | Рішення |
|----------|---------|
| Webhook не спрацьовує | Перевірте, чи опубліковано сценарій. Переконайтеся, що URL правильний і доступний ззовні. |
| 404 або помилка маршруту | Перевірте `bot_id` та `node_id` в URL. |
| Таймаут | Переконайтеся, що зовнішня система не блокує виклики. |

## Пов'язані матеріали

- [Що таке стартова нода](/uk/scenariobuilder/explanation/what-is-start-node.md)
- [Налаштувати тригери стартової ноди](/uk/scenariobuilder/how-to/configure-start-node-triggers.md)
- [Запуск сценарію через API call_node](/uk/integrations/how-to/launch-scenario-via-call-node.md)