Як надіслати клієнту HTML-лист зі сценарію?
Коли у клієнта змінюється статус тікета або команда залишає нову публічну відповідь, зручно автоматично надіслати йому оформлений лист — з номером і назвою тікета, новим статусом і посиланням у портал, без тексту самого коментаря.
Ця інструкція показує рекомендований шлях: зібрати дані в сценарії та надіслати HTML-лист нодою «Відправити Email» через Email-канал бота.
Коли знадобиться
- Клієнтам Client Portal треба надсилати сповіщення про зміну статусу тікета.
- Треба повідомити клієнта про оновлення тікета (наприклад нову публічну відповідь команди) — без внутрішніх нотаток у тілі листа.
- Лист має бути оформленим (HTML) і містити динамічні дані конкретного тікета.
Що важливо знати
- Scenario Builder — модуль для побудови сценаріїв, що замінює Scenario Dialog.
- «Відправити Email» — тип ноди в модальному вікні додавання; на полотні відображається як «Відправка Email». Нода надсилає лист через Email-канал обраного бота.
- Email-канал бота — пошта, підключена до самого бота. Лист іде саме через неї, тому окреме налаштування глобальної пошти платформи не потрібне.
- Set — нода для збереження пар ключ → значення у стані сценарію перед наступними кроками. Детальніше: Зберегти значення для наступних кроків.
- Плейсхолдери — підстановки виду
{{trigger_data.*}}(дані події, що запустила сценарій) та{{назва_константи}}(значення з ноди Set). У листі вони замінюються на реальні значення.
Перед початком
Покрокова інструкція
1. Налаштувати тригер події
- У стартовій ноді оберіть тип тригера Внутрішні події і потрібну подію:
- Статус тікета змінено — лист при переході тікета в новий статус;
- Тікет оновлено — лист при зміні тікета (наприклад нова публічна відповідь). Додайте фільтри або умови в сценарії, щоб не надсилати лист на внутрішні нотатки.
- Збережіть налаштування стартової ноди.
Детально про вибір подій — у статті Як налаштувати внутрішні події для стартової ноди?.
2. Зібрати дані для листа (нода Set)
- На полотні натисніть «+» після стартової ноди.
- У модальному вікні знайдіть шаблон Set (категорія Data або через пошук).
- У Node Inspector задайте ключі та значення, які потрібні в листі — наприклад номер і назву тікета, новий статус, посилання у портал. Використовуйте дані події через
{{trigger_data.*}}. - Зʼєднайте стартову ноду з нодою Set.
Тіло коментаря в лист передавати не потрібно — збирайте лише ті поля, які хочете показати клієнту.
3. Додати ноду надсилання листа
- На полотні натисніть «+» після ноди Set.
- У модальному вікні оберіть «Відправити Email».
- Зʼєднайте ноду з попереднім кроком.
4. Заповнити лист
- Клацніть на ноду «Відправка Email» — справа відкриється Node Inspector.
- У полі Через який процес пишемо? оберіть бота, до якого підключено Email-канал.
- У полі Email одержувача вкажіть адресу клієнта (наприклад через плейсхолдер з даними клієнта).
- У полі Тема листа задайте тему — можна з плейсхолдерами.
- У полі Текст листа вставте HTML-розмітку з плейсхолдерами
{{trigger_data.*}}та{{назва_константи}}. Редактор підтримує HTML-форматування; вміст надсилається як є.
Сирий HTML у полі Текст листа більше не призводить до порожнього листа — обхідний шлях через ідентифікатор перекладу не потрібен.
5. Зберегти й перевірити сценарій
- Збережіть сценарій.
- Запустіть перевірку через вбудований інструмент тестування — див. Як протестувати сценарій?.
Результат
Коли спрацьовує вибрана подія, клієнт отримує оформлений HTML-лист із підставленими даними тікета, надісланий через Email-канал обраного бота. Тема, отримувач і тіло листа підставляються однаково — за тим самим набором плейсхолдерів.
Як переконатися, що все вдалось
- Тестовий лист приходить на пошту, тіло не порожнє й відображається з оформленням (HTML), а не як «сирий» код.
- Плейсхолдери в темі й тілі замінені на реальні значення (номер тікета, статус, посилання).
- Лист надсилається навіть тоді, коли у клієнта немає підключених каналів, але в його профілі є email.