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

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

Новый заказ, смена статуса, регистрация, отзыв, заявка на возврат, письмо с формы «Контакты» — бот магазина сразу пишет об этом в Telegram. Сообщения получают владелец и менеджеры в личных чатах, рабочие группы (в том числе отдельная тема группы) и каналы сотрудников, и каждый — только по своим уведомлениям и магазинам.

Кому пригодится

Магазинам, где заказы нужно брать в работу сразу, а почта читается с опозданием. Владелец видит продажи с телефона, склад получает только новые заказы в свою тему группы, руководитель — всё. Chat ID искать не нужно: получатель подключается одноразовой ссылкой на бота.

Уведомления

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

Возможности

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

Установка и первая настройка

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

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

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

• Проверено на OpenCart 4.1.0.4 и сборке OCM Store 4.1.0.4 с PHP 8.2, доставка — на настоящем боте: личный чат по ссылке и вручную, группа по ссылке, канал через «Найти чаты бота».
• Нужны бот Telegram, расширение PHP cURL и доступ сервера к api.telegram.org (напрямую, через прокси или свой сервер Bot API).
• Модуль читает обновления бота, чтобы подключать получателей: для уведомлений нужен бот без webhook другого сервиса.
• Уведомления получает магазин; сообщения покупателям в эту версию не входят. Сторонние оформления заказа без штатной истории заказа и другие версии OpenCart 4 не проверялись.

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

1.0.0 — первая версия: восемь уведомлений магазину, подключение по ссылке (личные чаты, группы и темы, каналы), шаблоны по статусам и языкам с предпросмотром, очередь с повторами, журнал доставки, прокси и свой адрес Bot API, руководство вкладкой.