Пошаљите каскадне поруке
Шаљите поруке на више канала са једним АПИ захтевом. Цасцаде аутоматски усмерава вашу поруку кроз Телеграм Бот, Вибер Бот, Вибер Бусинесс Мессагес, РЦС и СМС.
Крајње тачке
Стандардна каскада
ЦОДЕ_БЛОЦК_0
Рутира поруке кроз све доступне канале у низу.
Телеграм-Вибер приоритет
ЦОДЕ_БЛОЦК_1
Даје приоритет Телеграм и Вибер каналима ради брже испоруке.
Аутентификација
Цасцаде АПИ подржава три заглавља за аутентификацију. Укључите најмање једно:
| Хеадер | Опис |
|---|---|
Кс-Аутхоризатион-Кеи | СМСБАТ АПИ кључ (препоручено) |
Кс-Вибер-Аутх-Токен | Вибер бот акредитиви |
Кс-Тг-Бот-Кеи | Телеграм бот кључ |
Структура захтева
Заглавља
ЦОДЕ_БЛОЦК_2
Тело захтева
Пошаљите низ објеката поруке:
ЦОДЕ_БЛОЦК_3
Параметерс
| Параметар | Тип | Обавезно | Опис |
|---|---|---|---|
ид | стринг | Да | Ваш идентификатор за праћење |
фромНаме | стринг | Да | Име за приказ пошиљаоца |
тоПхоне | стринг | Да | Број телефона примаоца (формат Е.164) |
мессагеТипе | стринг | Да | Тип поруке: трансакција, промо, вибер_сурвеи, фласхцалл |
текст | стринг | Да* | Садржај поруке (* потребно за већину типова) |
ттл | цео број | Не | Време за живот у секундама |
сцхедуледСент | стринг | Не | ИСО 8601 датум и време за планирану испоруку |
Типови порука
Поруке о трансакцијама
Критична обавештења као што су потврде поруџбина и ажурирања налога:
ЦОДЕ_БЛОЦК_4
Промо поруке
Маркетиншке кампање са богатим медијима:
ЦОДЕ_БЛОЦК_5
Вибер анкета
Интерактивне анкете са 2-5 опција одговора:
ЦОДЕ_БЛОЦК_6
Максимални текст анкете: 85 карактера
Фласх позив
Верификација телефона путем аутоматског позива:
ЦОДЕ_БЛОЦК_7
Примери
Основна трансакција
ЦОДЕ_БЛОЦК_8
Заказана промоција
ЦОДЕ_БЛОЦК_9
Масовне поруке
ЦОДЕ_БЛОЦК_10
Одговор
Успешан одговор
ЦОДЕ_БЛОЦК_11
Поља одговора
| Поље | Тип | Опис |
|---|---|---|
мессагеИд | стринг (УУИД) | Идентификатор системске поруке |
трацкинИд | стринг | Ваш идентификатор за праћење (из захтева) |
Користите мессагеИд за праћење статуса и трацкинИд за корелацију са вашим системом.
Примери имплементације
Питхон
ЦОДЕ_БЛОЦК_12
ЈаваСцрипт (Ноде.јс)
ЦОДЕ_БЛОЦК_13
ПХП
ЦОДЕ_БЛОЦК_14
Најбоље праксе
Бројеви телефона
Увек користите формат Е.164:
- ✅
+380КСКСКСКСКСКСКСКСКС - ❌
380КСКСКСКСКСКСКСКСКС - ❌
0КСКСКСКСКСКСКСКСКС
ИД-ови праћења
- Користите јединствене ИД-ове за сваку поруку
– Укључите контекст у ИД (нпр.
поруџбина-12345,промо-лето-2025) - Држите ИД-ове испод 255 знакова
- Избегавајте посебне знакове
ТТЛ (време за живот)
Препоручене ТТЛ вредности:
- ОТП/верификација: 300-600 секунди (5-10 минута)
- Трансакциони: 3600-86400 секунди (1-24 сата)
- Промотивно: 86400-259200 секунди (1-3 дана)
- Анкете: 604800 секунди (7 дана)
Планиране поруке
- Користите УТЦ временску зону за
сцхедуледСент - Немојте заказивати више од 30 дана унапред
- Узмите у обзир разлике у временским зонама
- Прво тестирајте са распоредима у блиској будућности
Масовно слање
- Шаљите у групама од 100-1000 порука
- Имплементирајте ограничавање стопе
- Грациозно поступајте са грешкама
- Поновите неуспеле поруке
Обрада грешака
ХТТП статусни кодови
| Код | Опис |
|---|---|
| 200 | Успех |
| 400 | Лош захтев - неважећи параметри |
| 401 | Неовлашћено - неважећи АПИ кључ |
| 429 | Превише захтева |
| 500 | Грешка сервера |
Одговор на грешку
ЦОДЕ_БЛОЦК_15
Поновите логику
ЦОДЕ_БЛОЦК_16
Следећи кораци
- Променљиве поруке - Користите динамички садржај
- Типови порука - Истражите типове порука
- Статус испоруке - Пратите испоруку