# Інтегратор — Хаб сценаріїв для Scenario Dialog (Legacy)

> **Рекомендований новий модуль:** [Scenario Builder](/uk/scenariobuilder/integrator-hub.md) — сучасний візуальний редактор сценаріїв, що замінює Scenario Dialog. Використовуйте Scenario Builder для нової розробки.

Сторінка для інтегратора, який створює та редагує сценарії ботів у Scenario Dialog (legacy). Тут ви побудуєте діалогові сценарії через візуальний редактор, додасте переклади та налаштуєте логіку роботи бота. Нижче — інструкції на кожен крок: створення сценаріїв, робота з секціями, додавання перекладів та імпорт/експорт.

---

## Короткий зміст
- [Верхньорівневі цілі та сценарії](#верхньорівневі-цілі-та-сценаріі)
- [Де працювати в інтерфейсі](#де-працювати-в-інтерфеисі)
- [Швидкі посилання](#швидкі-посилання)

---

## Верхньорівневі цілі та сценарії

### Створення та редагування сценаріїв
**Мета** — побудувати діалогову логіку бота через візуальний редактор.
- **Створити новий сценарій** — як створити сценарій бота з нуля та налаштувати базову структуру. → [./how-to/create-scenario.md](/uk/scenariodialog/how-to/create-scenario.md)
- **Редагувати існуючий сценарій** — як внести зміни до вже створеного сценарію та оновити логіку. → [./how-to/edit-scenario.md](/uk/scenariodialog/how-to/edit-scenario.md)
- **Створити секцію сценарію** — як організувати складний сценарій на окремі секції для кращої структуризації. → [./how-to/create-section.md](/uk/scenariodialog/how-to/create-section.md)

### Робота з нодами та логікою
**Мета** — налаштувати окремі елементи сценарію та їх взаємодію.
- **Додати повідомлення** — як створити ноду з текстом повідомлення для користувача.
- **Налаштувати клавіатуру** — як додати кнопки до повідомлення та налаштувати переходи по кнопках.
- **Додати очікування вводу** — як зібрати дані від користувача через Input ноду.
- **Використати actions в сценарії** — як додати та налаштувати дії (actions) для розширення функціональності сценарію. → [./how-to/use-action-in-scenario.md](/uk/scenariodialog/how-to/use-action-in-scenario.md)
- **Підключити AI-асистента до сценарію через MCP** — як налаштувати секцію як MCP-інструмент та додати підключення в AI-клієнті (наприклад Cursor). → [./how-to/connect-ai-assistant-mcp.md](/uk/scenariodialog/how-to/connect-ai-assistant-mcp.md)
- **Налаштувати параметри MCP-інструменту сценарію** — як додати вхідні параметри (Input Schema) та використовувати їх у повідомленнях, умовах та діях секції. → [./how-to/configure-mcp-tool-parameters.md](/uk/scenariodialog/how-to/configure-mcp-tool-parameters.md)
- **Налаштувати автокатегоризацію запитів (старий Fast Line)** — як автоматично визначати категорію звернення через action fastline_search. ⚠️ Не рекомендується для нових проєктів. → [./how-to/auto-categorize-client-requests.md](/uk/scenariodialog/how-to/auto-categorize-client-requests.md)

### Мультимовність та переклади
**Мета** — забезпечити підтримку кількох мов у сценарії.
- **Додати переклади до сценарію** — як додати переклади текстів повідомлень для різних мов. → [./how-to/add-translations.md](/uk/scenariodialog/how-to/add-translations.md)
- **Перемкнути мову редагування** — як переглянути та редагувати сценарій для конкретної мови.

### Імпорт та експорт
**Мета** — зберегти резервну копію сценарію або перенести його між проектами.
- **Експортувати сценарій** — як зберегти сценарій у файл для резервного копіювання. → [./how-to/import-export-scenario.md](/uk/scenariodialog/how-to/import-export-scenario.md)
- **Імпортувати сценарій** — як завантажити сценарій з файлу та відновити його структуру.

### Історія версій
**Мета** — відстежувати зміни сценарію та відновлювати попередні версії.
- **Переглянути та відновити версії сценарію** — як переглянути історію версій та активувати попередню версію сценарію. → [./how-to/view-scenario-history.md](/uk/scenariodialog/how-to/view-scenario-history.md)

### Explanation документи
**Мета** — зрозуміти концепції та принципи роботи зі сценаріями.

#### Actions та автоматизація
- **Що таке actions та як вони працюють** — розуміння стандартних та кастомних actions, їх використання в сценаріях. → [./explanation/actions-in-scenarios.md](/uk/scenariodialog/explanation/actions-in-scenarios.md)
- **Використання action autobroadcast__create** — як використовувати action для запланованих розсилок у сценаріях. → [./explanation/autobroadcast-action-usage.md](/uk/scenariodialog/explanation/autobroadcast-action-usage.md)
- **Виведення зображень користувачу** — способи відправки зображень через UI та action send_photo. → [./explanation/display-image-to-user.md](/uk/scenariodialog/explanation/display-image-to-user.md)
- **Категоризація листів з пошти** — автоматична категоризація вхідних листів за допомогою AI. → [./explanation/email-categorization.md](/uk/scenariodialog/explanation/email-categorization.md)

#### Форматування та стилізація
- **HTML форматування тексту** — використання HTML тегів для стилізації тексту в Telegram та Widget. → [./explanation/html-text-styling.md](/uk/scenariodialog/explanation/html-text-styling.md)
- **Інлайн-клавіатура** — налаштування інлайн-клавіатури для Telegram та Widget. → [./explanation/inline-keyboard.md](/uk/scenariodialog/explanation/inline-keyboard.md)
- **Стилізація клавіатури у Viber** — налаштування зовнішнього вигляду кнопок клавіатури у Viber. → [./explanation/viber-keyboard-styling.md](/uk/scenariodialog/explanation/viber-keyboard-styling.md)
- **Стартове повідомлення у Viber** — особливості роботи з першим повідомленням у Viber. → [./explanation/viber-start-message.md](/uk/scenariodialog/explanation/viber-start-message.md)

#### Інтеграції та зовнішні системи
- **Telegram WebApp** — відкриття веб-додатків безпосередньо в Telegram. → [./explanation/telegram-webapp.md](/uk/scenariodialog/explanation/telegram-webapp.md)
- **Оплата через бот** — інтеграція з платіжними системами (Liqpay, Apple Pay, Google Pay). → [./explanation/payment-via-bot.md](/uk/scenariodialog/explanation/payment-via-bot.md)
- **Інтеграція з Corezoid** — підключення операторської панелі до Corezoid через webhook. → [./explanation/corezoid-integration.md](/uk/scenariodialog/explanation/corezoid-integration.md)
- **Боти для груп Telegram** — створення ботів, які слухають та відповідають у групах Telegram. → [./explanation/telegram-group-bots.md](/uk/scenariodialog/explanation/telegram-group-bots.md)
- **Реферальні мітки з реклами Facebook** — відстеження джерела трафіку з рекламних кампаній. → [./explanation/facebook-ads-referral-tags.md](/uk/scenariodialog/explanation/facebook-ads-referral-tags.md)
- **Запуск сценарію з реклами на Facebook** — налаштування унікальних сценаріїв для різних рекламних кампаній. → [./explanation/facebook-ads-scenario-launch.md](/uk/scenariodialog/explanation/facebook-ads-scenario-launch.md)
- **Виклик секцій сценарію з AI-асистентів (MCP)** — як зробити секцію доступною як інструмент для AI-клієнтів (Cursor, Claude тощо). → [./explanation/mcp-tools-scenario.md](/uk/scenariodialog/explanation/mcp-tools-scenario.md)

#### Операторські функції
- **Налаштування alias при вихідному діалозі** — контроль поведінки користувача після завершення діалогу. → [./explanation/outgoing-dialog-aliases.md](/uk/scenariodialog/explanation/outgoing-dialog-aliases.md)
- **Копіювання сценарію** — переклад сценарію на інші мови зі збереженням структури. → [./explanation/copy-scenario.md](/uk/scenariodialog/explanation/copy-scenario.md)

---

## Де працювати в інтерфейсі

Основна робота зі сценаріями відбувається в модулі **Dialog**:
- **Модуль `Dialog`**: `Меню -> Сценарій` — тут ви редагуєте сценарії ботів.
- **Роут `/dialog/bot-scenario/:id`**: відкриває редактор сценарію для конкретного бота.
- **Панель секцій**: зверху екрана — для перемикання між секціями сценарію.
- **Рабочее полотно (Canvas)**: центральна область — для візуального редагування нод та зв'язків.
- **Права панель (RightSideBar)**: для редагування параметрів обраної ноди.
- **Кнопка "Зберегти"**: знизу екрана — для збереження змін у сценарії.

---

## Швидкі посилання

### Створення та редагування
- [Створити новий сценарій](/uk/scenariodialog/how-to/create-scenario.md)
- [Редагувати сценарій](/uk/scenariodialog/how-to/edit-scenario.md)
- [Створити секцію](/uk/scenariodialog/how-to/create-section.md)
- [Автокатегоризація (старий Fast Line) ⚠️](/uk/scenariodialog/how-to/auto-categorize-client-requests.md)

### Мультимовність
- [Додати переклади](/uk/scenariodialog/how-to/add-translations.md)

### Імпорт та експорт
- [Експортувати/імпортувати сценарій](/uk/scenariodialog/how-to/import-export-scenario.md)

### Історія версій
- [Переглянути та відновити версії сценарію](/uk/scenariodialog/how-to/view-scenario-history.md)

### MCP та AI-асистенти
- [Підключити AI-асистента до сценарію через MCP](/uk/scenariodialog/how-to/connect-ai-assistant-mcp.md)
- [Налаштувати параметри MCP-інструменту сценарію](/uk/scenariodialog/how-to/configure-mcp-tool-parameters.md)

### Explanation документи

#### Actions та автоматизація
- [Що таке actions та як вони працюють](/uk/scenariodialog/explanation/actions-in-scenarios.md)
- [Використання action autobroadcast__create](/uk/scenariodialog/explanation/autobroadcast-action-usage.md)
- [Виведення зображень користувачу](/uk/scenariodialog/explanation/display-image-to-user.md)
- [Категоризація листів з пошти](/uk/scenariodialog/explanation/email-categorization.md)

#### Форматування та стилізація
- [HTML форматування тексту](/uk/scenariodialog/explanation/html-text-styling.md)
- [Інлайн-клавіатура](/uk/scenariodialog/explanation/inline-keyboard.md)
- [Стилізація клавіатури у Viber](/uk/scenariodialog/explanation/viber-keyboard-styling.md)
- [Стартове повідомлення у Viber](/uk/scenariodialog/explanation/viber-start-message.md)

#### Інтеграції та зовнішні системи
- [Telegram WebApp](/uk/scenariodialog/explanation/telegram-webapp.md)
- [Оплата через бот](/uk/scenariodialog/explanation/payment-via-bot.md)
- [Інтеграція з Corezoid](/uk/scenariodialog/explanation/corezoid-integration.md)
- [Боти для груп Telegram](/uk/scenariodialog/explanation/telegram-group-bots.md)
- [Реферальні мітки з реклами Facebook](/uk/scenariodialog/explanation/facebook-ads-referral-tags.md)
- [Запуск сценарію з реклами на Facebook](/uk/scenariodialog/explanation/facebook-ads-scenario-launch.md)

#### Операторські функції
- [Налаштування alias при вихідному діалозі](/uk/scenariodialog/explanation/outgoing-dialog-aliases.md)
- [Копіювання сценарію](/uk/scenariodialog/explanation/copy-scenario.md)