Що таке стартова нода (Start node)?
Стартова нода — це обов'язкова точка входу в секцію сценарію. Вона визначає, як і коли буде запущено логіку секції: через месенджер, webhook, системну подію або інший тригер. Кожна секція має рівно одну стартову ноду.
Навіщо потрібна стартова нода
- Визначає точку входу — система знає, з якої ноди починати виконання секції.
- Налаштовує тригери — ви обираєте, що саме запускає секцію: повідомлення в Telegram, HTTP-запит, створення тикета тощо.
- Централізує налаштування — усі тригери секції налаштовуються в одному місці (Node Inspector), без переходу в інші розділи.
Різниця між Start node та Entry Point
| Концепція | Призначення |
|---|---|
| Start node | Головна точка входу в секцію. Одна на секцію. Визначає тригери (канали, webhook, події, MCP Tool). |
| Entry Point | Додаткова точка входу для переходів всередині сценарію. Використовується, коли інша секція переходить сюди через Exit Point. Може бути кілька Entry Point у секції. |
Приклад: Секція «Головне меню» має Start node з тригером Telegram — коли користувач пише боту, діалог починається тут. Секція «Підтримка» має Start node з тригером Internal Events (тикет створено) і окремий Entry Point — для переходу з «Головного меню» по кнопці «Підтримка».
Типи тригерів та коли який використовувати
У Node Inspector при виборі стартової ноди доступні 5 типів тригерів. Нижче — короткий огляд і рекомендації щодо вибору.
| Тригер | Коли використовувати | Детальна інструкція |
|---|---|---|
| Старт процесу | Ручний запуск, тестування, сценарії за розкладом | Налаштувати старт процесу |
| Webhook | Інтеграція з CRM, форма на сайті, зовнішні API | Налаштувати webhook |
| Канали | Бот у месенджерах (Telegram, Viber, WhatsApp) або виджеті | Налаштувати канали |
| Внутрішні події | Автоматизація на основі подій (тикет створено, SLA, помилка доставки) | Налаштувати внутрішні події |
| MCP Tool | Виклик секції з AI-асистента (Cursor, Fastline) | Налаштувати MCP Tool |
Use cases: коли який тригер доречний
Use case 1: Бот у Telegram для клієнтів
Ситуація: Клієнти пишуть боту в Telegram — бот відповідає, показує меню, приймає замовлення.
Тригер: Канали (Channels) — оберіть Telegram. Секція запускається при кожному повідомленні від користувача.
Деталі: Налаштувати канали. Підключення каналів можна налаштовувати і в стартовій ноді, і в налаштуваннях процесу — обидва варіанти змінюють одну конфігурацію.
Use case 2: Форма на сайті надсилає дані в сценарій
Ситуація: На сайті є форма «Зворотний зв'язок» або «Записатися на консультацію». Після відправки форми потрібно запустити сценарій — створити тікет, надіслати підтвердження на email.
Тригер: Webhook — зовнішня система робить HTTP-запит на URL платформи. Секція отримує дані з тіла запиту.
Деталі: Налаштувати webhook
Use case 3: Автоматична реакція на створення тикета
Ситуація: Коли створюється новий тикет (наприклад, з виджету), потрібно автоматично відправити привітання клієнту або призначити оператора.
Тригер: Внутрішні події — подія «Тикет створено». Можна додати фільтри: тільки певний канал, тільки нові клієнти.
Деталі: Налаштувати внутрішні події, Довідник параметрів внутрішніх подій
Use case 4: Ескалація при порушенні SLA
Ситуація: Якщо тикет занадто довго перебуває в статусі «Відкрито» або наближається дедлайн SLA — запустити сценарій ескалації (наприклад, надіслати повідомлення супервайзеру).
Тригер: Внутрішні події — події «Час у статусі перевищено» або «Дедлайн SLA наближається». Налаштовуються статус, час очікування, канали.
Деталі: Налаштувати внутрішні події, Довідник параметрів внутрішніх подій
Use case 5: Реакція на помилку доставки повідомлення
Ситуація: Повідомлення не доставлено клієнту (наприклад, користувач заблокував бота в Viber). Потрібно надіслати email супервайзеру або переключити канал комунікації.
Тригер: Внутрішні події — подія «Помилка доставки повідомлення». Можна фільтрувати за каналом та кодом помилки.
Деталі: Налаштувати внутрішні події, Довідник параметрів внутрішніх подій
Use case 6: AI-асистент викликає логіку сценарію
Ситуація: AI-асистент (Cursor, Fastline) має отримати курс валют, перевірити наявність товару або виконати іншу логіку, яка вже реалізована в сценарії.
Тригер: MCP Tool — секція експонується як інструмент для AI. AI передає параметри (наприклад, currency, date) і отримує результат.
Деталі: Налаштувати MCP Tool, Підключити AI-асистента через MCP
Use case 7: Тестування та ручний запуск
Ситуація: Потрібно протестувати сценарій без зовнішніх подій — натиснути «Запустити» в редакторі. Або секція викликається за розкладом (cron).
Тригер: Старт процесу — без зовнішнього тригера. Додаткових налаштувань немає.
Деталі: Налаштувати старт процесу
Швидкий вибір тригера
| Якщо потрібно… | Обрати тригер |
|---|---|
| Запуск при повідомленні в месенджері або виджеті | Канали |
| Запуск при HTTP-запиті з CRM, форми, API | Webhook |
| Запуск при події в системі (тикет, SLA, помилка) | Внутрішні події |
| Запуск з AI-асистента (Cursor, Fastline) | MCP Tool |
| Ручний запуск або тест | Старт процесу |
Пов'язані документи
- Огляд інструкцій: Налаштувати тригери стартової ноди — індекс усіх how-to
- How-to по типах: Старт процесу, Webhook, Канали, Внутрішні події, MCP Tool
- Reference: Довідник параметрів внутрішніх подій
- How-to: Створити сценарій
- Explanation: Про те, як влаштований редактор сценаріїв
- Інтегратор: Хаб Scenario Builder