Уведомления в Telegram
Технические данные
Дата публикации:
15.08.2026
Версия:
1.0.0
Адаптивность:
Да
Поддержка композита:
Да
Число установок:
Менее 50 раз
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
- Программа для ЭВМ "1С-Битрикс24". Лицензия Интернет-магазин + CRM (12 мес.)
Описание
Уведомления о заказах, пользователях, контенте и веб-формах сайта в 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».
Инструкция
1. Установите модуль через стандартный менеджер модулей.
(Откройте «Маркетплейс» → «Установленные решения», выберите «Уведомления в Telegram» и нажмите «Установить»)
2. После установки в разделе «Сервисы» появится страница «Уведомления в Telegram».
(Также доступен путь «Настройки → Настройки продукта → Настройки модулей → Уведомления в Telegram»)
Первичная настройка
Создание бота Telegram
1. Откройте в Telegram диалог с [@BotFather] (https://t.me/BotFather).
2. Отправьте команду «/newbot» и следуйте подсказкам.
3. Скопируйте выданный токен вида «123456789:AAE...».
Токен бота
1. Откройте «Сервисы» → «Уведомления в Telegram» → «Настройки».
2. На вкладке «Общие» вставьте токен в поле «Токен бота Telegram».
3. Сохраните настройки.
4. Нажмите «Проверка подключения»: должны заполниться имя и ID бота.
Токен хранится в базе в зашифрованном виде.
Получатели
Telegram не отдает список чатов бота, поэтому чат должен проявить себя первым.
Для личного чата:
1. Откройте диалог с ботом и нажмите «Начать».
2. Отправьте боту команду «/id» - бот вернет готовое значение для настроек.
Для группы или канала:
1. Добавьте бота в группу или канал и выдайте право отправки сообщений.
2. Отправьте в чат любое сообщение или команду «/id».
Полученное значение вставьте на вкладке «Общие» в поле получателей нужной категории.
Запись «@sales_team» - это ссылка на пользовательский список получателей, созданный в настройках модуля, а не имя пользователя Telegram. Личному пользователю нельзя отправить сообщение по «@username»: требуется числовой chat_id.
Если бот уже получал сообщения, список можно наполнить кнопкой «Загрузить список чатов из бота» в сервисном разделе настроек.
События
1. Перейдите на вкладку «События».
2. Включите нужные события: заказы, пользователи, инфоблоки, веб-формы, системные.
3. При необходимости укажите отдельных получателей для категории события.
4. Тексты сообщений правятся на вкладке «Шаблоны», там же доступен предпросмотр.
5. На вкладке «Общие» задайте «Базовый URL сайта», иначе ссылки на заказы в сообщениях будут относительными.
Обработка очереди
Уведомления складываются в очередь и отправляются фоново. Для продуктовой эксплуатации настройте cron, агент Битрикса оставьте резервным вариантом.
Проверка
1. Откройте «Сервисы» → «Уведомления в Telegram» → «Проверка модуля». Общий статус должен быть без замечаний.
2. Выполните целевое действие на сайте, например оформите тестовый заказ.
3. Проверьте доставку в разделе «Журнал доставок».
1. Установите модуль через стандартный менеджер модулей.
(Откройте «Маркетплейс» → «Установленные решения», выберите «Уведомления в Telegram» и нажмите «Установить»)
2. После установки в разделе «Сервисы» появится страница «Уведомления в Telegram».
(Также доступен путь «Настройки → Настройки продукта → Настройки модулей → Уведомления в Telegram»)
Первичная настройка
Создание бота Telegram
1. Откройте в Telegram диалог с [@BotFather] (https://t.me/BotFather).
2. Отправьте команду «/newbot» и следуйте подсказкам.
3. Скопируйте выданный токен вида «123456789:AAE...».
Токен бота
1. Откройте «Сервисы» → «Уведомления в Telegram» → «Настройки».
2. На вкладке «Общие» вставьте токен в поле «Токен бота Telegram».
3. Сохраните настройки.
4. Нажмите «Проверка подключения»: должны заполниться имя и ID бота.
Токен хранится в базе в зашифрованном виде.
Получатели
Telegram не отдает список чатов бота, поэтому чат должен проявить себя первым.
Для личного чата:
1. Откройте диалог с ботом и нажмите «Начать».
2. Отправьте боту команду «/id» - бот вернет готовое значение для настроек.
Для группы или канала:
1. Добавьте бота в группу или канал и выдайте право отправки сообщений.
2. Отправьте в чат любое сообщение или команду «/id».
Полученное значение вставьте на вкладке «Общие» в поле получателей нужной категории.
Запись «@sales_team» - это ссылка на пользовательский список получателей, созданный в настройках модуля, а не имя пользователя Telegram. Личному пользователю нельзя отправить сообщение по «@username»: требуется числовой chat_id.
Если бот уже получал сообщения, список можно наполнить кнопкой «Загрузить список чатов из бота» в сервисном разделе настроек.
События
1. Перейдите на вкладку «События».
2. Включите нужные события: заказы, пользователи, инфоблоки, веб-формы, системные.
3. При необходимости укажите отдельных получателей для категории события.
4. Тексты сообщений правятся на вкладке «Шаблоны», там же доступен предпросмотр.
5. На вкладке «Общие» задайте «Базовый URL сайта», иначе ссылки на заказы в сообщениях будут относительными.
Обработка очереди
Уведомления складываются в очередь и отправляются фоново. Для продуктовой эксплуатации настройте cron, агент Битрикса оставьте резервным вариантом.
Проверка
1. Откройте «Сервисы» → «Уведомления в Telegram» → «Проверка модуля». Общий статус должен быть без замечаний.
2. Выполните целевое действие на сайте, например оформите тестовый заказ.
3. Проверьте доставку в разделе «Журнал доставок».
Поддержка решения «Уведомления в Telegram» осуществляется компанией Kommutator.net.
По любым вопросам просим обращаться на почту: support@kmtr.net
Режим работы службы поддержки: Пн. – Вс.: с 9:00 до 20:00
По любым вопросам просим обращаться на почту: support@kmtr.net
Режим работы службы поддержки: Пн. – Вс.: с 9:00 до 20:00
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
пример: https://www.site.ru
