Фонова черга, правила, журнал і cron

13. Відкладені події#

Відкладені події - це повідомлення, які модуль надсилає не одразу, а через заданий час.

Приклади:

• через 10 хвилин після нового замовлення нагадати про оплату;
• через 1 день після доставки попросити відгук;
• через 2 години після реєстрації без замовлення надіслати бонус;
• через 30 хвилин після зміни статусу повідомити адміністратора.

13.1 Правила#

Збільшити ↗

Правило описує, коли створити відкладене повідомлення, кому його надіслати і за яких умов.

Логіка правила проста:

1. Подія відбувається в магазині.
2. Модуль перевіряє умови правила.
3. Якщо умови підходять, модуль створює завдання в черзі.
4. Завдання чекає свого часу.
5. Cron запускається і відправляє завдання.
6. Результат потрапляє в журнал і звіт.

Якщо cron не налаштований, завдання може з'явитися в черзі, але не буде відправлене. Це часта причина проблеми: правило є, текст є, але клієнт нічого не отримує, бо серверний cron не запускається.

Як створити правило#

1. Відкрийте Відкладені події -> Правила.
2. Натисніть Додати правило.
3. Вкажіть Назва правила.
4. Увімкніть правило.
5. Виберіть Подія.
6. Виберіть Отримувач.
7. Заповніть умови, якщо вони потрібні.
8. Вкажіть затримку і одиницю часу.
9. Виберіть канал надсилання.
10. Напишіть текст повідомлення.
11. Натисніть Зберегти.

Події#

Що важливо: події Зміна статусу замовлення і Нове замовлення працюють із замовленнями, тому для них доступні умови по сумі, товарах, категоріях, виробниках і статусах. Подія Після реєстрації без замовлення перед відправкою ще раз перевіряє, чи клієнт справді не зробив покупку.

Отримувачі#

Для Довільного номера можна вказати один або кілька номерів через кому. Для Адміністратора використовуються контакти з поля Телефон адміністратора. Для Клієнта модуль бере телефон із замовлення або профілю.

Умови#

ID товарів, категорій і виробників вводяться через кому. Якщо не знаєте ID, відкрийте товар, категорію або виробника в адмінці OpenCart і подивіться ID в адресі сторінки.

Як читати умови:

• порожні умови означають “працює для всіх”;
• Будь-який статус означає, що правило не прив'язане до конкретного статусу;
• Будь-яка група означає, що група клієнта не важлива;
• Сума від без Сума до означає “від цієї суми і вище”;
• Сума до без Сума від означає “до цієї суми”;
• якщо одночасно задані товари, категорії і виробники, правило стає вузьким, тому тестуйте його на реальному тестовому замовленні.

Час і повтори#

Що означає панель готовності планувальника#

У вкладці відкладених подій модуль показує, чи готовий планувальник до роботи.

Статистика Очікують, Надіслані, Скасовані, Помилки показує загальний стан завдань. Якщо Помилки ростуть, не запускайте нові масові правила, поки не зрозуміли причину.

Приклади правил#

13.2 Черга завдань#

Збільшити ↗

Черга показує повідомлення, які вже створені, але ще не відправлені.

Очищення черги не видаляє історію. Завдання переходять у статус Скасовано.

Статуси завдань у черзі та журналі#

Якщо відкладена SMS/Viber-задача вперлась у бюджетний ліміт, модуль не вважає це помилкою провайдера. Завдання лишається в черзі, отримує next_attempt_at приблизно через 30 хвилин, а в таймлайні зʼявляється подія Очікує бюджет / budget_wait. Лічильник спроби доставки від цього не збільшується.

У черзі видно номер завдання, правило, телефон, короткий текст, час відправки, наступну спробу, кількість спроб і таймлайн. Таймлайн потрібен, щоб зрозуміти шлях завдання: створено, відкладено, очікує бюджет, перенесено, скасовано, відправлено або впало з помилкою.

13.3 Журнал#

Збільшити ↗

Журнал показує завершені, скасовані або помилкові завдання.

Журнал не є чергою. Якщо очистити журнал, активні очікуючі завдання не зникнуть.

Причини в журналі#

13.4 Cron#

Збільшити ↗

Cron потрібен, щоб відкладені повідомлення реально відправлялися. Без cron правило може створити завдання, але воно не піде клієнту.

Справний cron також прискорює завершення оформлення замовлення: модуль швидко ставить звичайні повідомлення покупцю й адміністратору в чергу, а зовнішній SMS, Viber або Telegram-сервіс викликається вже у фоновому запуску. Якщо модуль не бачить успішного завершення cron понад 10 хвилин, він автоматично повертається до синхронної відправки, щоб не втратити повідомлення. У такому резервному режимі оформлення може тривати довше через швидкість зовнішнього сервісу.

Як налаштувати cron#

1. Відкрийте Відкладені події -> Cron / Налаштування.
2. Увімкніть статус планувальника.
3. Скопіюйте Cron URL.
4. Передайте URL хостингу або додайте його в панелі cron.
5. Запускайте URL кожні 1-5 хвилин.
6. Після запуску перевірте Стан cron, Останній старт, Останнє завершення.

Поля cron#

Шаблон повідомлення хостингу:

Потрібно налаштувати cron для OpenCart-модуля SAP - SMS / OTP Pro.
Запускайте Cron URL з вкладки "Відкладені події -> Cron / Налаштування" кожні 1-5 хвилин.
Метод запуску: звичайний HTTP-запит за цим URL.