КРАТКО О МОДУЛЕ
Модуль отправляет уведомления о событиях Битрикс (почтовые и SMS-события) в
Telegram и MAX: шаблоны текстов, очередь с повторами, журнал, привязка чатов
пользователей к ботам, webhook'и, тестовые инструменты.
Меню в админке: «Транспорты уведомлений» → Шаблоны, Очередь, Журнал, Привязки,
Инструменты / Тест.
Настройки модуля: Настройки → Настройки продукта → Настройки модулей →
Транспорты уведомлений (Telegram / MAX).
ОПИСАНИЕ ВСЕХ НАСТРОЕК
Три вкладки: Общие, Telegram, MAX.
Общие
• Число попыток отправки — сколько раз повторять отправку из очереди при ошибке.
• TTL токена привязки (мин.) — срок жизни одноразового токена deep-link для
привязки чата пользователя к боту.
• Размер пакета очереди — сколько заданий обрабатывает агент за один запуск.
• Предпочитаемый мессенджер — Telegram / MAX / «—» (без предпочтения). Используется, когда у пользователя несколько привязок.
Telegram
• Включить Telegram — вкл/выкл канал.
• Токен бота Telegram — токен от @BotFather.
• Имя бота (без @) — username для ссылок t.me/... (можно подтянуть через
«Проверить бота» в Инструментах).
• Секрет webhook — secret_token для проверки входящих запросов Telegram.
• Отключить превью ссылок — disable_web_page_preview при отправке сообщений.
• Chat ID администратора — ручной chat_id для тестов и админ-уведомлений.
• Публичный webhook — только для чтения: URL вида /bitrix/tools/ecl_eventtransports_webhook_telegram.php
MAX
• Включить MAX — вкл/выкл канал.
• Access token MAX — токен бота платформы MAX.
• Имя бота MAX — для deep-link и отображения.
• Секрет webhook MAX — проверка входящих webhook.
• Chat ID администратора MAX — ручной ID.
• URL API MAX — по умолчанию https://platform-api2.max.ru
• Отключить проверку SSL — если нет доверия к цепочке сертификатов (в т.ч. сертификаты Минцифры).
• Шаблон deep link — шаблон ссылки привязки, плейсхолдеры #BOT# и #TOKEN#.
• Текст после успешной привязки — ответ бота после успешного bind.
• Текст, если payload без токена — приветствие/подсказка без токена.
• Публичный webhook — URL webhook MAX (только чтение).
ОПИСАНИЕ СТРАНИЦ И ВОЗМОЖНОСТЕЙ АДМИНКИ
Шаблоны (templates_list / templates_edit)
• Список шаблонов уведомлений по каналам (Telegram / MAX).
• Создание и редактирование: привязка к коду события Битрикс (SMS или почта), текст сообщения, активность.
• Коды событий подтягиваются из типов почтовых событий и SMS-событий сайта.
• Правило: один код события + один транспорт = один шаблон.
• При срабатывании обработчиков OnBeforeEventSend, OnBeforeEventAdd, OnBeforeSmsSend модуль ставит задание в очередь, если есть подходящий шаблон и привязка получателя.
Очередь (queue_list)
• Список заданий: канал, событие, пользователь, заказ, chat_id, статус (Новая / Повтор / Отправлено / Ошибка), число попыток, текст ошибки, дата.
• Действия: повторить отправку, удалить.
• Обрабатывается агентом: \Ecl\EventTransports\Service\QueueService::agent()
Журнал (log_list)
• История попыток отправки: успех/ошибка, канал, событие, chat_id, связь с записью очереди, дата.
• Удаление записей.
Привязки (bindings_list)
• Связки «пользователь Битрикс ↔ chat_id» в Telegram / MAX.
• Статус: активна / отключена.
• Удаление привязок.
Инструменты / Тест (tools)
• Отображение URL webhook для Telegram и MAX.
• Telegram:
– проверить бота (getMe);
– подписать webhook;
– статус webhook;
– удалить webhook.
• MAX:
– подписать webhook;
– инфо о боте (/me);
– статус webhook
– удаление webhook.
• Генерация ссылки привязки для указанного ID пользователя Битрикс и транспорта.
• Обновление статуса привязки, отвязка.
• Тестовая отправка произвольного текста привязанному пользователю.
• Ручная привязка по MAX user_id / Telegram chat_id (если webhook ещё не настроен).
Карточка пользователя (настройки пользователя)
• Вкладка «Мессенджеры»: статус привязок Telegram и MAX, кнопки «Привязать» / «Отвязать» (options_user_settings).
КОМПОНЕНТ ecl:eventtransports.bind
Название: «Привязка к Telegram / MAX»
Назначение: блок в личном кабинете / профиле для привязки и отвязки мессенджеров.
Параметры компонента
• Показывать Telegram (SHOW_TELEGRAM) — Y/N, по умолчанию Y.
• Показывать MAX (SHOW_MAX) — Y/N, по умолчанию Y.
Возможности
• Работает только для авторизованного пользователя.
• Показывает статус: привязан / не привязан, chat_id.
• Кнопки «Привязать» / «Отвязать» через AJAX (/bitrix/tools/ecl_eventtransports_user_bind_ajax.php).
• При «Привязать» может выдать deep-link на бота с одноразовым токеном (TTL задаётся в настройках модуля).
• После перехода в бота и подтверждения webhook фиксирует привязку в БД.
Подключение: визуальный редактор или $APPLICATION->IncludeComponent('ecl:eventtransports.bind', '', [...]);
ОПИСАНИЕ РАБОТЫ ПРОВЕРКИ
Проверка токена бота
В разделе «Инструменты»:
• «Проверить Telegram-бота (getMe)»
• «Инфо о боте MAX (/me)»
Успешный ответ означает, что токен верный и API доступен. Для Telegram имя бота может автоматически сохраниться в настройки модуля.
Требование HTTPS
Webhook Telegram принимается только по HTTPS. При HTTP URL выдаётся ошибка о необходимости HTTPS.
Подписка webhook
• Telegram: setWebhook на публичный URL модуля с secret_token из настроек.
• MAX: подписка на URL модуля с секретом из настроек.
Статус webhook, last error, pending updates — через кнопки «Статус webhook».
Входящие webhook
Скрипты:
• /bitrix/tools/ecl_eventtransports_webhook_telegram.php
• /bitrix/tools/ecl_eventtransports_webhook_max.php
Проверяют секрет (и связанные проверки модуля), обрабатывают start/payload с токеном привязки, создают или обновляют запись привязки пользователя.
Тестовая отправка
Текст уходит в chat_id привязанного пользователя. Это проверка полного пути: Настройки → API мессенджера → привязка → доставка.
Очередь и агент
Событие Битрикс → найден шаблон → запись в очередь → агент с учётом числа попыток и размера пакета → запись в журнал (успех или ошибка).
ИНСТРУКЦИЯ ПО УСТАНОВКЕ ЧЕРЕЗ БИТРИКС МАРКЕТПЛЕЙС В АДМИНКЕ
1. Войти в административную часть сайта под пользователем с правами администратора.
2. Открыть раздел Marketplace:
• «Marketplace → Каталог решений» — для установки из каталога;
• или «Marketplace → Установка решений» / установка из загруженного пакета (если решение устанавливается из файла/архива — в зависимости от редакции).
3. Найти решение «Транспорты уведомлений (Telegram / MAX)» партнёра ООО «Иком Лабс» (модуль ecl.eventtransports), либо загрузить поставленный пакет решения.
4. Запустить установку модуля ecl.eventtransports.
5. Дождаться завершения.
6. После установки:
a) Настройки → Настройки продукта → Настройки модулей → модуль «Транспорты уведомлений…» — заполнить токены, включить нужные каналы, при необходимости секреты webhook и прочие параметры, сохранить.
b) Транспорты уведомлений → Инструменты / Тест:
– проверить бота;
– подписать webhook (сайт должен быть доступен по HTTPS).
c) Создать шаблоны под нужные коды событий (EVENT_NAME).
d) Разместить компонент ecl:eventtransports.bind в шаблоне профиля / личного кабинета либо пользоваться вкладкой «Мессенджеры» в карточке пользователя.
7. Проверка работоспособности:
• привязать тестового пользователя через компонент или Инструменты;
• выполнить тестовую отправку из Инструментов;
• при необходимости вызвать реальное событие (заказ и т.п.) и проверить разделы «Очередь» и «Журнал».
Удаление модуля
Marketplace / список модулей → удаление ecl.eventtransports.
На шаге удаления можно сохранить таблицы с данными модуля.
Требования
• Модуль main.
• Для событий интернет-магазина — соответствующие модули (sale и др.) и настроенные типы событий на сайте.
• Публичный HTTPS для корректной работы Telegram webhook.
Поддержка осуществляется по будням с 8:00 до 17:00 по московскому времени. Скорость ответа зависит от загруженности команды и сложности вопроса, но в среднем составляет 1-2 рабочих дня.
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.
