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

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

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
}

Как работи

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

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

✅ Задайте кратък 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

Search Results

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

Преглед

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

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

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

Пример

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

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

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

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

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

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

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

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

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

Пример

С променливи

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

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

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

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

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

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

Viber Survey (Анкета)

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

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

Пример

Ограничения

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

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

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

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

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

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

Flash Call

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

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

Пример

Как работи

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

Пример с Fallback

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

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

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