Видове съобщения

Cascade API поддържа четири типа съобщения, всеки от които е оптимизиран за различни случаи на употреба и канали.

Преглед

Тип	Предназначение	Канали	Интерактивно
transaction	Критични известия	Всички	Не
promo	Маркетингови кампании	Всички	Да (бутони)
viber_survey	Анкети и обратна връзка	Viber, SMS	Да (опции)
flashcall	Телефонна верификация	Гласово	Не

Транзакционни съобщения

Критични известия като потвърждения на поръчки, актуализации на акаунти и системни известия.

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

• Висок приоритет на доставка
• Без промоционално съдържание
• Директни и кратки
• Чувствителни към времето
• Маршрутизирани чрез: Telegram → Viber → RCS → SMS

Случаи на употреба

• Потвърждения на поръчки
• Известия за плащане
• Сигнали за акаунта
• Известия за сигурност
• Актуализации на доставката
• Промяна на пароли

Пример

{
  "id": "tx-order-12345",
  "fromName": "YourStore",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "transaction",
  "text": "Поръчка #12345 е потвърдена. Общо: $99.99. Доставка: 25 яну. Проследяване: https://example.com/track/12345",
  "ttl": 86400
}

Добри практики

• ✅ Поддържайте съобщенията под 160 знака, когато е възможно
• ✅ Включете подходящи детайли за транзакцията
• ✅ Предоставете връзки за проследяване
• ✅ Използвайте ясен, професионален език
• ❌ Не включвайте маркетингово съдържание
• ❌ Не използвайте прекомерно емоджита

Примери по случай на употреба

Потвърждение на поръчка

{
  "messageType": "transaction",
  "text": "Поръчка #12345 потвърдена. Общо: $99.99. Очаквана доставка: 25 януари."
}

Известие за плащане

{
  "messageType": "transaction",
  "text": "Плащането на $150.00 към Търговец ABC е успешно. Транзакция ID: TXN789. Баланс: $850.00"
}

Сигнал за сигурност

{
  "messageType": "transaction",
  "text": "Открито е ново влизане от iPhone в 10:30. Локация: Ню Йорк. Ако това не сте вие, защитете акаунта си незабавно."
}

Актуализация за доставка

{
  "messageType": "transaction",
  "text": "Вашата пратка е изпратена за доставка! Очаквано пристигане: 14:00 - 16:00. Проследяване: https://track.example.com/PKG123"
}

Промо съобщения

Маркетингови и промоционални кампании с богата мултимедия и интерактивни елементи.

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

• Поддръжка на Rich media (мултимедия)
• Интерактивни бутони
• Фокусирани върху призиви към действие (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
}

С променливи

