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).