Gå til indholdet

Cascade API

Cascade API gør det muligt at sende beskeder på tværs af flere platforme med en enkelt anmodning, automatisk routing til Telegram Bot, Viber Bot, Viber Business Messages, RCS og SMS.

Basis-URL

https://restapi.smsbat.com

Godkendelse

Cascade API bruger header-baseret godkendelse med tre mulige godkendelsesheadere:

Metode 1: SMSBAT API-nøgle

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

Metode 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

Metode 3: Telegram Bot-nøgle

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

Tilgængelige endepunkter

Metode Slutpunkt Beskrivelse
POST /api/CascadeMessage/send_message/async Generel kaskademeddelelsessending
POST /api/CascadeMessage/send_message/tg-viber/async Telegram-prioriteret kaskade

Sådan fungerer det

Med en enkelt API-anmodning leverer Cascade automatisk dit budskab på tværs af flere kanaler:

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

Beskeden leveres gennem den første tilgængelige kanal, med automatisk fallback til den næste kanal, hvis leveringen mislykkes.

Nøglefunktioner

Multi-Channel Delivery

Send én besked, nå ud til brugere på enhver platform:

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

Variabel substitution

Brug dynamisk indhold med variable pladsholdere:

  • %name=id% - Tekstvariabler
  • %url=id% - URL-variabler
  • %short_url=id% - Forkortede URL-variabler

Beskedplanlægning

Planlæg beskeder til fremtidig levering:

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

Time-to-Live (TTL)

Indstil udløbstid for beskeder:

{
  "ttl": 3600
}

Meddelelsestyper

Cascade API understøtter:

  • Transaktionsmæssig - Ordrebekræftelser, meddelelser
  • Promo - Marketing- og salgsfremmende budskaber
  • Viber Surveys - Interaktive undersøgelser
  • Flash-opkald - Telefonbekræftelse

Svarformat

Vellykkede svar returnerer:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID til meddelelsesidentifikation
  • trackinId - Streng til sporing af leveringsstatus

Hurtig start

  1. Send beskeder - Begynd at sende kaskademeddelelser
  2. Meddelelsesvariabler - Brug dynamisk indhold
  3. Meddelelsestyper - Udforsk meddelelsestyper

Eksempel på anmodning

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

Fejlhåndtering

HTTP-statuskoder:

  • 200 OK - Forespørgsel gennemført
  • 400 Bad Request - Ugyldigt anmodningsformat
  • 401 Uautoriseret - Godkendelse mislykkedes
  • 429 for mange anmodninger - Satsgrænsen er overskredet
  • 500 Intern serverfejl - Serverfejl

Fordele

Enkelt integration

Én API-integration til alle meddelelseskanaler - ingen grund til at integrere med hver platform separat.

Automatisk routing

Smart routing sikrer levering af beskeder gennem den bedst tilgængelige kanal for hver modtager.

Omkostningsoptimering

Cascade prøver først billigere kanaler og falder automatisk tilbage til dyrere muligheder, når det er nødvendigt.

Højere leveringspriser

Flere fallback-kanaler sikrer, at din besked når modtageren, selvom den primære kanal fejler.

Næste trin