Уведомления в Telegram

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

Модуль «Уведомления в Telegram» от Kommutator.net предназначен для отправки оповещений о событиях сайта в мессенджер Telegram. Для корректной работы на хостинге должен быть обеспечен доступ к серверам Telegram.

Система отслеживает и уведомляет о новых и оплаченных заказах, смене их статусов, регистрации пользователей, публикации контента, заполнении веб-форм и других системных событиях. Настройка производится через административный интерфейс без необходимости программирования.

Функционал адресации и событий

Включает готовый каталог событий для интернет-магазина, пользователей, инфоблоков, веб-форм и системных процессов. Для каждой категории событий и каждого сайта в многосайтовой конфигурации можно настроить отдельных получателей. Поддерживается создание пользовательских списков, которые можно применять к нескольким категориям одновременно. Доступны фильтры по инфоблокам и веб-формам для отправки уведомлений только по нужным сущностям. При необходимости потоки можно разделить, назначив отдельного бота для каждой категории событий.

Механизм доставки

Используется очередь в базе данных с системой приоритетов, обеспечивающая обработку заказов раньше обычных уведомлений. Реализованы повторные попытки доставки с экспоненциальной задержкой и джиттером. Опционально доступен механизм circuit breaker для защиты от перегрузок.

Модуль уведомлений Telegram обеспечивает надежную доставку сообщений с учетом ограничений платформы. Частота отправки ограничена на уровне бота и конкретного чата, что применяется как для веб-процессов, так и для CLI. Длинные тексты автоматически разбиваются на части, чтобы не превышать лимит в 4096 символов. Перед отправкой система проверяет корректность HTML и Markdown-разметки; при обнаружении ошибок текст переключается на обычный формат без форматирования. В интерфейсе администратора доступны inline-кнопки для перехода к соответствующим сущностям.

Управление получателями

В системе ведется реестр известных чатов с возможностью поиска, переименования, проверки статуса и включения или отключения. Список пополняется тремя способами: через кнопку в настройках, с помощью webhook или CLI-команды. Новые чаты могут подтверждаться вручную или одобряться автоматически. Если бот блокируется, удаляется из чата или теряет права, получатель автоматически отключается для предотвращения устойчивых ошибок. Поддерживается импорт и экспорт списка получателей в форматах CSV и JSON с предварительным просмотром данных перед записью.

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

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

Диагностика и мониторинг

Журнал доставок фиксирует ключевые параметры каждого события: тип события, сайт, бот, получатель, HTTP-статус, код ошибки, длительность запроса, а также значения retry_after и message_id.

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

Доступна страница проверки модуля для оценки состояния таблиц, настроек, очереди и вебхука, а также экспорта отчета в формате JSON и support bundle без секретных данных. Для всех журналов настраиваются сроки хранения.

Безопасность и приватность

Токен бота хранится в зашифрованном виде или берется из переменной окружения. Ротация секретного ключа вебхука выполняется без простоя: предыдущее значение принимается в течение заданного времени. Реализована защита от повторной обработки одного и того же update_id. Персональные данные автоматически маскируются в журналах и выгрузках. Доступно разграничение прав пользователей.

Интерфейсы в административной панели

Раздел «Сервисы → Уведомления в Telegram».

Раздел «Настройки → Настройки продукта → Настройки модулей → Уведомления в Telegram».

Для «Уведомления в Telegram» команда General iT может выполнить подключение, настройку и контрольную проверку после установки.