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. Позначте статуси, для яких надсилати повідомлення, і за потреби змініть тексти. Натисніть «Перевірити ключ і баланс», потім надішліть тест на свій номер.