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=МойМагазин, *=МойМагазин), отметьте статусы и при необходимости измените тексты. Нажмите «Проверить ключ и баланс», затем отправьте тест на свой номер.