man partner.notify
Уведомления в Telegram и MAX: установка и настройка
Установка
- Установите модуль из Маркетплейса («Marketplace → Каталог решений»). При установке создаются готовые правила: новый заказ, оплата, отмена, форма обратной связи.
- Создайте бота:
- Telegram — напишите @BotFather команду
/newbotи скопируйте токен; - MAX — создайте бота на платформе MAX для партнёров (business.max.ru, раздел «Чат-боты»). Токен доступен после модерации бота. - Откройте «Сервисы → Уведомления в 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 и модуля и текст ошибки из журнала отправок. Токены ботов не присылайте.