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.
По любым вопросам просим обращаться на почту: info@conversite.ru
Режим работы службы поддержки: Пн. – Вс.: с 9:00 до 20:00
Уведомления о заказах, пользователях, контенте и веб-формах сайта в 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».
Закажите любой модуль у нас на сайте с бесплатной установкой и гарантией 14 дней
Мы работаем с физическими и юридическими лицами. И предоставляем сразу два варианта оплаты.
- Наличные. Вы подписываете товаросопроводительные документы, расплачиваетесь денежными средствами, получаете товар и чек.
- Безналичный расчет. Принимаем карты Visa и MasterCard. Доступен при курьерской доставке.
Ваш заказ можем доставить собственными ресурсами, при условии вашего нахождения в городе. Либо через 4 варианта доставки:
- Курьерская доставка. Курьерская доставка работает с 9:00 до 19:00. Когда товар поступит на склад, курьерская служба свяжется для уточнения деталей. Специалист предложит выбрать удобное время доставки и уточнит адрес.
- Самовывоз из магазина. Для получения заказа обратитесь к сотруднику в кассовой зоне и назовите номер.
- Сотрудничаем с постаматами. Срок хранения — 3 дня.
- Предоставляем почтовую доставку через почту России. Когда заказ придет в отделение, на ваш адрес придет извещение о посылке. Вскрывать коробку самостоятельно вы можете только после оплаты заказа.
Дополнительная вкладка для размещения информации о товарах, доставке или любого другого важного контента. Поможет вам ответить на интересующие покупателя вопросы и развеять его сомнения в покупке. Используйте её по своему усмотрению.
Вы можете убрать её или вернуть обратно, изменив одну галочку в настройках компонента. Очень удобно.
- Комментарии
- ВКонтакте