Перейти до змісту

Типи Повідомлень

Cascade API підтримує чотири базові типи повідомлень, кожен з яких оптимізований для різних сценаріїв використання на різних каналах.

Огляд

Тип Призначення Канали Інтерактивність
transaction Критичні сповіщення Усі Ні
promo Маркетингові кампанії Усі Так (кнопки)
viber_survey Опитування та відгуки Viber, SMS Так (варіанти)
flashcall Авторизація за дзвінком Лише голос Ні

Транзакційні Повідомлення (transaction)

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

Характеристики

  • Високий пріоритет доставки.
  • Жодних рекламних чи промо-елементів.
  • Лаконічні та прямі.
  • Обмежені в часі.
  • Маршрутизуються по ланцюгу: Telegram → Viber → RCS → SMS.

Випадки використання

  • Підтвердження замовлень і бронювань.
  • Повідомлення про списання та поповнення коштів.
  • Сповіщення безпеки облікового запису.
  • Статуси доставки посилок.
  • Скидання паролів.

Приклад

{
  "id": "tx-order-12345",
  "fromName": "YourStore",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "transaction",
  "text": "Замовлення #12345 підтверджено. Сума: 1200 грн. Очікувана доставка: 25 січня. Трекінг: https://example.com/track/12345",
  "ttl": 86400
}

Кращі Практики

  • ✅ Тримайте довжину в межах 160 символів, коли це можливо.
  • ✅ Надавайте конкретні деталі (суми, дати).
  • ✅ Надавайте посилання на трекінг.
  • ✅ Використовуйте діловий та зрозумілий стиль мовлення.
  • ❌ Не додавайте жодного маркетингового контенту (акції, знижки).
  • ❌ Уникайте зайвих емодзі.

Приклади за сценаріями

Підтвердження Замовлення

{
  "messageType": "transaction",
  "text": "Замовлення #12345 підтверджено. Разом до сплати: 1540 грн. Ми повідомимо вас, коли посилку буде надіслано."
}

Сповіщення про оплату

{
  "messageType": "transaction",
  "text": "Оплата покупки на суму 400.00 грн у магазині 'Store ABC' успішна. Код транзакції: TXN789. Залишок: 8500.00 грн"
}

Сповіщення Безпеки

{
  "messageType": "transaction",
  "text": "Виявлено новий вхід в акаунт з пристрою iPhone о 10:30 (Київ). Якщо це були не ви, негайно заблокуйте картку."
}

Статус доставки

{
  "messageType": "transaction",
  "text": "Ваша посилка прямує до вас! Кур'єр очікується між 14:00-16:00. Відстежуйте маршрут: https://track.example.com/PKG123"
}

Промо Повідомлення (promo)

Маркетингові та рекламні кампанії з графікою та інтерактивними елементами.

Характеристики

  • Підтримка мультимедіа та медіа-вмісту (в залежності від каналу).
  • Інтерактивні кнопки дії (Call to action).
  • Можливість використовувати довші значення TTL.
  • Маршрутизація: Telegram → Viber → RCS → SMS.

Випадки використання

  • Запуски нових продуктів чи колекцій.
  • Анонси розпродажів.
  • Запрошення на події.
  • Покинуті кошики (з промокодом).
  • Інформаційні розсилки.
  • Підвищення впізнаваності бренду.

Приклад

{
  "id": "promo-summer-sale",
  "fromName": "YourBrand",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "promo",
  "text": "🌟 Літній Розпродаж вже тут! Знижки до -50% на обрані товари. Замовляйте зараз: https://example.com/sale",
  "ttl": 259200
}

Застосування із Змінними (Variables)

{
  "messageType": "promo",
  "text": "Привіт %name=1%! Персональна пропозиція: Використайте код %name=2% та отримайте знижку -20%. Придбати: %short_url=1%",
  "variables": [
    {"id": 1, "type": "name", "value": "Олександре"},
    {"id": 2, "type": "name", "value": "VIP20"},
    {"id": 1, "type": "short_url", "value": "https://store.com/sale?utm=sms"}
  ]
}

Кращі Практики

  • ✅ Додавайте чіткий заклик до дії (CTA).
  • ✅ Використовуйте інтригуючий та цікавий текст.
  • ✅ Додавайте UTM-мітки або інші трекінгові параметри в посилання.
  • ✅ Персоналізуйте текст за допомогою змінних.
  • ❌ Не зловживайте розсилками (уникайте спам-ефекту).
  • ❌ Не вводьте користувачів в оману.

Приклади за сценаріями

Запуск Продукту

{
  "messageType": "promo",
  "text": "🎉 НОВИНКА КОЛЕКЦІЇ: iPhone 15 Pro вже в наявності! Оформлюйте замовлення зараз та отримайте безкоштовну доставку: https://store.com/iphone15"
}

Флеш-Розпродаж (Flash Sale)

