Preskoči na sadržaj

Kaskadni API

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

Osnovni URL

https://restapi.smsbat.com

Autentifikacija

Cascade API koristi autentifikaciju temeljenu na zaglavlju s tri moguća autentifikacijska zaglavlja:

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

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: Ključ Telegram Bota

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 točke

Metoda Krajnja točka Opis
OBJAVI /api/CascadeMessage/send_message/async Opće kaskadno slanje poruka
OBJAVI /api/CascadeMessage/send_message/tg-viber/async Kaskada s prioritetom telegrama

Kako to radi

S 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 kroz prvi dostupni kanal, s automatskim vraćanjem na sljedeći kanal ako isporuka ne uspije.

Ključne značajke

Višekanalna isporuka

Pošaljite jednu poruku, dosegnite korisnike na bilo kojoj platformi:

  • Telegram Bot
  • Viber bot
  • Viber poslovne poruke
  • RCS (Bogate komunikacijske usluge)
  • SMS

Zamjena varijable

Koristite dinamički sadržaj s promjenjivim rezerviranim mjestima:

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

Raspored poruka

Raspored poruka za buduću isporuku:

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

Vrijeme života (TTL)

Postavite vrijeme isteka za poruke:

{
  "ttl": 3600
}

Vrste poruka

Cascade API podržava:

  • Transakcijski - Potvrde narudžbi, obavijesti
  • Promo - Marketinške i promotivne poruke
  • Viber Ankete - Interaktivne ankete
  • Flash pozivi - Telefonska potvrda

Format odgovora

Uspješni odgovori vraćaju se:

[
  {
    "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. Slanje poruka - Počnite slati kaskadne poruke
  2. Varijable poruka - 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"
        }
      ]
    }
  ]
}

Rješavanje grešaka

HTTP statusni kodovi:

  • 200 OK - Zahtjev uspješan
  • 400 Bad Request - Nevažeći format zahtjeva
  • 401 Unauthorized - Autentifikacija nije uspjela
  • 429 Previše zahtjeva - Ograničenje brzine premašeno
  • 500 Internal Server Error - Greška poslužitelja

Prednosti

Jedna integracija

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

Automatsko usmjeravanje

Pametno usmjeravanje osigurava isporuku poruke putem najboljeg dostupnog kanala za svakog primatelja.

Optimizacija troškova

Cascade prvo pokušava s jeftinijim kanalima, automatski se vraćajući na skuplje opcije samo kada je to potrebno.

Više stope isporuke

Više zamjenskih kanala osigurava da vaša poruka stigne do primatelja čak i ako primarni kanal zakaže.

Sljedeći koraci