BILLmanager имеет встроенную систему уведомлений. Она используется для оповещения пользователей о важных событиях: автоматическое продление услуги, подтверждение регистрации, необходимость пополнить лицевой счет и т.п. Уведомления (сообщения) создаются и отправляются автоматически.
Все сообщения делятся на типы, в зависимости от способа отправки:
- Email-сообщения;
- SMS-сообщения;
- Сообщения в меню уведомления;
- Сообщения для мессенджеров.
Текст сообщений строится на основе EJS-шаблонов. Чтобы задать шаблоны, перейдите в раздел Настройки → Шаблоны сообщений → выберите тип шаблона → кнопка Шаблоны.
Настройка шаблона
Каждый шаблон можно назначить только одному провайдеру. Если провайдер не выбран, то шаблон сообщения будет использоваться всеми провайдерами, у которых не назначен персональный шаблон.
Шаблоны сообщений поддерживают локализацию. Настроить локализованный шаблон можно только для активных встроенных локализаций. Каждая локализация шаблона может использовать разную разметку.
Предпросмотр шаблона
Вы можете просмотреть, как будет выглядеть итоговое сообщение, отправленное получателю.
Чтобы включить панель предпросмотра, нажмите на значок на панели инструментов формы редактирования. В открывшемся окне будет показан результат обработки шаблона с учётом выбранной локализации и применённой разметки.
Чтобы отключить панель предпросмотра, нажмите на значок 
.
Тестовые данные для предпросмотра
Чтобы увидеть сообщение с реальными значениями переменных:
- Включите панель предпросмотра.
- Нажмите на значок
. - Нажмите на значок
. - Выберите объект для генерации данных. Например, пользователя, услугу или платёж.
- Нажмите Ок.
Система автоматически заполнит шаблон соответствующими данными, что позволит проверить корректность работы переменных перед сохранением шаблона.
Если нужно, отредактируйте JSON вручную и нажмите на область предпросмотра, чтобы применить изменения.
Отписка от рассылки
Чтобы добавить к шаблону сообщения возможность отписаться от рассылки:
- Перейдите в раздел Настройки → Шаблоны сообщений → Email сообщения → кнопка Шаблоны.
- Измените имеющийся шаблон сообщений или Создайте новый.
-
Добавьте к шаблону код.
<a href="<%- billurl %>?func=unsubscribe&cmdhash=<%= cmdhash %> target="_blank">текст_ссылки</a>
<div id="unsubscribe"> <hr size="1" color="#D5D5D5"/> Вы получили это письмо, потому что зарегистрированы на сайте <%= project.name %>. Вы можете отписаться от всех новостей компании <%= project.name %>, тем самым вы подтвердите, что отказываетесь получать уведомления обо всех значимых событиях и изменениях в работе сервиса, включая вопросы финансового и юридического характера.<br/><br/> Я осознаю возможные последствия и хочу <a href="<%- billurl %>?func=unsubscribe&cmdhash=<%= cmdhash %>" style="color:#666" target="_blank">отписаться от новостей</a>. </div>
Типы уведомлений, от которых нельзя отписаться:
- Восстановление пароля;
- Инструкция по восстановлению пароля по Email;
- Уведомление об успешном восстановлении пароля;
- Нарушения. Уведомление о приближении срока устранения нарушения;
- Нарушения. Уведомление о достижении предельного срока устранения нарушения;
- Нарушения. Уведомление о превышении максимально допустимого количества баллов нарушений;
- Уведомление об ошибках при регистрации профилей услуги;
- Активация email адреса;
- Экспорт персональных данных;
- Шлюзы. Уведомление о необходимости подтверждения адреса электронной почты;
- Шлюзы. Уведомление о невозможности однозначно идентифицировать клиента по Email адресу;
- Шлюзы. Уведомление об успешном подтверждении адреса электронной почты;
- Шлюзы. Уведомление о невозможности создания запроса по причине отсутствия свободных обращений;
- Шлюзы. Ошибка проверки отправителя сообщения;
- Проверка плательщика по email;
- Проверка учетной записи по email;
- Отправка акта выполненных работ;
- Регистрация нового пользователя;
- Уведомление о создании плательщика.
Копирование сообщений в другие каналы уведомлений
Вы можете дублировать сообщения через все настроенные шлюзы уведомлений. Например, SMS или Telegram. Для этого включите в шаблоне опцию Копировать в уведомления. Чтобы включить опцию:
- Перейдите в главном меню в раздел Настройки → Шаблоны сообщений → Email сообщения → кнопка Шаблоны.
- Выберите шаблон Сообщение от провайдера → Изменить.
- Включите опцию Копировать в уведомления.
- Нажмите Ок.
Если нужно отправлять сообщения только по email или настроить отдельные рассылки, выключите опцию.
Например, вам нужно организовать отдельные рассылки для разных каналов связи:
- для email — с HTML-разметкой и полным оформлением;
- для Telegram — с текстовой разметкой, адаптированной под конкретный канал.
Для этого:
- Отключите опцию Копировать в уведомления.
- Создайте отдельные рассылки или настройте отдельные шаблоны сообщений специально для мессенджеров .
Безопасность
Изоляция окружения
Начиная с версии 6.124, для защиты от уязвимостей шаблоны формируются в изолированной среде. При установке или обновлении BILLmanager устанавливается пакет ПО billmanager-plugin-template-processor. Этот пакет:
- Устанавливает среду контейнеризации:
- в ОС Ubuntu и Astra Linux — Docker;
- в ОС AlmaLinux — Podman.
- Скачивает образ со скриптами для безопасного формирования шаблонов.
Вы можете отключить использование изолированной среды. Например, если шаблоны формируются некорректно. Для этого:
- Добавьте в конфигурационный файл /usr/local/mgr5/etc/billmgr.conf опцию
Option DisableTemplateProcessor. Подробнее см. статью Конфигурационный файл. - Перезапустите платформу:
/usr/local/mgr5/sbin/mgrctl -m billmgr -R