Help Center Цасцаде АПИ

Цасцаде АПИ

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

Основни УРЛ

https://restapi.smsbat.com

Аутентификација

Цасцаде АПИ користи аутентификацију засновану на заглављу са три могућа заглавља за потврду идентитета:

Метод 1: СМСБАТ АПИ кључ

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

2. метод: Вибер бот токен

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

Метод 3: Телеграм Бот Кеи

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Доступне крајње тачке

Метода	Крајња тачка	Опис
ПОСТ	`/апи/ЦасцадеМессаге/сенд_мессаге/асинц`	Опште каскадно слање порука
ПОСТ	`/апи/ЦасцадеМессаге/сенд_мессаге/тг-вибер/асинц`	Телеграм-приоритетна каскада

Како то функционише

Са једним АПИ захтевом, Цасцаде аутоматски испоручује вашу поруку на више канала:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

Порука се испоручује преко првог доступног канала, са аутоматским враћањем на следећи канал ако испорука не успе.

Кључне карактеристике

Вишеканална испорука

Пошаљите једну поруку, досегните кориснике на било којој платформи:

Телеграм бот
Вибер бот
Вибер пословне поруке
РЦС (Рицх Цоммуницатион Сервицес)
СМС

Замена променљиве

Користите динамички садржај са променљивим чуварима места:

%наме=ид% - Текстуалне променљиве
%урл=ид% - УРЛ променљиве
%схорт_урл=ид% - Скраћене УРЛ променљиве

Планирање порука

Закажите поруке за будућу испоруку:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

Време за живот (ТТЛ)

Подесите време истека за поруке:

{
  "ttl": 3600
}

Типови порука

Цасцаде АПИ подржава:

Трансакциони - Потврде поруџбина, обавештења
Промо - Маркетиншке и промотивне поруке
Вибер анкете - Интерактивне анкете
Фласх позиви - Верификација телефона

Формат одговора

Успешни одговори враћају:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]

мессагеИд - ГУИД за идентификацију поруке
трацкинИд - Стринг за праћење статуса испоруке

Брзи почетак

Сенд Мессагес - Почните да шаљете каскадне поруке
Променљиве поруке – Користите динамички садржај
Типови порука – Истражите типове порука

Пример захтева

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "recipient": "380501234567",
        "text": "Hello %name=1%, your code is %url=2%!",
        "variables": [
          { "id": 1, "value": "User" },
          { "id": 2, "value": "7777" }
        ]
      }
    ]
  }'

Обрада грешака

ХТТП статусни кодови:

200 ОК - Захтев је успео
400 лоших захтева - Неважећи формат захтева
401 Неовлашћено - Аутентификација није успела
429 Превише захтева - Ограничење брзине је прекорачено
500 Интерна грешка сервера - Грешка сервера

Предности

Појединачна интеграција

Једна АПИ интеграција за све канале за размену порука - нема потребе за интеграцијом са сваком платформом посебно.

Аутоматско рутирање

Паметно рутирање обезбеђује испоруку поруке кроз најбољи доступни канал за сваког примаоца.

Оптимизација трошкова

Цасцаде прво испробава јефтиније канале, аутоматски се враћајући на скупље опције само када је то потребно.

Веће стопе испоруке

Више резервних канала обезбеђује да ваша порука стигне до примаоца чак и ако примарни канал не успе.

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

Сенд Цасцаде Мессагес - Научите како да шаљете поруке
Променљиве поруке - Радите са динамичким садржајем
Типови порука - Истражите доступне типове порука

Search Results