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

Важно: на хостинге, где установлен модуль должен быть доступен Telegram.

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

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

Основные возможности

События и адресация

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

Доставка

- Очередь в базе данных с приоритетами: заказы обрабатываются раньше обычных уведомлений.
- Повторные попытки с экспоненциальной задержкой и джиттером, опциональный circuit breaker.
- Ограничение частоты отправки по боту и по чату, общее для веб-процессов и CLI.
- Разбивка длинных сообщений с учетом лимита Telegram в 4096 символов.
- Проверка HTML- и Markdown-разметки перед отправкой с откатом на обычный текст.
- Inline-кнопки со ссылками на сущность в административной части.

Получатели

- Реестр известных чатов с поиском, переименованием, проверкой и включением/отключением.
- Пополнение реестра тремя способами: кнопка в настройках, webhook, CLI-команда.
- Ручное подтверждение новых чатов либо автоматическое одобрение.
- Автоотключение получателя при устойчивых ошибках Telegram: блокировка бота, удаление из чата, недостаток прав.
- Импорт и экспорт получателей в CSV и JSON с предварительным просмотром до записи.

Шаблоны

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

Диагностика и эксплуатация

- Журнал доставок: событие, сайт, бот, получатель, HTTP-статус, код ошибки, длительность запроса, «retry_after», «message_id».
- Аналитика по успешности доставок, ботам, HTTP-статусам и топу ошибок.
- Проблемные уведомления с возвратом в очередь по одному или списком.
- Журнал административных действий.
- Страница проверки модуля: состояние таблиц, настроек, очереди и webhook, экспорт отчета в JSON и support bundle без секретов.
- Настраиваемые сроки хранения для всех журналов.

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

- Токен бота хранится в зашифрованном виде либо берется из переменной окружения.
- Ротация webhook secret без простоя: предыдущее значение принимается заданное время.
- Защита от повторной обработки одного и того же «update_id».
- Маскирование персональных данных в журналах и выгрузках.
- Разграничение прав.

Интерфейсы в админке

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

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