{
  "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)
• ✅ Използвайте ангажиращ език
• ✅ Добавете параметри за проследяване към URL адресите
• ✅ Персонализирайте с променливи
• ✅ Тествайте на множество канали
• ❌ Не спамете клиентите
• ❌ Не използвайте подвеждащо съдържание
• ❌ Не превишавайте лимитите за знаци

Примери по случай на употреба

Лансиране на продукт

{
  "messageType": "promo",
  "text": "🎉 НОВО ПРИСТИГАНЕ: iPhone 15 Pro е вече наличен! Предварителна поръчка днес с безплатна доставка. Посетете: https://store.com/iphone15"
}

Флаш разпродажба

{
  "messageType": "promo",
  "text": "⚡ ФЛАШ РАЗПРОДАЖБА: Само 2 часа! Още 30% отстъпка на всичко. Използвайте код: FLASH30. Пазарувайте сега: https://store.com/flash"
}

Покана за събитие

{
  "messageType": "promo",
  "text": "Поканени сте! VIP събитие за пазаруване на 25 януари от 18:00 ч. Ексклузивни оферти + освежителни напитки. RSVP: https://events.com/vip"
}

Изоставена количка

{
  "messageType": "promo",
  "text": "Здравейте %name=1%! Оставихте артикули в количката си. Завършете покупката сега и вземете 10% отстъпка с код CART10: %short_url=1%"
}

Viber Survey (Анкета)

Интерактивни анкети и проучвания за събиране на отзиви от клиенти.

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

• От 2 до 5 опции за отговор
• Текстът е ограничен до 85 знака
• Интерактивен интерфейс във Viber
• Fallback към SMS (без интерактивност)
• Формат с един единствен въпрос

Случаи на употреба

• Проучвания на удовлетвореността на клиентите
• Отзиви за продукти
• Оценки за качеството на услугата
• Пазарни проучвания
• Обратна връзка за събития
• Net Promoter Score (NPS)

Пример

{
  "id": "survey-satisfaction-001",
  "fromName": "YourBrand",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "viber_survey",
  "text": "Колко сте доволни от нашата услуга?",
  "surveyOptions": [
    "Много доволен",
    "Доволен",
    "Неутрален",
    "Недоволен",
    "Много недоволен"
  ],
  "ttl": 604800
}

Ограничения

• Текст: Максимум 85 знака
• Опции: 2-5 избора
• Дължина на опцията: Под 30 знака всяка
• TTL: Препоръчва се 7-30 дни

Добри практики

• ✅ Задайте един ясен въпрос
• ✅ Осигурете балансирани опции
• ✅ Използвайте прост език
• ✅ Поддържайте опциите кратки
• ✅ Задайте подходящо TTL (7+ дни)
• ❌ Не задавайте множество въпроси в едно съобщение
• ❌ Не използвайте технически жаргон
• ❌ Не прехвърляйте субективност в отговорите

Примери по случай на употреба

Удовлетвореност на клиента (NPS)

{
  "messageType": "viber_survey",
  "text": "Колко е вероятно да ни препоръчате на приятел?",
  "surveyOptions": [
    "0 - Изобщо не",
    "1-6 - Малко вероятно",
    "7-8 - Вероятно",
    "9-10 - Много вероятно"
  ]
}

Обратна връзка за продукт

{
  "messageType": "viber_survey",
  "text": "Как оценявате нашия нов продукт?",
  "surveyOptions": [
    "⭐️ Отличен",
    "⭐️ Добър",
    "⭐️ Среден",
    "⭐️ Слаб",
    "⭐️ Много слаб"
  ]
}

Качество на услугата

{
  "messageType": "viber_survey",
  "text": "Полезно ли беше вашето преживяване с поддръжката?",
  "surveyOptions": [
    "Да, много полезно",
    "Донякъде полезно",
    "Не е полезно"
  ]
}

Обратна връзка за събитие

{
  "messageType": "viber_survey",
  "text": "Бихте ли посетили наши събития отново?",
  "surveyOptions": [
    "Категорично да",
    "Най-вероятно да",
    "Не съм сигурен",
    "Най-вероятно не",
    "Категорично не"
  ]
}

Flash Call

Верификация на телефон чрез автоматизирани обаждания вместо SMS кодове.

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

• Рентабилна (икономична) верификация
• По-бързо от SMS (1-3 секунди)
• Няма видим код в известията
• Устойчивост на атаки със смяна на SIM (SIM swap)
• Само телефонно обаждане (без Telegram/Viber)

Случаи на употреба

• Регистрация на потребител
• Проверка при влизане
• Валидация на телефонен номер
• Двуфакторно удостоверяване (2FA)
• Възстановяване на акаунт
• Потвърждение на транзакция

Пример

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

Как работи

1. Потребителят въвежда телефонен номер
2. API инициира флаш обаждане (flash call)
3. Обаждането приключва след 1-2 позвънявания
4. Приложението ви прихваща Caller ID (или потребителят го въвежда ръчно - последните 4 цифри)
5. Caller ID се проверява срещу модел
6. Потребителят е удостоверен

Добри практики

• ✅ Задайте кратък TTL (60-300 секунди)
• ✅ Приложете разпознаване на Caller ID (за Android)
• ✅ Осигурете SMS fallback
• ✅ Обработете заявките за разрешения
• ✅ Покажете ясни инструкции
• ❌ Не използвайте за промоционални цели
• ❌ Не задавайте дълго TTL

Пример с Fallback

{
  "id": "verify-001",
  "fromName": "YourApp",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "flashcall",
  "ttl": 300,
  "fallback": {
    "messageType": "transaction",
    "text": "Вашият код за потвърждение: 123456"
  }
}

Избор на правилния тип

Матрица за сравнение

Характеристика	Transaction	Promo	Survey	Flash Call
Rich Media	❌	✅	❌	❌
Интерактивно	❌	✅	✅	❌
Персонализация	✅	✅	✅	❌
Типичен TTL	Часове	Дни	Седмици	Минути
Цена	Средна	Средна	Средна	Ниска
Скорост	Бързо	Бързо	Бърза	Най-бърза

Следващи стъпки

• Изпращане на съобщения - Започнете да изпращате
• Променливи в съобщенията - Персонализирайте съобщенията си
• SMSBAT API - Разгледайте функциите на SMSBAT API