--- title: "Що таке стартова нода (Start node)" description: "Пояснення стартової ноди в Scenario Builder — точка входу в секцію, типи тригерів, use cases та коли який тригер використовувати." --- # Що таке стартова нода (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 при виборі стартової ноди доступні **6 типів тригерів**. Нижче — короткий огляд і рекомендації щодо вибору. | Тригер | Коли використовувати | Детальна інструкція | |--------|----------------------|----------------------| | **Старт процесу** | Ручний запуск, тестування, сценарії за розкладом | [Налаштувати старт процесу](/uk/scenariobuilder/how-to/configure-start-node-process-start.md) | | **Webhook** | Інтеграція з CRM, форма на сайті, зовнішні API | [Налаштувати webhook](/uk/scenariobuilder/how-to/configure-start-node-webhook.md) | | **Канали** | Бот у месенджерах (Telegram, Viber, WhatsApp) або виджеті | [Налаштувати канали](/uk/scenariobuilder/how-to/configure-start-node-channels.md) | | **Внутрішні події** | Автоматизація на основі подій (тікет створено, SLA, помилка доставки) | [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md) | | **MCP Tool** | Виклик секції з AI-асистента (Cursor, Fastline) | [Налаштувати MCP Tool](/uk/scenariobuilder/how-to/configure-start-node-mcp-tool.md) | | **Додатки** | Відповіді Google Forms стають зверненнями з мапінгом полів | [Приймати відповіді Google Forms](/uk/scenariobuilder/how-to/configure-start-node-google-forms.md) | --- ## Use cases: коли який тригер доречний ### Use case 1: Бот у Telegram для клієнтів **Ситуація:** Клієнти пишуть боту в Telegram — бот відповідає, показує меню, приймає замовлення. **Тригер:** **Канали** (Channels) — оберіть Telegram. Секція запускається при кожному повідомленні від користувача. **Деталі:** [Налаштувати канали](/uk/scenariobuilder/how-to/configure-start-node-channels.md). Підключення каналів можна налаштовувати і в стартовій ноді, і в налаштуваннях процесу — обидва варіанти змінюють одну конфігурацію. --- ### Use case 2: Форма на сайті надсилає дані в сценарій **Ситуація:** На сайті є форма «Зворотний зв'язок» або «Записатися на консультацію». Після відправки форми потрібно запустити сценарій — створити тікет, надіслати підтвердження на email. **Тригер:** **Webhook** — зовнішня система робить HTTP-запит на URL платформи. Секція отримує дані з тіла запиту. **Деталі:** [Налаштувати webhook](/uk/scenariobuilder/how-to/configure-start-node-webhook.md) --- ### Use case 3: Автоматична реакція на створення тікета **Ситуація:** Коли створюється новий тікет (наприклад, з виджету), потрібно автоматично відправити привітання клієнту або призначити оператора. **Тригер:** **Внутрішні події** — подія «Тікет створено». Можна додати фільтри: тільки певний канал, тільки нові клієнти. **Деталі:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник параметрів внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) --- ### Use case 4: Ескалація при порушенні SLA **Ситуація:** Якщо тікет занадто довго перебуває в статусі «Відкрито» або наближається дедлайн SLA — запустити сценарій ескалації (наприклад, надіслати повідомлення супервайзеру). **Тригер:** **Внутрішні події** — події «Час у статусі перевищено» або «Дедлайн SLA наближається». Налаштовуються статус, час очікування, канали. **Деталі:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник параметрів внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) --- ### Use case 5: Автоматизація при новому повідомленні в тікеті **Ситуація:** Клієнт відповів у Client Portal (або оператор написав у Operator Line), і потрібно нагадати assignee в Telegram, надіслати auto-reply або викликати зовнішню систему — не лише показати сповіщення в дзвіночку операторам. **Тригер:** **Внутрішні події** — подія **Нове повідомлення в тікеті** (`ticket_message`). Спрацьовує лише на нові **публічні** повідомлення (не на редагування; внутрішні нотатки та системні повідомлення виключені). У контексті доступні `message_text`, `message_from` (`operator` | `client`), `ticket`, `chat_room`. **Деталі:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) --- ### Use case 5a: Автоматизація при внутрішній нотатці в тікеті **Ситуація:** Оператор залишив внутрішню нотатку в тікеті (наприклад, «потрібна перевірка юриста»), і потрібно автоматично створити задачу в зовнішній системі, нагадати супервайзеру або оновити поле тікета — без надсилання тексту клієнту. **Тригер:** **Внутрішні події** — подія **Внутрішня нотатка в тікеті** (`ticket_internal_note`). Спрацьовує лише при створенні нової нотатки оператором. Не створює сповіщення в дзвіночку й не доставляє повідомлення клієнту. У контексті доступні `message_text` (попередній перегляд), `user_id`, `ticket`, `chat_room`. **Важливо:** якщо сценарій пересилає `message_text` назовні (webhook, email, месенджер), перевірте, що це не порушує політику конфіденційності. **Нагадування по чатах** не зупиняються через внутрішню нотатку — лише через публічну відповідь клієнту. **Деталі:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) --- ### Use case 6: Реакція на помилку доставки повідомлення **Ситуація:** Повідомлення не доставлено клієнту (наприклад, користувач заблокував бота в Viber). Потрібно надіслати email супервайзеру або переключити канал комунікації. **Тригер:** **Внутрішні події** — подія «Помилка доставки повідомлення». Можна фільтрувати за каналом та кодом помилки. **Деталі:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник параметрів внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) --- ### Use case 7: AI-асистент викликає логіку сценарію **Ситуація:** AI-асистент (Cursor, Fastline) має отримати курс валют, перевірити наявність товару або виконати іншу логіку, яка вже реалізована в сценарії. **Тригер:** **MCP Tool** — секція експонується як інструмент для AI. AI передає параметри (наприклад, `currency`, `date`) і отримує результат. **Деталі:** [Налаштувати MCP Tool](/uk/scenariobuilder/how-to/configure-start-node-mcp-tool.md), [Підключити AI-асистента через MCP](/uk/scenariodialog/how-to/connect-ai-assistant-mcp.md) --- ### Use case 8: Тестування та ручний запуск **Ситуація:** Потрібно протестувати сценарій без зовнішніх подій — натиснути «Запустити» в редакторі. Або секція викликається за розкладом (cron). **Тригер:** **Старт процесу** — без зовнішнього тригера. Додаткових налаштувань немає. **Деталі:** [Налаштувати старт процесу](/uk/scenariobuilder/how-to/configure-start-node-process-start.md) --- ### Use case 9: Заявки з Google Forms стають зверненнями **Ситуація:** Компанія збирає заявки або анкети через Google-форму. Кожна відповідь має ставати окремим зверненням із заповненими полями, а відповіді одного клієнта — бути пов'язаними між собою. **Тригер:** **Додатки** — оберіть Google Forms. Платформа створює звернення з відповіді форми: клієнт визначається за email, відповіді мапляться в поля звернення, файли стають вкладеннями. **Деталі:** [Приймати відповіді Google Forms](/uk/scenariobuilder/how-to/configure-start-node-google-forms.md) --- ## Швидкий вибір тригера | Якщо потрібно… | Обрати тригер | |----------------|---------------| | Запуск при повідомленні в месенджері або виджеті | Канали | | Запуск при HTTP-запиті з CRM, форми, API | Webhook | | Запуск при події в системі (тікет, нове повідомлення в тікеті, SLA, помилка) | Внутрішні події | | Запуск з AI-асистента (Cursor, Fastline) | MCP Tool | | Відповіді Google Forms мають ставати зверненнями | Додатки | | Ручний запуск або тест | Старт процесу | --- ## Пов'язані документи - **Огляд інструкцій:** [Налаштувати тригери стартової ноди](/uk/scenariobuilder/how-to/configure-start-node-triggers.md) — індекс усіх how-to - **How-to по типах:** [Старт процесу](/uk/scenariobuilder/how-to/configure-start-node-process-start.md), [Webhook](/uk/scenariobuilder/how-to/configure-start-node-webhook.md), [Канали](/uk/scenariobuilder/how-to/configure-start-node-channels.md), [Внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [MCP Tool](/uk/scenariobuilder/how-to/configure-start-node-mcp-tool.md), [Додатки: Google Forms](/uk/scenariobuilder/how-to/configure-start-node-google-forms.md) - **Reference:** [Довідник параметрів внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md) - **How-to:** [Створити сценарій](/uk/scenariobuilder/how-to/create-scenario.md) - **Explanation:** [Про те, як влаштований редактор сценаріїв](/uk/scenariobuilder/explanation/what-is-scenario-editor.md) - **Інтегратор:** [Хаб Scenario Builder](/uk/scenariobuilder/integrator-hub.md)