Gå till innehållet

Cascade API

Cascade API gör det möjligt att skicka meddelanden över flera plattformar med en enda förfrågan, automatiskt dirigering till Telegram Bot, Viber Bot, Viber Business Messages, RCS och SMS.

Bas-URL

https://restapi.smsbat.com

Autentisering

Cascade API använder rubrikbaserad autentisering med tre möjliga autentiseringsrubriker:

Metod 1: SMSBAT API-nyckel

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

Tillgängliga slutpunkter

Metod Slutpunkt Beskrivning
POST /api/CascadeMessage/send_message/async Allmänt kaskadmeddelandesändning
POST /api/CascadeMessage/send_message/tg-viber/async Telegramprioriterad kaskad

Hur det fungerar

Med en enda API-förfrågan levererar Cascade automatiskt ditt budskap över flera kanaler:

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

Meddelandet levereras via den första tillgängliga kanalen, med automatisk återgång till nästa kanal om leveransen misslyckas.

Nyckelfunktioner

Multi-Channel Delivery

Skicka ett meddelande, nå användare på valfri plattform:

  • Telegram Bot
  • Viber Bot
  • Viber Business Messages
  • RCS (Rich Communication Services)
  • SMS

Variabel substitution

Använd dynamiskt innehåll med variabla platshållare:

  • %name=id% - Textvariabler
  • %url=id% - URL-variabler
  • %short_url=id% - Förkortade URL-variabler

Meddelandeschema

Schemalägg meddelanden för framtida leverans:

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

Time-to-Live (TTL)

Ställ in utgångstid för meddelanden:

{
  "ttl": 3600
}

Meddelandetyper

Cascade API stöder:

  • Transaktions - Orderbekräftelser, aviseringar
  • Promo - Marknadsförings- och reklambudskap
  • Viber Surveys - Interaktiva undersökningar
  • Flashsamtal - Telefonverifiering

Svarsformat

Lyckade svar returnerar:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID för meddelandeidentifiering
  • trackinId - Sträng för att spåra leveransstatus

Snabbstart

  1. Skicka meddelanden - Börja skicka kaskadmeddelanden
  2. Meddelandevariabler - Använd dynamiskt innehåll
  3. Meddelandetyper - Utforska meddelandetyper

Exempel på begäran

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

Felhantering

HTTP-statuskoder:

  • 200 OK - Begäran lyckades
  • 400 Bad Request - Ogiltigt format för begäran
  • 401 obehörig - Autentisering misslyckades
  • 429 Too Many Requests - Beloppsgränsen har överskridits
  • 500 Internt serverfel - Serverfel

Fördelar

Enkel integration

En API-integration för alla meddelandekanaler - inget behov av att integrera med varje plattform separat.

Automatisk routing

Smart routing säkerställer meddelandeleverans via den bästa tillgängliga kanalen för varje mottagare.

Kostnadsoptimering

Cascade provar billigare kanaler först och faller automatiskt tillbaka till dyrare alternativ endast när det behövs.

Högre leveranspriser

Flera reservkanaler säkerställer att ditt meddelande når mottagaren även om den primära kanalen misslyckas.

Nästa steg