Kalo te përmbajtja

Cascade API

API Cascade mundëson dërgimin e mesazheve nëpër platforma të shumta me një kërkesë të vetme, duke u drejtuar automatikisht në Telegram Bot, Viber Bot, Viber Business Messages, RCS dhe SMS.

URL bazë

https://restapi.smsbat.com

Autentifikimi

Cascade API përdor vërtetimin e bazuar në kokë me tre tituj të mundshëm vërtetimi:

Metoda 1: Çelësi SMSBAT API

KODI_BLOCK_1

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: Çelësi Bot Telegram

KODI_BLOCK_3

Pikat përfundimtare të disponueshme

Metoda Pika fundore Përshkrimi
POST /api/CascadeMessage/send_message/async Dërgimi i përgjithshëm i mesazheve të kaskadës
POST /api/CascadeMessage/send_message/tg-viber/async Kaskada me prioritet të telegramit

Si funksionon

Me një kërkesë të vetme API, Cascade dërgon automatikisht mesazhin tuaj nëpër kanale të shumta:

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

Mesazhi dërgohet përmes kanalit të parë të disponueshëm, me rikthim automatik në kanalin tjetër nëse dërgimi dështon.

Karakteristikat kryesore

Dorëzimi me shumë kanale

Dërgoni një mesazh, arrini përdoruesit në çdo platformë:

  • Telegram Bot
  • Viber Bot
  • Mesazhet e biznesit në Viber
  • RCS (Shërbimet e pasura të komunikimit)
  • SMS

Zëvendësimi i variablave

Përdorni përmbajtje dinamike me mbajtëse të ndryshueshme:

  • %name=id% - Variablat e tekstit
  • %url=id% - variablat e URL-së
  • %short_url=id% - Ndryshoret e shkurtuara të URL-së

Planifikimi i mesazheve

Programoni mesazhet për dërgimin e ardhshëm:

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

Koha për të jetuar (TTL)

Cakto kohën e skadimit për mesazhet:

{
  "ttl": 3600
}

Llojet e mesazheve

Cascade API mbështet:

  • Transaksionale - Konfirmimet e porosive, njoftimet
  • **Promo ** - Mesazhe marketingu dhe promocionale
  • Viber Surveys - Sondazhe interaktive
  • Telefonata flash - Verifikimi i telefonit

Formati i përgjigjes

Përgjigjet e suksesshme kthehen:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID për identifikimin e mesazhit
  • trackinId - Vargu për gjurmimin e statusit të dorëzimit

Fillimi i shpejtë

  1. Dërgo mesazhe - Fillo të dërgosh mesazhe në kaskadë
  2. Message Variables - Përdor përmbajtje dinamike
  3. Llojet e mesazheve - Eksploroni llojet e mesazheve

Shembull i kërkesës

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

Trajtimi i gabimeve

Kodet e statusit HTTP:

  • 200 OK - Kërkesa me sukses
  • 400 Kërkesë e keqe - Format i pavlefshëm i kërkesës
  • 401 i paautorizuar - Autentifikimi dështoi
  • 429 shumë kërkesa - Kufiri i tarifës u tejkalua
  • 500 Gabim i brendshëm i serverit - Gabim serveri

Përfitimet

Integrimi i vetëm

Një integrim API për të gjitha kanalet e mesazheve - nuk ka nevojë të integrohet me secilën platformë veç e veç.

Rrugë automatike

Rruga inteligjente siguron shpërndarjen e mesazhit përmes kanalit më të mirë të disponueshëm për çdo marrës.

Optimizimi i kostos

Cascade provon fillimisht kanale më të lira, duke u kthyer automatikisht në opsione më të shtrenjta vetëm kur është e nevojshme.

Norma më të larta të dorëzimit

Kanale të shumta kthimi sigurojnë që mesazhi juaj të arrijë tek marrësi edhe nëse kanali kryesor dështon.

Hapat e ardhshëm