Skip to content

Cascade API

Cascade API omogućava slanje poruka na više platformi sa jednim zahtjevom, automatski se usmjeravaju na Telegram Bot, Viber Bot, Viber Business Messages, RCS i SMS.

Osnovni URL

https://restapi.smsbat.com

Autentifikacija

Cascade API koristi autentifikaciju zasnovanu na zaglavlju sa tri moguća zaglavlja autentifikacije:

Metoda 1: SMSBAT API ključ

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

Metod 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

Metod 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

Dostupne krajnje tačke

Metoda Krajnja tačka Opis
POST /api/CascadeMessage/send_message/async Općenito kaskadno slanje poruka
POST /api/CascadeMessage/send_message/tg-viber/async Telegram-prioritetna kaskada

Kako radi

Sa jednim API zahtjevom, Cascade automatski isporučuje vašu poruku na više kanala:

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

Poruka se isporučuje preko prvog dostupnog kanala, s automatskim vraćanjem na sljedeći kanal ako dostava ne uspije.

Ključne karakteristike

Višekanalna isporuka

Pošaljite jednu poruku, dođite do korisnika na bilo kojoj platformi:

  • Telegram bot
  • Viber bot
  • Viber poslovne poruke
  • RCS (Rich Communication Services)
  • SMS

Zamjena varijable

Koristite dinamički sadržaj sa varijabilnim čuvarima mjesta:

  • %name=id% - Tekstualne varijable
  • %url=id% - URL varijable
  • %short_url=id% - Skraćene URL varijable

Raspored poruka

Zakažite poruke za buduću dostavu:

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

Vrijeme za život (TTL)

Postavite vrijeme isteka za poruke:

{
  "ttl": 3600
}

Vrste poruka

Cascade API podržava:

  • Transakcijske - Potvrde narudžbi, obavještenja
  • Promo - Marketinške i promotivne poruke
  • Viber ankete - Interaktivne ankete
  • Flash pozivi - Potvrda telefona

Format odgovora

Uspješni odgovori vraćaju:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID za identifikaciju poruke
  • trackinId - Niz za praćenje statusa isporuke

Brzi početak

  1. Send Messages - Počnite slati kaskadne poruke
  2. Varijable poruke - Koristite dinamički sadržaj
  3. Vrste poruka - Istražite vrste poruka

Primjer zahtjeva

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

Rukovanje greškama

HTTP statusni kodovi:

  • 200 OK - Zahtjev uspješan
  • 400 loših zahtjeva - Nevažeći format zahtjeva
  • 401 Neovlašteno - Autentifikacija nije uspjela
  • 429 Previše zahtjeva - Ograničenje brzine je prekoračeno
  • 500 Interna greška servera - Greška servera

Prednosti

Pojedinačna integracija

Jedna API integracija za sve kanale za razmjenu poruka - nema potrebe za integracijom sa svakom platformom posebno.

Automatsko usmjeravanje

Pametno rutiranje osigurava isporuku poruke kroz najbolji dostupni kanal za svakog primaoca.

Optimizacija troškova

Cascade prvo isprobava jeftinije kanale, automatski se vraća na skuplje opcije samo kada je to potrebno.

Veće stope isporuke

Više rezervnih kanala osigurava da vaša poruka stigne do primaoca čak i ako primarni kanal ne uspije.

Sljedeći koraci