{
  "messageType": "promo",
  "text": "⚡ Тільки 2 години! Додаткова знижка -30% на все. Ваш промокод: FLASH30. Переглянути каталог: https://store.com/flash"
}

Покинутий кошик

{
  "messageType": "promo",
  "text": "Привіт, %name=1%! Ми помітили, що ви залишили товари у кошику. Отримайте додаткові -10% за промокодом CART10: %short_url=1%"
}

Viber Опитування (viber_survey)

Інтерактивні опитування в чаті Viber (з резервним каналом SMS) для збору відгуків від клієнтів.

Характеристики

  • Від 2 до 5 кнопок із варіантами відповідей.
  • Текст самого запитання обмежений до 85 символів.
  • Інтерактивний інтерфейс всередині Viber.
  • Fallback до SMS (відправляється як звичайний текст).
  • Формат одного швидкого питання.

Випадки використання

  • Оцінка якості сервісу.
  • Відгуки щодо продукту.
  • Рейтинг якості обслуговування після звернення в підтримку.
  • Маркетингові дослідження.
  • Збір індексу лояльності (NPS).

Приклад

{
  "id": "survey-satisfaction-001",
  "fromName": "YourBrand",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "viber_survey",
  "text": "Наскільки ви задоволені нашим обслуговуванням?",
  "surveyOptions": [
    "Дуже задоволений",
    "Задоволений",
    "Нейтрально",
    "Не задоволений",
    "Вкрай не задоволений"
  ],
  "ttl": 604800
}

Обмеження

  • Текст (Питання): Максимум 85 символів
  • Опції (surveyOptions): 2-5 елементів
  • Довжина опції: Намагайтеся тримати довжину до 30 символів на опцію.
  • TTL: Рекомендовано від 7 до 30 днів

Кращі Практики

  • ✅ Задавайте лише одне просте і зрозуміле запитання.
  • ✅ Надавайте збалансовані варіанти відповідей.
  • ✅ Встановлюйте довгі TTL (клієнти можуть відповісти через кілька днів).
  • ❌ Не запитуйте декілька питань в одному блоці.

Приклади за сценаріями

Оцінка лояльності (NPS)

{
  "messageType": "viber_survey",
  "text": "З якою ймовірністю ви б порекомендували нас друзям?",
  "surveyOptions": [
    "0 - Точно ні",
    "1-6 - Малоймовірно",
    "7-8 - Імовірно",
    "9-10 - Однозначно так"
  ]
}

Відгук на Сервіс

{
  "messageType": "viber_survey",
  "text": "Чи допоміг вам оператор підтримки розв'язати проблему?",
  "surveyOptions": [
    "Так, повністю",
    "Частково допомогло",
    "Зовсім не допоміг"
  ]
}

Flash Call (flashcall)

Аутентифікація шляхом автоматичного виклику та розпізнавання номера (зазвичай заміняє SMS коди).

Характеристики

  • Значно дешевше за традиційні SMS OTP-коди.
  • Швидше (дзвінок відбувається за 1-3 секунди).
  • Жодного тексту в нотифікаціях чи чатах.
  • Стійкий до атак перевипуску SIM-карти.
  • Використовує лише голос/дзвінок (не заходить у канали Telegram чи Viber).

Випадки використання

  • Реєстрація нового користувача.
  • Зміна пароля / вхід в систему.
  • Валідація телефонного номера (Proof of possession).
  • Двофакторна автентифікація (2FA).
  • Підтвердження транзакцій.

Приклад

{
  "id": "verify-user-12345",
  "fromName": "YourApp",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "flashcall",
  "ttl": 300
}

Як це працює

  1. Користувач вводить номер телефону у вашому застосунку чи сайті.
  2. Ви відправляєте API-запит типу flashcall.
  3. Система здійснює дзвінок на цей номер, який обривається через 1-2 гудки.
  4. Додаток (наприклад, на Android) автоматично читає останні цифри номера вхідного дзвінка, або ж користувач робить це власноруч.
  5. Код порівнюється та верифікує користувача.

Кращі Практики

  • ✅ Виставляйте строгий і короткий TTL (від 60 до 300 секунд).
  • ✅ Дайте користувачу чіткі інструкції ("Вам зателефонує номер. Введіть останні 4 цифри").
  • ✅ Реалізуйте можливість повторно надіслати код (SMS) після невдачі (Fallback).
  • ❌ Ніколи не використовуйте для спаму чи реклами.

Вибір Правильного Типу (Схема)

Це транзакційне чи термінове нагадування?
├─ Так → transaction
└─ Ні
   └─ Чи є це рекламою/знижкою?
      ├─ Так → promo
      └─ Ні
         └─ Це питання до користувача?
            ├─ Так → viber_survey
            └─ Ні → Це перевірка номеру/реєстрація?
               ├─ Так → flashcall
               └─ Ні → transaction (стандартне)