БАЗА ЗНАНЬ
PHP 5.6–8.3ionCube Loader 13+OpenCart / ocStore 2.3–3.x
Головна/Документація/Ручні повідомлення
Із картки клієнта або замовлення

Контрольована ручна відправка

Відкрийте спливне вікно, оберіть канал, застосуйте шорткоди, перевірте попередній перегляд і лише тоді відправляйте.

Безпечний порядок

  1. Перевірте телефон одержувача.
  2. Оберіть канал і резервне надсилання.
  3. Вставте шаблон або текст.
  4. Перевірте розгорнуті шорткоди та довжину.
  5. Надішліть повідомлення.
  6. Перевірте статус у звіті.
ПОВНА ІНСТРУКЦІЯ

Усі поля, варіанти та перевірки

Нижче наведено повний профільний розділ офіційної інструкції модуля, без скорочень і маркетингового переказу.

18. Ручна відправка з картки клієнта і замовлення

Ручна відправка потрібна, коли менеджер хоче написати одному конкретному клієнту без масової розсилки: уточнити дані, повідомити про оплату, доставку, комплектацію або іншу ситуацію по замовленню.

Це не окремий обхідний механізм. Надсилання йде через ті самі шлюзи, канали, резервне надсилання і звіт, що й інші повідомлення модуля.

Де знаходиться кнопка

МісцеДе шукатиЩо відкривається
Картка клієнтаУ правій частині форми клієнта.Попап Надіслати повідомлення з даними клієнта.
Перегляд замовленняБіля телефонного номера клієнта в таблиці даних замовлення.Попап Надіслати повідомлення з даними замовлення.

Кнопка відкриває компактне модальне вікно в стилі адмінки модуля. У вікні видно клієнта або номер замовлення, телефон, електронну пошту, доступні канали, поле адресата, текст повідомлення, шорткоди і попередній перегляд.

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

Як відправити повідомлення

  1. Відкрийте картку клієнта або перегляд замовлення.
  2. Натисніть Надіслати повідомлення.
  3. Виберіть канал: SMS, Viber або Telegram.
  4. Перевірте або змініть адресата.
  5. Напишіть текст повідомлення.
  6. За потреби вставте шорткоди з панелі під текстом.
  7. Перевірте попередній перегляд.
  8. Натисніть Надіслати повідомлення.
  9. Перевірте результат у попапі і вкладці Звіт.

Поля попапу

ПолеЩо робитьВажливо
КаналВибирає, через що піде повідомлення.Показані тільки канали, які увімкнені й дозволені в модулі.
Доступні каналиПоказує короткий список доступних каналів.Це інформаційний блок, а не окреме налаштування.
АдресатНомер телефону або Telegram-контакт отримувача.Для SMS/Viber використовуйте телефон. Для Telegram можна вказати телефон або @username.

| Повідомлення | Текст, який отримає клієнт. | Порожній текст не відправляється. Максимум - 2000 символів після підстановки шорткодів. | | Шорткоди | Клікабельні теги для підстановки даних клієнта або замовлення. | Остаточна підстановка виконується на сервері перед відправкою. | | Попередній перегляд | Показує, як виглядатиме текст після підстановки. | Це перевірка для менеджера; сервер усе одно рахує текст повторно. |

Канали і резервне надсилання

У списку каналів немає «мертвих» варіантів. Якщо Telegram не підключений або Viber недоступний для вибраного шлюзу, вони не показуються.

Для Viber і Telegram у спливному вікні враховується поточне налаштування резервного SMS. Якщо резервне надсилання ввімкнене, модуль може спробувати SMS як запасний канал за правилами провайдера і налаштувань модуля.

Важливо: якщо для Telegram вручну вказати @username, резервне SMS не використовується. Це нормально, бо @username не є телефонним номером, і відправляти SMS на нього технічно неможливо.

Шорткоди клієнта

ШорткодЩо підставляє
{customer_id}ID клієнта.
{firstname}Ім'я клієнта.
{lastname}Прізвище клієнта.
{email}Електронна пошта клієнта.
{telephone}Телефон клієнта.
{store_name}Назву магазину.
{store_url}URL магазину.

Шорткоди замовлення

ШорткодЩо підставляє
{order_id}ID замовлення.
{order_status}Поточний статус замовлення.
{order_date}Дату створення замовлення.
{order_total}Загальну суму замовлення у валюті замовлення.
{order_total_noshipping}Суму без доставки у валюті замовлення.
{firstname}Ім'я клієнта із замовлення.
{lastname}Прізвище клієнта із замовлення.
{email}Електронна пошта із замовлення.
{telephone}Телефон із замовлення.
{products}Список товарів із кількістю, опціями і ціною у валюті замовлення.
{payment_method}Спосіб оплати.
{shipping_method}Спосіб доставки.
{comment}Коментар до замовлення.
{store_name}Назву магазину.
{store_url}URL магазину.

Як працює шорткод {products}

{products} бере всі товари із замовлення. Якщо товарів багато, у повідомлення потрапляє весь список, а не тільки перший товар.

Для кожного товару підставляється:

  • назва товару;
  • вибрані опції товару;
  • кількість;
  • ціна у валюті, в якій було зроблено замовлення.

Приклад:

iPhone - 101.00 грн. x 1
- Колір: чорний
- Пам'ять: 128 GB

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

Довжина повідомлення і попередній перегляд

Лічильник у попапі рахує довжину тексту після підстановки шорткодів. Це важливо для {products}, бо один короткий тег може перетворитися на довгий список товарів з опціями.

Якщо після підстановки текст довший за 2000 символів, відправка блокується. Сервер перевіряє це повторно, тому обійти обмеження через браузер не вийде.

Безпечний порядок ручної відправки

  1. Перед першим реальним використанням протестуйте SMS на своєму номері.
  2. Перевірте, що потрібні канали показуються в попапі.
  3. Вставте шорткоди і подивіться попередній перегляд.
  4. Для замовлення з багатьма товарами перевірте {products} окремо.
  5. Після відправки відкрийте Звіт і переконайтеся, що запис створився.

Модуль використовує одноразовий службовий токен для попапу. Це захищає від подвійної відправки при випадковому повторному натисканні кнопки. Не оновлюйте сторінку під час відправки без потреби.

Потрібна швидка перевірка?Відкрити діагностику →
ПРЯМИЙ ЗВ’ЯЗОК

Потрібна адаптація або Telegram-сервер?

Зв’язок з автором модуля щодо сумісності, встановлення, нестандартної теми, оформлення замовлення та платного підключення Telegram-сервера.