Як налаштувати 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

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

Параметри:

Приклад:

.../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).

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

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

• Що таке стартова нода
• Налаштувати тригери стартової ноди
• Запуск сценарію через API call_node