AWZ: Письма в Telegram, ver. 1.0.11

Модуль awz.mailtotg интегрируется в систему обработки почтовых событий Bitrix CMS и предоставляет функциональность для:


Перехвата почтовых событий: Модуль использует обработчик события OnBeforeEventSend, который срабатывает перед отправкой любого почтового уведомления из системы Bitrix.


Отправки в Telegram: Скомпилированное сообщение из шаблона письма конвертируется в формат, совместимый с Telegram API, и отправляется в настроенный чат или канал.


Умной конвертации HTML: Модуль содержит расширенную систему преобразования HTML-разметки в текстовый формат для Telegram с сохранением поддерживаемых тегов форматирования (жирный текст, курсив, ссылки, код и другие).


Блокировки отправки писем: Есть возможность настроить модуль так, чтобы он полностью блокировал отправку оригинального письма, отправляя уведомление только в Telegram.


Системы прав доступа: Модуль включает полноценную систему управления правами на основе ролевой модели Bitrix, позволяя ограничивать доступ к настройкам модуля.


Особенности работы


Модуль устанавливается через стандартный механизм установки модулей Bitrix. При установке:

• Создаются необходимые таблицы в базе данных для хранения прав доступа
  
• Регистрируются обработчики событий
  
• Устанавливаются компоненты для управления правами
  

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


Настройки и параметры


Модуль предоставляет настройки через административный интерфейс Bitrix (Настройки → Настройки модулей → awz.mailtotg).


Основные параметры:

• Токен бота (TGKEY) - API токен бота Telegram, полученный от @BotFather
  
• ID чата (TGID) - Уникальный идентификатор чата или канала, куда будут отправляться сообщения
  

Настройка почтовых событий:


Модуль позволяет настроить поведение для каждого типа почтового события отдельно:

• Активность - включение отправки уведомления в Telegram для данного типа события
  
• Блокировка - включение режима, при котором оригинальное письмо не отправляется, а уведомление пересылается только в Telegram
  

В интерфейсе настроек отображается список всех активных почтовых шаблонов системы с возможностью включения/отключения пересылки для каждого из них.


Права доступа:


Модуль использует систему прав доступа Bitrix:

• Просмотр настроек - право на просмотр страницы настроек
  
• Редактирование настроек - право на изменение параметров модуля
  
• Управление правами - право на настройку прав доступа для пользователей и групп