---
title: "Як надіслати клієнту HTML-лист зі сценарію"
description: "Рекомендований шлях у Scenario Builder: тригер внутрішньої події → нода Set → «Відправити Email» через бота з Email-каналом, з плейсхолдерами та HTML у полі «Текст листа»."
---

# Як надіслати клієнту HTML-лист зі сценарію?

Коли у клієнта змінюється статус тікета або команда залишає нову публічну відповідь, зручно автоматично надіслати йому оформлений лист — з номером і назвою тікета, новим статусом і посиланням у портал, без тексту самого коментаря.

Ця інструкція показує рекомендований шлях: зібрати дані в сценарії та надіслати HTML-лист нодою **«Відправити Email»** через Email-канал бота.

## Коли знадобиться

- Клієнтам Client Portal треба надсилати сповіщення про зміну статусу тікета.
- Треба повідомити клієнта про оновлення тікета (наприклад нову публічну відповідь команди) — без внутрішніх нотаток у тілі листа.
- Лист має бути оформленим (HTML) і містити динамічні дані конкретного тікета.

## Що важливо знати

- **Scenario Builder** — модуль для побудови сценаріїв, що замінює Scenario Dialog.
- **«Відправити Email»** — тип ноди в модальному вікні додавання; на полотні відображається як **«Відправка Email»**. Нода надсилає лист через **Email-канал обраного бота**.
- **Email-канал бота** — пошта, підключена до самого бота. Лист іде саме через неї, тому **окреме налаштування глобальної пошти платформи не потрібне**.
- **Set** — нода для збереження пар ключ → значення у стані сценарію перед наступними кроками. Детальніше: [Зберегти значення для наступних кроків](/uk/scenariobuilder/explanation/set-node.md).
- **Плейсхолдери** — підстановки виду `{{trigger_data.*}}` (дані події, що запустила сценарій) та `{{назва_константи}}` (значення з ноди Set). У листі вони замінюються на реальні значення.

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

- [x] Ви увійшли в систему з правами інтегратора або адміністратора.
- [x] До бота підключено й налаштовано Email-канал.
- [x] У вас відкритий редактор Scenario Builder з потрібним сценарієм.
- [x] Ви знаєте, на яку внутрішню подію має спрацьовувати лист (див. крок 1).

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

### 1. Налаштувати тригер події

1. У стартовій ноді оберіть тип тригера **Внутрішні події** і потрібну подію:
   - **Статус тікета змінено** — лист при переході тікета в новий статус;
   - **Тікет оновлено** — лист при зміні тікета (наприклад нова публічна відповідь). Додайте фільтри або умови в сценарії, щоб **не** надсилати лист на внутрішні нотатки.
2. Збережіть налаштування стартової ноди.

Детально про вибір подій — у статті [Як налаштувати внутрішні події для стартової ноди?](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md).

### 2. Зібрати дані для листа (нода Set)

1. На полотні натисніть **«+»** після стартової ноди.
2. У модальному вікні знайдіть шаблон **Set** (категорія **Data** або через пошук).
3. У Node Inspector задайте ключі та значення, які потрібні в листі — наприклад номер і назву тікета, новий статус, посилання у портал. Використовуйте дані події через `{{trigger_data.*}}`.
4. Зʼєднайте стартову ноду з нодою Set.

> Тіло коментаря в лист передавати не потрібно — збирайте лише ті поля, які хочете показати клієнту.

### 3. Додати ноду надсилання листа

1. На полотні натисніть **«+»** після ноди Set.
2. У модальному вікні оберіть **«Відправити Email»**.
3. Зʼєднайте ноду з попереднім кроком.

### 4. Заповнити лист

1. Клацніть на ноду **«Відправка Email»** — справа відкриється Node Inspector.
2. У полі **Через який процес пишемо?** оберіть бота, до якого підключено Email-канал.
3. У полі **Email одержувача** вкажіть адресу клієнта (наприклад через плейсхолдер з даними клієнта).
4. У полі **Тема листа** задайте тему — можна з плейсхолдерами.
5. У полі **Текст листа** вставте HTML-розмітку з плейсхолдерами `{{trigger_data.*}}` та `{{назва_константи}}`. Редактор підтримує HTML-форматування; вміст надсилається як є.

> Сирий HTML у полі **Текст листа** більше не призводить до порожнього листа — обхідний шлях через ідентифікатор перекладу не потрібен.

### 5. Зберегти й перевірити сценарій

1. Збережіть сценарій.
2. Запустіть перевірку через вбудований інструмент тестування — див. [Як протестувати сценарій?](/uk/scenariobuilder/how-to/test-scenario.md).

## Результат

Коли спрацьовує вибрана подія, клієнт отримує оформлений HTML-лист із підставленими даними тікета, надісланий через Email-канал обраного бота. Тема, отримувач і тіло листа підставляються однаково — за тим самим набором плейсхолдерів.

## Як переконатися, що все вдалось

- Тестовий лист приходить на пошту, тіло **не порожнє** й відображається з оформленням (HTML), а не як «сирий» код.
- Плейсхолдери в темі й тілі замінені на реальні значення (номер тікета, статус, посилання).
- Лист надсилається навіть тоді, коли у клієнта немає підключених каналів, але в його профілі є email.

## Пов'язані інструкції

- [Зберегти значення для наступних кроків (Set)](/uk/scenariobuilder/explanation/set-node.md)
- [Як використати дію в сценарії?](/uk/scenariobuilder/how-to/use-action-in-scenario.md)
- [Як налаштувати внутрішні події для стартової ноди?](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md)
- [Як протестувати сценарій?](/uk/scenariobuilder/how-to/test-scenario.md)