Telegram-уведомления о заказах для OpenCart 2.3, 3.x и 4.x

Модуль отправляет события вашего магазина OpenCart в Telegram: новый заказ, смену статуса и падение остатка товара. Менеджер видит заказ за секунды после оформления — в телефоне, без почты и без входа в админку.

Работает через вашего собственного бота, созданного в @BotFather: токен хранится зашифрованным в вашей базе, а сообщения идут напрямую в Telegram. Никаких промежуточных сервисов, никакой подписки — модуль полностью бесплатный, код открытый.

Что получает админ

Как это работает — шаг за шагом

1. Покупатель оформляет заказ в витрине.
2. Заказ попадает в один из статусов, которые вы отметили как «новый заказ».
3. Модуль собирает сообщение по вашему шаблону: номер, состав заказа, сумма, контакты покупателя, способ оплаты и доставки.
4. Сообщение идёт во все указанные чаты; в каждом есть ссылка, открывающая заказ в админке.
5. Дальше, когда статус меняется на один из отмеченных — приходит короткое сообщение «было → стало».
6. Результат каждой отправки записывается в журнал; неудачные попытки повторяются.

Что включено

• Новый заказ — объявляется один раз, когда заказ впервые попадает в выбранный статус (повторные изменения его не дублируют).
• Смена статуса — отдельный список статусов, чтобы в чат не летело лишнее.
• Низкий остаток — проверяется после списания склада; не чаще чем одно сообщение на товар в сутки.
• Несколько чатов — личный чат, группа, канал, тема форум-группы.
• Собственные шаблоны — 20+ тегов; строка, все теги которой пусты, автоматически исчезает из сообщения.
• Тихие сообщения, журнал отправок, повторная попытка через крон.
• Кнопка «Найти chat_id» — ID чата определяется прямо в админке, сторонние боты не нужны.

Сколько стоит

Бесплатно, без ограничений по количеству доменов. Код открытый — обе сборки лежат на GitHub.

Технические требования

• OpenCart 3.0.2 – 3.0.5.0 или 4.0.2 – 4.1.x
• PHP 7.4+ с cURL
• Исходящий доступ к api.telegram.org (у некоторых хостеров закрыт — проверьте, если тест не проходит)
• Для повторных попыток отправки — крон. В OpenCart 4 задача регистрируется сама; в OpenCart 3 планировщика нет, поэтому адрес для крона хостинга показан прямо в настройках модуля

Что под капотом

• Токен бота шифруется перед записью в настройки, в форме показывается как «сохранено».
• Сообщения отправляются в режиме HTML с выключённым превью ссылок; длинные тексты обрезаются до лимита Telegram (4096 символов).
• Значения тегов экранируются — имя покупателя с символом < не сломает разметку сообщения.
• Дедупликация «нового заказа» на уровне журнала: событие фиксируется до отправки, поэтому дубль невозможен даже при двойном срабатывании.
• В сборке для OpenCart 3 соединение с базой временно переключается на utf8mb4 — иначе ядро OpenCart 3 (работающее в 3-байтном utf8) превращает emoji в шаблонах в «?».

Загрузки

• Для OpenCart 4.x — cc_telegram.ocmod.zip
• Для OpenCart 3.0.x — cc_telegram-oc3.ocmod.zip

Как установить

1. Админка → Расширения → Установка расширений → «Загрузить» → выберите архив своей версии OpenCart.
2. Нажмите «Установить» и дождитесь завершения; далее Расширения → Модификаторы → «Обновить».
3. Расширения → Расширения → тип «Модули» → найдите «Telegram Order Notifications» → «Установить», далее «Редактировать».
4. Создайте бота: напишите @BotFather команду /newbot и скопируйте токен.
5. Вставьте токен, напишите боту любое сообщение и нажмите «Найти chat_id».
6. Вставьте ID в поле «Чаты для уведомлений», отправьте тестовое сообщение, отметьте нужные статусы и сохраните.

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

1.0.2 (сборка OpenCart 3) — 6 августа 2026

Сборку для OpenCart 3 дотянули до возможностей четвёртой: повторная отправка неудачных сообщений по расписанию (счётчик попыток и собственный лимит, текст формируется заново из актуального заказа), уведомление о низком остатке не чаще одного на товар в сутки. 🔴 Исправлено: открытие настроек показывало «?» вместо emoji в шаблонах, и сохранение записывало эти «?» в базу — теперь обе стороны читают шаблон отдельным запросом в utf8mb4. Также в хлебных крошках светился служебный ключ вместо слова «Главная».

1.0.2 — 3 августа 2026

Поддержка PHP 7.4 (добавлены полифилы строковых функций), в исходники приведено исправление событий из 1.0.1. Функционально для магазинов на PHP 8 ничего не изменилось.

1.0.1 — 24 июля 2026

🔴 Исправлено: на OpenCart 4.0.2.x уведомления не отправлялись совсем. Ядро формирует название модельного события по-разному в минорных версиях (4.0.2 через слеш, 4.1 через точку), поэтому триггер с точкой не срабатывал — и никакой ошибки при этом не было. Теперь разделитель записан звёздочкой и работает на всех 4.x.

1.0.0 — 20 июля 2026

Первый релиз. Уведомления о новых заказах, смене статуса и низком остатке; собственные шаблоны с 20+ тегами, несколько чатов и темы форум-групп, тихий режим, журнал отправок, повторная попытка через крон, зашифрованный токен бота. Отдельные сборки для OpenCart 4.x и 3.0.x, обе проверены на живых демо (4.1.0.3 и 3.0.5.0).