Документация BILLmanager 6

Шаблоны сообщений

BILLmanager имеет встроенную систему уведомлений. Она используется для оповещения пользователей о важных событиях: автоматическое продление услуги, подтверждение регистрации, необходимость пополнить лицевой счет и т.п. Уведомления (сообщения) создаются и отправляются автоматически. Текст сообщений строится на основе EJS-шаблонов.

Чтобы задать шаблоны, перейдите в раздел НастройкиШаблоны сообщений → выберите тип шаблона → кнопка Шаблоны.

Все сообщения делятся на типы, в зависимости от способа отправки:

  • Email сообщения;
  • SMS сообщения;
  • Сообщения в меню уведомления;
  • Сообщения для мессенджеров.

Настройка шаблона

Каждый шаблон можно назначить только одному провайдеру. Если провайдер не выбран, то шаблон сообщения будет использоваться всеми провайдерами, у которых не назначен персональный шаблон. 

Шаблоны сообщений поддерживают локализацию. Настроить локализованный шаблон можно только для активных встроенных локализаций. Каждая локализация шаблона может использовать разную разметку.

Страница редактирования шаблона сообщения:

Отписаться от рассылки

Чтобы добавить к шаблону сообщения возможность отписаться от рассылки:

  1. Перейдите в раздел НастройкиШаблоны сообщенийEmail сообщения → кнопка Шаблоны.
  2. Измените имеющийся шаблон сообщений или Создайте новый.
  3. Добавьте к шаблону код.

    <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;
  • Отправка акта выполненных работ;
  • Регистрация нового пользователя;
  • Уведомление о создании плательщика.

Безопасность

Изоляция окружения

Начиная с версии 6.124, для защиты от уязвимостей шаблоны формируются в изолированной среде. При установке или обновлении BILLmanager устанавливается пакет ПО billmanager-plugin-template-processor. Этот пакет:

  1. Устанавливает среду контейнеризации:
    • в ОС Ubuntu и Astra Linux — Docker;
    • в ОС AlmaLinux — Podman.
  2. Скачивает образ со скриптами для безопасного формирования шаблонов.

Вы можете отключить использование изолированной среды. Например, если шаблоны формируются некорректно. Для этого:

  1. Добавьте в конфигурационный файл /usr/local/mgr5/etc/billmgr.conf опцию Option DisableTemplateProcessor. Подробнее см. статью Конфигурационный файл.
  2. Перезапустите платформу: 
    /usr/local/mgr5/sbin/mgrctl -m billmgr -R

Дата последнего обновления статьи: 10.06.2025. Статья подготовлена техническими писателями ISPsystem.