Транспорты уведомлений (Telegram / MAX) (EcomLabs)

Что умеет решение

Модуль отправляет уведомления о событиях Битрикс (включая почтовые и SMS-события) в мессенджеры Telegram и MAX. Функционал включает шаблоны текстов, очередь сообщений с повторами, журнал событий, привязку чатов пользователей к ботам, вебхуки и тестовые инструменты.

Доступ к управлению осуществляется через меню административной панели: «Транспорты уведомлений» (разделы: Шаблоны, Очередь, Журнал, Привязки, Инструменты / Тест). Глобальные настройки модуля находятся в разделе: Настройки → Настройки продукта → Настройки модулей → Транспорты уведомлений (Telegram / MAX).

Конфигурация разделена на три вкладки: Общие, Telegram и MAX.

Вкладка «Общие» содержит параметры:

- Число попыток отправки: количество повторов отправки сообщения из очереди при возникновении ошибки.

- TTL токена привязки (в минутах): срок действия одноразового токена deep-link для связывания чата пользователя с ботом.

- Размер пакета очереди: количество заданий, обрабатываемых агентом за один запуск.

- Предпочитаемый мессенджер: выбор приоритета (Telegram, MAX или отсутствие предпочтения) при наличии у пользователя нескольких активных привязок.

Вкладка «Telegram» включает настройки:

- Включить Telegram: активация или отключение канала доставки.

- Токен бота Telegram: ключ, полученный через @BotFather.

- Имя бота (без @): username для формирования ссылок t.me/..., который можно автоматически определить через инструмент «Проверить бота».

- Секрет webhook: secret_token для верификации входящих запросов от Telegram.

Модуль транспортов уведомлений eComLabs обеспечивает интеграцию с Telegram и платформой MAX. Для Telegram доступна настройка отключения предпросмотра ссылок при отправке, указание ручного идентификатора чата администратора для тестов и админ-уведомлений, а также использование публичного вебхука для чтения по адресу bitrix/tools/ecl_eventtransports_webhook_telegram.php.

Для платформы MAX предусмотрены опции включения или отключения канала, ввода токена доступа бота и имени бота для глубоких ссылок и отображения. Настройка включает секрет вебхука для проверки входящих запросов, ручной идентификатор чата администратора и URL API по умолчанию platform-api2.max.ru. При отсутствии доверия к цепочке сертификатов, включая сертификаты Минцифры, можно отключить проверку SSL. Шаблон глубокой ссылки содержит плейсхолдеры #BOT# и #TOKEN# для привязки. Система позволяет настроить текст ответа бота после успешной привязки и приветственное сообщение для запросов без токена. Также доступен публичный вебхук MAX только для чтения.

В административной панели доступен раздел шаблонов уведомлений для каналов Telegram и MAX. Здесь можно просматривать список шаблонов, создавать и редактировать их, привязывая к коду события Битрикс (SMS или почта), задавая текст сообщения и управляя активностью.

Модуль «Транспорты уведомлений (Telegram / MAX)» от eCom Labs управляет отправкой сообщений через каналы Telegram и MAX. Коды событий автоматически подтягиваются из типов почтовых и SMS-событий сайта. Действует правило: для каждой пары «код события + транспорт» создается отдельный шаблон. При срабатывании обработчиков OnBeforeEventSend, OnBeforeEventAdd или OnBeforeSmsSend модуль добавляет задание в очередь, если найден соответствующий шаблон и установлена привязка получателя.

Очередь заданий (queue_list) содержит информацию о канале, событии, пользователе, заказе, идентификаторе чата, статусе (Новая, Повтор, Отправлено, Ошибка), количестве попыток, тексте ошибки и дате. Доступны действия: повторная отправка или удаление записи. Обслуживание очереди выполняет агент \Ecl\EventTransports\Service\QueueService::agent().

Журнал (log_list) фиксирует историю попыток отправки с указанием успеха или ошибки, канала, события, идентификатора чата, связи с записью очереди и даты. Записи журнала можно удалять.

Привязки (bindings_list) связывают пользователей системы Битрикс с идентификаторами чатов в Telegram и MAX. Для каждой привязки доступен статус (активна или отключена) и возможность удаления.

В разделе инструментов и тестов отображаются URL вебхуков для Telegram и MAX. Для Telegram доступны проверки: получение информации о боте (getMe), настройка вебхука, проверка его статуса и удаление. Для MAX доступны: настройка вебхука, получение информации о боте (/me), проверка статуса вебхука и его удаление.

Модуль «Транспорты уведомлений (Telegram / MAX)» от eCom Labs обеспечивает управление связями между пользователями Битрикс и мессенджерами. Основные функции включают генерацию ссылок для привязки по идентификатору пользователя и типу транспорта, обновление статуса соединения, процедуру отвязки, а также тестовую отправку произвольных сообщений привязанным аккаунтам. При отсутствии настроенного вебхука доступна ручная привязка через MAX user_id или Telegram chat_id.

В карточке пользователя, в разделе настроек, добавлена вкладка «Мессенджеры». Она отображает текущий статус привязки для Telegram и MAX, а также содержит кнопки для инициирования привязки или разрыва связи.

Компонент ecl:eventtransports.bind, называемый «Привязка к Telegram / MAX», предназначен для размещения в личном кабинете или профиле пользователя. Он позволяет управлять подключениями мессенджеров. Параметры компонента позволяют включать или отключать отображение Telegram и MAX независимо друг от друга; по умолчанию оба показаны.

Компонент функционирует только для авторизованных пользователей. Интерфейс отображает статус соединения (привязан или не привязан) и идентификатор чата. Действия по привязке и отвязке выполняются через AJAX-запрос к файлу ecl_eventtransports_user_bind_ajax.php в директории tools. При нажатии кнопки «Привязать» система может сформировать глубокую ссылку на бота с одноразовым токеном, срок действия которого настраивается в параметрах модуля. После перехода пользователя в бота и подтверждения действия вебхук фиксирует привязку в базе данных.

Модуль подключается через визуальный редактор или программным вызовом компонента ecl:eventtransports.bind. В разделе инструментов доступны проверки: тестирование токена Telegram-бота через метод getMe и получение информации о боте MAX через команду /me. Успешный ответ подтверждает валидность токена и доступность API; для Telegram имя бота может быть автоматически сохранено в настройках. Webhook для Telegram работает только по протоколу HTTPS; запросы по HTTP возвращают ошибку. Подписка на вебхуки настраивается на публичный URL модуля с использованием секретного токена из настроек. Статус вебхука, последние ошибки и количество ожидающих обновлений отображаются через соответствующие кнопки. Обработка входящих запросов выполняется скриптами в каталоге bitrix/tools: ecl_eventtransports_webhook_telegram.php и ecl_eventtransports_webhook_max.php. Эти скрипты проверяют секрет, обрабатывают данные привязки пользователя и создают или обновляют соответствующие записи. Тестовая отправка отправляет сообщение на идентификатор чата привязанного пользователя, проверяя полный путь доставки от настроек через API мессенджера. Модуль также использует очередь и агенты для обработки событий.

Модуль eComLabs для отправки уведомлений через Telegram и MAX. При срабатывании события Битрикс система находит соответствующий шаблон и помещает задачу в очередь. Агент обрабатывает пакет сообщений с учётом количества попыток и размера группы, после чего фиксирует результат в журнале как успех или ошибку.

Для модуля «Транспорты уведомлений (Telegram / MAX) (EcomLabs)» General iT может выполнить установку, настройку и проверку работы в вашем проекте.