Skip to content

Cascade API

API-ul Cascade permite trimiterea de mesaje pe mai multe platforme cu o singură solicitare, direcționarea automată către Telegram Bot, Viber Bot, Viber Business Messages, RCS și SMS.

URL de bază

https://restapi.smsbat.com

Autentificare

Cascade API folosește autentificarea bazată pe antet cu trei anteturi posibile de autentificare:

Metoda 1: Cheia API SMSBAT

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

Metoda 2: 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

Metoda 3: Telegram Bot Key

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

Puncte finale disponibile

Metoda Punct final Descriere
POST /api/CascadeMessage/send_message/async Trimiterea mesajului general în cascadă
POST /api/CascadeMessage/send_message/tg-viber/async Cascada cu prioritate telegramă

Cum funcționează

Cu o singură solicitare API, Cascade vă livrează automat mesajul pe mai multe canale:

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

Mesajul este livrat prin primul canal disponibil, cu revenire automată la următorul canal dacă livrarea eșuează.

Caracteristici cheie

Livrare pe mai multe canale

Trimiteți un mesaj, ajungeți la utilizatori pe orice platformă:

  • Telegram Bot
  • Viber Bot
  • Mesaje de afaceri Viber
  • RCS (Servicii de comunicare bogate)
  • SMS

Înlocuire variabilă

Utilizați conținut dinamic cu substituenți variabili:

  • %name=id% - Variabile text
  • %url=id% - variabile URL
  • %short_url=id% - Variabile URL scurtate

Programarea mesajelor

Programați mesaje pentru livrarea viitoare:

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

Durată de viață (TTL)

Setați timpul de expirare pentru mesaje:

{
  "ttl": 3600
}

Tipuri de mesaje

Cascade API acceptă:

  • Tranzacțional - Confirmări de comandă, notificări
  • Promo - Mesaje de marketing și promoționale
  • Sondaje Viber - Sondaje interactive
  • Apeluri flash - Verificare telefon

Format de răspuns

Răspunsurile de succes revin:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID pentru identificarea mesajului
  • trackinId - Șir pentru urmărirea stării livrării

Pornire rapidă

  1. Trimite mesaje - Începeți să trimiteți mesaje în cascadă
  2. Variabile de mesaje - Utilizați conținut dinamic
  3. Tipuri de mesaje - Explorați tipurile de mesaje

Exemplu de solicitare

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

Gestionarea erorilor

Codurile de stare HTTP:

  • 200 OK - Solicitare reușită
  • 400 Solicitare greșită - Format de solicitare nevalid
  • 401 Neautorizat - Autentificarea eșuată
  • 429 Too Many Requests - Limita ratei a fost depășită
  • 500 Internal Server Error - Eroare de server

Beneficii

Integrare unică

O singură integrare API pentru toate canalele de mesagerie - nu este nevoie să se integreze cu fiecare platformă separat.

Rutare automată

Rutarea inteligentă asigură livrarea mesajelor prin cel mai bun canal disponibil pentru fiecare destinatar.

Optimizarea costurilor

Cascade încearcă mai întâi canale mai ieftine, revenind automat la opțiuni mai scumpe numai atunci când este necesar.

Rate de livrare mai mari

Mai multe canale de rezervă asigură că mesajul dvs. ajunge la destinatar chiar dacă canalul principal eșuează.

Următorii pași