Kaskados API

Cascade API leidžia siųsti pranešimus keliose platformose su viena užklausa, automatiškai nukreipiant į Telegram Bot, Viber Bot, Viber Business Messages, RCS ir SMS.

Bazinis URL

https://restapi.smsbat.com

Autentifikavimas

Cascade API naudoja antraštėmis pagrįstą autentifikavimą su trimis galimomis autentifikavimo antraštėmis:

1 būdas: SMSBAT API raktas

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 būdas: Viber Bot Token

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 būdas: „Telegram Bot“ raktas

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

Galimi galutiniai taškai

Metodas	Galutinis taškas	Aprašymas
POST	`/api/CascadeMessage/send_message/async`	Bendras pakopinis pranešimų siuntimas
POST	"/api/CascadeMessage/send_message/tg-viber/async"	Telegramos pirmenybė teikiama kaskada

Kaip tai veikia

Gavusi vieną API užklausą, „Cascade“ automatiškai pateikia jūsų pranešimą keliais kanalais:

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

Pranešimas pristatomas per pirmąjį galimą kanalą, o jei nepavyksta pristatyti, automatiškai grįžtama į kitą kanalą.

Pagrindinės savybės

Kelių kanalų pristatymas

Išsiųskite vieną pranešimą, pasiekite vartotojus bet kurioje platformoje:

Telegramos robotas
Viber Bot
Viber verslo pranešimai – RCS (turtingos komunikacijos paslaugos)
SMS

Kintamojo pakeitimas

Naudokite dinaminį turinį su kintamomis rezervuotomis vietomis:

– „%name=id%“ – teksto kintamieji – „%url=id%“ – URL kintamieji - %short_url=id% - Sutrumpinti URL kintamieji

Pranešimų planavimas

Suplanuokite pranešimus būsimam pristatymui:

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

Laikas gyventi (TTL)

Nustatyti pranešimų galiojimo laiką:

{
  "ttl": 3600
}

Pranešimų tipai

Kaskados API palaiko:

Sandoris - Užsakymų patvirtinimai, pranešimai
Reklama - Rinkodaros ir reklaminiai pranešimai
Viber Surveys - Interaktyvios apklausos – Flash Calls – telefono patvirtinimas

Atsakymo formatas

Sėkmingi atsakymai grąžinami:

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

„messageId“ – pranešimo identifikavimo GUID – „trackinId“ – pristatymo būsenos stebėjimo eilutė

Greita pradžia

Siųsti pranešimus – pradėkite siųsti kaskadinius pranešimus
Pranešimo kintamieji – naudokite dinaminį turinį
Pranešimų tipai – tyrinėkite pranešimų tipus

Užklausos pavyzdys

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

Klaidų tvarkymas

HTTP būsenos kodai:

– „200 gerai“ – užklausa įvykdyta – „400 netinkama užklausa“ – netinkamas užklausos formatas – „401 Neteisėtas“ – Autentifikavimas nepavyko – „429 per daug užklausų“ – viršytas normos limitas - „500 vidinė serverio klaida“ – serverio klaida

Privalumai

Viena integracija

Viena API integracija visiems pranešimų kanalams – nereikia integruoti su kiekviena platforma atskirai.

Automatinis maršruto parinkimas

Išmanusis maršrutas užtikrina pranešimo pristatymą geriausiu prieinamu kanalu kiekvienam gavėjui.

Išlaidų optimizavimas

„Cascade“ pirmiausia išbando pigesnius kanalus ir automatiškai grįžta prie brangesnių variantų tik tada, kai reikia.

Didesni pristatymo įkainiai

Keli atsarginiai kanalai užtikrina, kad jūsų pranešimas pasiektų gavėją, net jei pagrindinis kanalas sugenda.

Kiti žingsniai

– Siųsti kaskadinius pranešimus – Sužinokite, kaip siųsti pranešimus – Pranešimo kintamieji – Dirbkite su dinaminiu turiniu – Pranešimų tipai – Naršykite galimus pranešimų tipus