Telegram-сповіщення і Viber/SMS покупцям для OpenCart

Модуль робить дві речі. Надсилає події магазину OpenCart вам у Telegram — нове замовлення, зміну статусу, падіння залишку товару. І, з версії 1.1.0, повідомляє покупця у Viber або SMS, коли його замовлення змінює статус: «прийнято», «відправлено, ТТН 2045…», «скасовано».

Telegram-сповіщення для вас лишаються безкоштовними, як і раніше. Повідомлення покупцям у Viber і SMS — Pro-функція: вона працює через ваш акаунт у TurboSMS, Alpha SMS або SMS-Fly, а перші 7 днів Pro відкриваються кнопкою в налаштуваннях модуля без оплати.

Як це виглядає для покупця

Покупець оформлює замовлення як завжди, нічого додаткового заповнювати не треба — використовується телефон, який він і так вказує на checkout. Щойно менеджер переводить замовлення в статус, для якого ви ввімкнули повідомлення, покупець отримує у Viber від імені вашого магазину короткий текст. Якщо Viber на номері нема або повідомлення не доставлене, сервіс сам надсилає той самий текст через SMS.

• В обробці: «Мій магазин: Олена, замовлення #64 прийнято, сума 1 250 грн. Дякуємо!»
• Відправлено: «Мій магазин: замовлення #64 відправлено. ТТН: 20450000000000» — номер ТТН модуль бере з коментаря, який менеджер додає разом зі зміною статусу.

Кожен статус надсилається покупцю один раз: якщо замовлення повернули в «В обробці» і знову перевели далі, або менеджер двічі натиснув «Додати історію», другого платного повідомлення не буде.

Як це працює — крок за кроком

1. Менеджер змінює статус замовлення в адмінці (або платіжний модуль переводить його автоматично) — OpenCart викликає подію додавання історії замовлення.
2. Модуль перевіряє, чи для цього статусу ввімкнено повідомлення, чи активний Pro і чи цьому покупцю вже надсилали цей статус.
3. Номер телефону приводиться до міжнародного формату E.164 за країною замовлення: 093 123 45 67 у замовленні з України стає 380931234567, +48 731 234 567 — польським номером, а номер без коду читається як номер країни з адреси замовлення, а не вгадується за першими цифрами.
4. За країною номера обирається альфа-імʼя для SMS і відправник для Viber; для решти країн діє рядок *=.
5. Текст збирається за вашим шаблоном: {tracking_number} — перше число з 11–14 цифр у коментарі до статусу, {comment} — сам коментар. Рядок, у якому всі теги порожні, просто випадає.
6. Спершу в журнал пишеться рядок «надсилається» — тому паралельне збереження того самого статусу не дасть дубля. Далі йде запит до сервісу, і в журналі зʼявляється ID повідомлення або причина відмови.

Що під капотом

• Три інтеграції за офіційною документацією сервісів: TurboSMS (message/send.json, гібрид Viber+SMS), Alpha SMS (JSON-протокол, тип viber+sms), SMS-Fly (REST API v2, канали ["viber","sms"]).
• Ключ сервісу і токен бота зберігаються зашифрованими; поле ключа ніколи не показує збережене значення.
• Ліцензія і налаштування Viber/SMS лежать в окремій групі налаштувань — звичайне «Зберегти» на вкладці Telegram їх не зачіпає, і навпаки.
• Повідомлення покупцю працює, навіть якщо Telegram-сповіщення вимкнені: це дві незалежні частини одного модуля.
• Помилка сервісу ніколи не ламає оформлення замовлення чи зміну статусу в адмінці — вона лише записується в журнал.
• Номери в журналі масковані (+38093***4567).
• У збірці для OpenCart 3 зʼєднання з базою тимчасово перемикається на utf8mb4, щоб emoji в Telegram-шаблонах не ставали «?».

Завантаження

• Для OpenCart 4.x — cc_telegram.ocmod.zip, версія 1.1.1
• Для OpenCart 3.0.x — cc_telegram-oc3-1.1.2.ocmod.zip, версія 1.1.2
• Для OpenCart 2.3.0.x — cc_telegram-oc2-1.0.4.ocmod.zip, версія 1.0.4, лише Telegram-сповіщення (без Viber / SMS)

Як встановити

1. Адмінка → Розширення → Встановлення розширень → «Завантажити» → оберіть архів своєї версії OpenCart. Попередню версію можна оновити поверх — налаштування Telegram зберігаються.
2. В OpenCart 3: Розширення → Модифікатори → «Оновити». В OpenCart 4 цей крок не потрібен.
3. Розширення → Розширення → тип «Модулі» → «Telegram Order Notifications» → «Встановити» (якщо ще не встановлено), далі «Редагувати».
4. Для Telegram: вставте токен бота з @BotFather, натисніть «Знайти chat_id» і надішліть тест.
5. Для покупців: вкладка Viber / SMS покупцям → «Почати 7 днів безкоштовно» або вставте куплений ключ.
6. Оберіть сервіс, вставте ключ API, канал, альфа-імена за країнами (UA=МійМагазин, *=МійМагазин), позначте статуси й за потреби змініть тексти. Натисніть «Перевірити ключ і баланс», потім надішліть тест на свій номер.