Модуль Messaging (SMS повідомлення) для OkayCMS

Модуль надсилає клієнтам SMS про доставку Новою Поштою. Повідомлення відправляються через TurboSMS або SMS Club автоматично (коли працює планувальник задач OkayCMS).

На даний момент модуль відправляє SMS лише про стан доставки Новою Поштою і для роботи потребує встановлений модуль devSviat/NovaPoshtaTracking-OkayCMS (у OkayCMS це Sviat/NovaPoshtaTracking).

Можливості

SMS про доставку Новою Поштою

Можна окремо увімкнути/вимкнути кожне повідомлення:

• Замовлення відправлено — коли посилка “в дорозі”.
• Прибуло у відділення / поштомат — коли посилка приїхала.
• Нагадування через 48 год — тільки для наложки; якщо посилка прибула і пройшло 48 годин.
• Завтра платне зберігання — для наложки або замовлень від 1000 грн; на 6-й день після прибуття.

Підтримка провайдерів

• TurboSMS — потрібні токен і ім’я відправника (в адмінці також показується баланс).
• SMS Club — потрібні Bearer токен і ім’я відправника (в адмінці також показується баланс).

Контроль відправки SMS

• Модуль веде журнал SMS (що відправилось, що з помилкою, що пропущено).
• Є захист від частих SMS: на один номер — не частіше ніж раз на годину.
• Якщо сталася помилка — модуль спробує ще раз (до 3 спроб).

Вимоги

• OkayCMS v4.5.2
• Встановлений та налаштований модуль Sviat/NovaPoshtaTracking (devSviat/NovaPoshtaTracking-OkayCMS)
• Аккаунт у TurboSMS або SMS Club
• Для автоматичної роботи — має бути налаштований планувальник задач OkayCMS (scheduler/cron)

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/Messaging-OkayCMS.git Messaging

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/Messaging/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «Messaging (SMS повідомлення)» → Натисніть «Встановити».

Налаштування

1. Перейдіть в адмін-панель → Модулі → SMS / Повідомлення (Нова Пошта).
2. В блоці Провайдер SMS оберіть провайдера і заповніть дані доступу:
   • TurboSMS: токен і ім’я відправника
   • SMS Club: Bearer токен і ім’я відправника
3. Увімкніть потрібні типи SMS:
   • ✅ Замовлення відправлено
   • ✅ Прибуло у відділення
   • ✅ Нагадування через 48 год
   • ✅ Завтра платне зберігання
4. Натисніть «Застосувати».

Використання

Як відправляються SMS

• Модуль бере статуси накладних Нової Пошти з Sviat/NovaPoshtaTracking.
• Коли статус змінився — модуль відправляє SMS (якщо цей тип SMS увімкнений).

Автоматична робота (крон/планувальник)

Модуль працює через планувальник задач OkayCMS:

• відправка SMS — приблизно раз на 20 хв
• повтор при помилках — приблизно раз на 15 хв

Якщо планувальник не налаштований — SMS не будуть відправлятися автоматично.

Важливо

• Якщо модуль Sviat/NovaPoshtaTracking не встановлений або вимкнений, SMS про доставку не будуть відправлятися.
• Модуль може пропустити повідомлення, якщо на цей номер уже була SMS протягом останньої години (захист від спаму).

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT