cat ~/modules/notify/README.md

Заказы в Telegram и MAX

Новый заказ, оплата или заявка с формы приходят в чат менеджеров. С составом, суммой и телефоном. Статус меняется кнопкой под сообщением.

Скоро на Маркетплейсе partner.notify v1.0.0 Проверено: Битрикс «Бизнес» 26.150PHP 8.2UTF-8

Любая редакция с главным модулем 20.0+. Заказы — с модулем «Интернет-магазин», веб-формы — с модулем «Веб-формы».

Скоро на Маркетплейсе Посмотреть демо Документация
partner.notify

cat why.md

Зачем

  • Заявки приходят на почту и теряются между рассылками.
  • В письме только «Поступил заказ №…». Чтобы перезвонить, надо лезть в админку.
  • Заказы должны видеть несколько менеджеров, а письмо уходит одному.
  • Команда переехала в MAX.

diff before.md after.md

После установки

Сейчас

  • Письмо без подробностей.
  • Статус меняют только в админке.

С модулем

  • В чате: состав, сумма, телефон, e-mail, доставка, оплата, комментарий. Под сообщением — «Открыть заказ в админке».
  • Менеджер жмёт «Оплачен». Статус в админке меняется, а в сообщении появляется «Оплачен — Иван, 14:05».
  • Формы, которые шлют почтовое событие Битрикса, тоже приходят в чат. Со всеми полями.

ls ~/modules/notify/features

Что умеет

Куда

  • Telegram: личка, группы, темы супергрупп.
  • MAX: личные и групповые чаты.
  • Сразу в несколько чатов. У каждого правила свои.
  • chat_id искать не надо: пишете боту /start, жмёте «Найти чаты».

О чём

  • Новый заказ, оплата, отмена, смена статуса.
  • Любое почтовое событие — FEEDBACK_FORM, формы шаблона.
  • Результат веб-формы, регистрация, новый элемент инфоблока — например отзыв.

Правила

  • Условия по заказу: сайт, сумма, тип плательщика, доставка, оплата, статус. Скажем, крупные заказы — в чат руководителя.
  • Шаблоны с макросами #ITEMS#, #PRICE#, #PHONE#, #ADMIN_LINK# и полями почтового события.
  • Предпросмотр шаблона на последнем реальном заказе.

Кнопки статуса

  • Нажимают только сотрудники из белого списка — по ID или @имени.
  • Кто и когда нажал, пишется в журнал.
  • Нужен webhook, а значит HTTPS. Без него — только уведомления.

Если мессенджер лёг

  • При оформлении заказа сообщение только ставится в очередь. Отправка — в фоне.
  • Не ушло — три повтора: через 1, 5 и 15 минут.
  • Журнал отправок с фильтром и кнопкой «Отправить ещё раз». Телефоны и почта в нём скрыты.

ls screenshots/

Скриншоты

cat ~/modules/notify/install.md

Установка

  1. Установить

    Правила на новый заказ, оплату, отмену и форму обратной связи создадутся сами.

  2. Создать бота

    Telegram — у @BotFather. MAX — на платформе для партнёров. Токен вставить в настройки.

  3. Подключить чат

    Написать боту /start или добавить в группу. «Найти чаты» → «Подключить» → «Отправить тест».

zelenkindev@bitrix: ~

cat TESTING.md

Совместимость

ПараметрЗначениеСтатус
Стенд«1С-Битрикс: Бизнес» 26.150, PHP 8.2, шаблон «Интернет-магазин»Проверено
Сценарииsale.order.ajax, форма обратной связи, веб-форма, инфоблок, регистрация, условие по сумме, кнопки статусаПроверено
Telegram и MAXТестовых ботов не было. Проверял на имитации Bot API, сделанной по документацииЧастично
Оформление заказаПостановка в очередь на стенде — 2–3 мс. С недоступным API оформление не замедлилосьПроверено
ТребованияГлавный модуль 20.0+, PHP 7.4+, UTF-8Требование
PHP 7.4 и 8.3Проверен синтаксис. Работа — на 8.2Частично
АспроФормы с почтовым событием подхватываются правилом «Почтовое событие». На стенде Аспро нетНе проверено

На публичную часть модуль ничего не выводит. Сообщения идут через Telegram Bot API и MAX Bot API, оба бесплатные. Бота MAX может создать организация, ИП или самозанятый — резидент РФ.

cat LICENSE

Лицензия

Продаётся на Маркетплейсе 1С-Битрикс. Цена, демо-период, продление — там. Возврат — по правилам Маркетплейса. Закодирована только защита демо-версии от Маркетплейса.

Скоро на Маркетплейсе

Цена — на Маркетплейсе 1С-Битрикс

notify --help

Вопросы

chat_id вводить вручную?

Не нужно. Напишите боту или добавьте его в группу и нажмите «Найти чаты». Темы супергрупп он тоже найдёт.

Telegram недоступен. Оформление заказа зависнет?

Нет. Во время оформления сообщение только встаёт в очередь. На стенде с недоступным API время оформления не изменилось.

Придут ли заявки с форм моего шаблона?

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

Разные заказы в разные чаты?

Да. У каждого правила свои чаты и условия.

Кто может менять статус?

Только те, кого вы внесли в список. Остальным бот откажет, попытка попадёт в журнал.

Почему нет кнопок статуса?

Им нужен webhook, а для него — сайт на HTTPS, доступный из интернета. Подключается на вкладке «Кнопки в чате».

Сайт маленький, посещаемость низкая. Повторы сработают?

Переведите агенты на cron. Тогда повторы не зависят от посетителей.

git log -3

Версии

  1. commit 5350185 (tag: v1.0.0, HEAD)

    Date:

    • Первая версия: Telegram и MAX; заказы, почтовые события, веб-формы, регистрация, инфоблоки.
    • Правила с условиями, шаблоны, мастер «Найти чаты».
    • Кнопки статуса, очередь с повторами, журналы.

Вся история версий

man support

Поддержка

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

Как обратиться в поддержку

mail zelenkindev

Вопросы по модулю

Пишите — отвечу сразу.

  • MAX

    QR-код: https://max.ru/u/f9LHodD0cOKhBt_X5KaDCt4SgZkqN6JkUnj_2fzv5KGWZyBjRqqFa8wa36E
    Наведите камеру телефона
    Открыть в MAX
  • Telegram

    QR-код: https://t.me/zelenkins
    Наведите камеру телефона
    Открыть в Telegram

man zelenkindev

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

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