Telegram-уведомления и Viber/SMS покупателям для WooCommerce

Плагин делает две вещи. Отправляет события магазина WooCommerce вам в Telegram — новый заказ, смену статуса, неудачную оплату, низкий остаток, заявки с форм. И, начиная с версии 1.3.0, сообщает покупателю в Viber или SMS, когда его заказ меняет статус: «принят», «отправлен, ТТН 2045…», «отменён».

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

Как это выглядит для покупателя

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

• В обработке: «CatCode Demo Store: заказ #868 принят, сумма ₴2,038.00. Спасибо!»
• Выполнен: «заказ #868 отправлен. ТТН: 20450000000000» — номер подставляется из модулей Новой Почты и Укрпочты или из любого поля заказа.

Каждый статус отправляется одному покупателю один раз: повторное сохранение заказа в админке или двойной вызов от платёжного шлюза второго сообщения не дают.

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

1. Покупатель оформляет заказ; WooCommerce переводит его в статус, например «В обработке».
2. Плагин проверяет, включены ли сообщения для этого статуса и активен ли Pro, и помечает пару «заказ + статус» как поставленную в очередь.
3. Отправка идёт в фоне через Action Scheduler, встроенный в WooCommerce, — оформление заказа не ждёт ответа сервиса.
4. Номер телефона приводится к международному формату E.164 по стране заказа: 093 123 45 67 в заказе из Украины становится 380931234567, +48 731 234 567 — польским номером, а 9 цифр без кода читаются как номер страны заказа, а не угадываются по первым цифрам.
5. По стране номера выбирается альфа-имя для SMS и отправитель для Viber; для остальных стран действует строка *=.
6. Текст собирается по вашему шаблону; строка, в которой все теги пустые (например «ТТН:» без номера), просто выпадает.
7. Сервис принимает сообщение — в заказе появляется приватная заметка с ID, в журнале строка «OK». Если сервис недоступен, через 5 минут одна повторная попытка; отказ сервиса (неправильное альфа-имя, нет средств) плагин не повторяет — он виден в журнале.

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

• Три интеграции по официальной документации сервисов: TurboSMS (message/send.json, гибрид Viber+SMS), Alpha SMS (JSON-протокол, тип viber+sms), SMS-Fly (REST API v2, каналы ["viber","sms"], ttl в минутах).
• Ключ сервиса и токен бота хранятся зашифрованными; поле ключа никогда не показывает сохранённое значение.
• Лицензия и настройки SMS лежат в отдельных опциях — обычное «Сохранить» на вкладке Telegram их не затрагивает.
• Защита от двойной отправки: состояние «в очереди / отправляется / отправлено» пишется в мета заказа до вызова сервиса.
• Номера в журнале маскированы (+38093***4567).
• Фильтры для разработчика: cc_tgnotify_sms_countries (добавить страну), cc_tgnotify_sms_tracking_number (ТТН из другого источника), cc_tgnotify_sms_api_url (тестовый стенд).

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

1. Плагины → Добавить новый → Загрузить плагин → выберите архив telegram-order-notifications-for-woocommerce-1.3.1.zip → «Установить» → «Активировать». Предыдущую версию можно обновить поверх — настройки Telegram сохраняются. Версия из каталога WordPress.org содержит только Telegram-уведомления; вкладка Viber / SMS есть в архиве с этой страницы.
2. Для Telegram: WooCommerce → Telegram-уведомления, вставьте токен бота из @BotFather, найдите chat_id и отправьте тест.
3. Для покупателей: вкладка Viber / SMS покупателям → «Начать 7 дней бесплатно» или вставьте купленный ключ.
4. Выберите сервис, вставьте ключ API, канал, альфа-имена по странам (UA=МойМагазин, *=МойМагазин).
5. Отметьте статусы, для которых отправлять сообщения, и при необходимости измените тексты. Нажмите «Проверить ключ и баланс», затем отправьте тест на свой номер.