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:

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