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

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

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

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

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

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

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

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

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

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

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

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

Детально про вибір подій — у статті Як налаштувати внутрішні події для стартової ноди?.

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. Запустіть перевірку через вбудований інструмент тестування — див. Як протестувати сценарій?.

Результат

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

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

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

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