Модуль отправляет уведомления о событиях сайта в 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. Проверьте доставку в разделе «Журнал доставок».
По любым вопросам просим обращаться на почту: support@kmtr.net
Режим работы службы поддержки: Пн. – Вс.: с 9:00 до 20:00
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.