Шаблоны уведомлений
Шаблоны уведомлений настраиваются администратором в разделе Уведомления (/notification-templates, пункт меню Система → Уведомления). Шаблон описывает тему и тело письма, которое затем используется в бизнес-процессах и автоматизациях.
Список шаблонов
Таблица шаблонов показывает: ID, Название, Код, Тема письма, действия (редактировать, дублировать, удалить). Кнопка Создать открывает форму нового шаблона.
Создание и редактирование шаблона
- На странице Уведомления нажмите Создать (или откройте существующий шаблон для редактирования)
- Заполните поля
- Настройте тему и тело письма
- Сохраните
Поля шаблона
| Поле | Описание |
|---|---|
| Friendly Name (название) | Понятное название шаблона, например «Заявка создана» |
| Unique Code (код) | Уникальный технический идентификатор шаблона; генерируется автоматически из названия (транслитерация), но можно задать вручную. После создания шаблона код менять нельзя |
| Email Subject (тема письма) | Текст темы письма, поддерживает переменные |
| HTML Body (тело письма) | Содержимое письма — редактируется в визуальном редакторе |
Код шаблона — это то значение, по которому шаблон вызывается из автоматизаций и бизнес-процессов (см. ниже).
Редактор тела письма
Тело письма редактируется в редакторе с тремя режимами:
| Режим | Назначение |
|---|---|
| Visual | Визуальный WYSIWYG-редактор (форматирование текста, списки, ссылки, изображения, таблицы) |
| HTML | Редактирование исходного HTML-кода письма |
| Preview | Предпросмотр письма с тестовыми данными и отправка тестового письма |
Изображения, вставленные в визуальном режиме (через буфер обмена, перетаскивание или диалог выбора файла), автоматически загружаются на сервер, чтобы оставаться доступными после отправки письма получателям.
Переключение из режима HTML в Visual редактирует только содержимое письма — блок <head>/<style> в исходном HTML при этом отбрасывается, поэтому для писем с собственными стилями лучше работать в режиме HTML.
Подстановка переменных
В теме и теле письма используется синтаксис (или с пробелами). И в поле темы, и в редакторе тела есть выпадающий список + Insert variable для вставки переменной в место курсора без ручного набора синтаксиса.
Список предлагаемых переменных собирается из:
- Набора часто используемых переменных:
id,name,title,status,task_name,entity.number,date - Переменных, которые уже встречаются в теме или теле письма (если их вписали вручную)
Конкретный набор значений зависит от того, что передаёт вызывающая автоматизация или шаг процесса — система не ограничивает шаблон фиксированным списком полей.
Проверка шаблона
В режиме Preview можно:
- Указать тестовые данные в формате JSON (поля подставляются вместо переменных)
- Посмотреть тему и тело письма с подставленными значениями
- Указать email и нажать Send test email — придёт настоящее письмо с тестовыми данными
Где используются шаблоны
Шаблон не привязывается к событию прямо на своей странице — у него нет поля «триггер». Привязка происходит там, где шаблон применяется:
- Шаг бизнес-процесса «Уведомление» — в конструкторе процессов узел содержит список каналов отправки: push в интерфейс и любые настроенные исходящие каналы (почта, telegram, SMS, вебхук, брокер). У каждой строки свои получатели (пользователь, роль, переменная процесса или поле сущности) и своё сообщение — готовый шаблон по коду либо произвольный текст с переменными; строка без своего сообщения отправляет общее сообщение узла
- Скрипты автоматизаций — шаблон вызывается по коду через
$api->sendEmail('код_шаблона', получатель, переменные)
Таким образом один и тот же шаблон можно использовать в разных процессах и автоматизациях, просто указывая его код.
Каналы
Шаблоны в этом разделе формируют email-сообщения. Для push-уведомлений внутри системы и Telegram текст указывается либо тоже через шаблон (где это предусмотрено шагом процесса), либо как произвольный текст с переменными прямо в настройках шага. Общее описание каналов и того, как пользователь включает их у себя в профиле — в разделе Каналы уведомлений.