GitHub - https://github.com/azahalski/awz.mailtotg/
Маркетплейс 1с-Битрикс:
https://marketplace.1c-bitrix.ru/solutions/awz.mailtotg/
Краткое описание
Модуль позволяет автоматически отправлять уведомления из системы Bitrix в Telegram канал или чат. Перехватывает стандартные почтовые события и пересылает их содержимое в Telegram с возможностью настройки фильтрации и блокировки отправки оригинальных писем.
Подробное описание
Модуль 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:
- Просмотр настроек - право на просмотр страницы настроек
- Редактирование настроек - право на изменение параметров модуля
- Управление правами - право на настройку прав доступа для пользователей и групп
