man partner.notify

Уведомления в Telegram и MAX: установка и настройка

Установка

  1. Установите модуль из Маркетплейса («Marketplace → Каталог решений»). При установке создаются готовые правила: новый заказ, оплата, отмена, форма обратной связи.
  2. Создайте бота: - Telegram — напишите @BotFather команду /newbot и скопируйте токен; - MAX — создайте бота на платформе MAX для партнёров (business.max.ru, раздел «Чат-боты»). Токен доступен после модерации бота.
  3. Откройте «Сервисы → Уведомления в Telegram и MAX → Боты и чаты», вставьте токен на вкладке «Боты» и нажмите «Сохранить и проверить бота».

Требования: главный модуль 20.0+, PHP 7.4+, кодировка UTF-8. Для заказов нужен «Интернет-магазин», для веб-форм — «Веб-формы».

Подключение чатов

Напишите боту /start или добавьте бота в группу менеджеров и напишите там сообщение. На вкладке «Чаты» нажмите «Найти чаты», затем «Подключить» и «Отправить тест». Темы супергрупп Telegram модуль тоже находит. Чат можно добавить и вручную.

Правила уведомлений

В разделе «Правила уведомлений» включите нужные события и выберите почтовые события своих форм. Для каждого правила задайте чаты, условия (сайт, сумма, тип плательщика, доставка, оплата, статус) и шаблон сообщения.

Макросы шаблона: #ACCOUNT_NUMBER#, #PRICE#, #ITEMS#, #PHONE#, #EMAIL#, #DELIVERY#, #PAYMENT#, #COMMENT#, #ADMIN_LINK# и все поля почтового события. Предпросмотр показывает сообщение на последнем заказе.

Формы шаблона: Если форма отправляет письмо через почтовое событие Битрикс, выберите это событие в правиле. Имя события — в «Настройки → Почтовые события». Если форма отправляет письмо в обход почтовых событий, используйте правило «Веб-форма» или «Инфоблок».

Кнопки смены статуса

На вкладке «Кнопки в чате» включите кнопки, выберите статусы, впишите ID или @имена сотрудников и нажмите «Подключить webhook». Нужен адрес сайта с https:// и настоящим сертификатом — это требование Telegram и MAX. Без webhook модуль работает в режиме «только уведомления» с кнопкой «Открыть заказ в админке».

Повторная отправка и cron

Если мессенджер недоступен, модуль повторяет отправку 3 раза: через 1, 5 и 15 минут. Чтобы повторы работали и на сайтах с малой посещаемостью, переведите агенты на cron: «Настройки → Настройки продукта → Главный модуль → Агенты».

Удаление

При удалении модуль спросит, сохранить ли данные: настройки, чаты, правила, журнал. Webhook ботов снимается в любом случае.

man support

Если не работает

Пришлите версии Битрикс, PHP и модуля и текст ошибки из журнала отправок. Токены ботов не присылайте.

Поддержка

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть