Уведомления в MAX для OpenCart 4

Уведомления в MAX для OpenCart 4

Модуль присылает магазину сообщения в мессенджер MAX: новый заказ, смена статуса, регистрация покупателя, отзыв, заявка на возврат, письмо с формы «Контакты». Получатели — владелец, менеджеры, рабочие группы и каналы магазина, и каждый получает только те уведомления и только по тем магазинам, которые ему выбраны.

Для кого

Для магазинов, которые хотят узнавать о заказах сразу, а не из почты, и уже работают в MAX или переходят на него. Подключение получателя не требует поиска ID: человек открывает одноразовую ссылку на бота и нажимает «Начать».

Что приходит

• Новый заказ — когда покупатель подтвердил заказ: состав со списком товаров, опциями, количеством и ценой, доставка, оплата, адрес, комментарий, сумма.
• Смена статуса — только по выбранным статусам, в том числе из админки и от модулей оплаты; повторное сохранение заказа с тем же статусом второго сообщения не даёт.
• Незавершённое оформление — покупатель дошёл до подтверждения и ушёл: сообщение через заданное время, только если заказ так и не подтверждён.
• Товар заканчивается — остаток после заказа опустился до порога.
• Регистрация, отзыв, заявка на возврат, сообщение с формы «Контакты».

Возможности

• Шаблон текста для каждого уведомления, для каждого статуса заказа и для каждого языка: подстановки вставляются кнопками, предпросмотр собирается на последнем настоящем заказе магазина. Разметка MAX: жирный, курсив, выделение, заголовок, цитата, ссылки.
• Кнопка «Открыть заказ» (покупателя, отзыв, возврат, товар) под сообщением или ссылкой в тексте: без входа в админку сначала откроется страница входа, после входа — нужная страница.
• Получатели: личные чаты по ссылке, группы и каналы — кнопкой «Найти чаты бота»; у каждого — свои уведомления, магазины и режим «без звука»; «Тест» проверяет доставку сразу.
• Очередь: сообщение сначала записывается и не теряется, если MAX недоступен; повторы с нарастающей паузой, учёт ограничений MAX на частоту. Покупатель не ждёт отправку — она идёт в конце запроса, не дольше нескольких секунд; остальное дочищает следующая страница магазина или планировщик.
• Длинное сообщение делится на части по правилам MAX, теги в частях не разрываются.
• Журнал доставки: что, кому и когда ушло, что не доставлено и почему, «Отправить ещё раз»; блок состояния — бот, последняя отправка, ошибки за сутки, очередь.
• Сертификат API MAX выдан Минцифры — модуль проверяет соединение по своему файлу корневых сертификатов, настраивать хостинг не нужно. Есть необязательный прокси и свой адрес API.
• Язык сообщений выбирается отдельно от языка витрины; данные покупателя всегда приходят текстом и не ломают разметку.
• Руководство пользователя — вкладкой на странице модуля.

Как подключить

1. «Расширения → Установщик» → загрузите max_notify_oc4.ocmod.zip (имя файла не менять) → «Установить».
2. «Расширения → Расширения → Прочее» → установите «Уведомления в MAX» и откройте модуль (он есть и в меню «Система»).
3. Вставьте токен бота из кабинета MAX для партнёров, нажмите «Проверить бота», включите статус.
4. На вкладке «Получатели» нажмите «Получить ссылку», откройте её в MAX и нажмите «Начать». Для групп и каналов добавьте туда бота и нажмите «Найти чаты бота».

Модуль работает на событиях OpenCart: файлы ядра не меняются, модификаторов нет. Для повторов каждую минуту в руководстве есть адрес для планировщика хостинга.

Совместимость и ограничения

• Проверено: OpenCart 4.1.0.4 и сборка OCM Store 4.1.0.4, PHP 8.2, на настоящем боте MAX.
• Нужны бот MAX (создают организации, ИП и самозанятые в кабинете для партнёров), расширение PHP cURL и доступ сервера к platform-api2.max.ru.
• Модуль читает обновления бота, чтобы подключать получателей: бот с webhook другого сервиса подойдёт только для ручного добавления получателей по ID.
• Уведомления получает магазин; сообщения покупателям в эту версию не входят. Сторонние оформления заказа, которые не записывают историю заказа штатно, и другие версии OpenCart 4 не проверялись.

Список изменений

1.0.0 — первая версия: восемь уведомлений магазину, получатели по ссылке и через «Найти чаты бота», шаблоны по статусам и языкам с предпросмотром, очередь с повторами, журнал доставки, свой файл сертификатов Минцифры, прокси, руководство вкладкой.