Иди на текст

Пошаљите каскадне поруке

Шаљите поруке на више канала са једним АПИ захтевом. Цасцаде аутоматски усмерава вашу поруку кроз Телеграм Бот, Вибер Бот, Вибер Бусинесс Мессагес, РЦС и СМС.

Крајње тачке

Стандардна каскада

ЦОДЕ_БЛОЦК_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

Следећи кораци