Як налаштувати 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-параметри.

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

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

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

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

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

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. Налаштувати зовнішню систему

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

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

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

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

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

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

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