Уведомления в 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».

General iT поможет установить модуль, настроить его и проверить работу на твоём сайте.