Skip to content

Cascade API

L-API Cascade tippermetti li jintbagħtu messaġġi fuq pjattaformi multipli b'talba waħda, awtomatikament rotta għal Telegram Bot, Viber Bot, Viber Business Messages, RCS, u SMS.

URL tal-bażi

https://restapi.smsbat.com

Awtentikazzjoni

Cascade API juża awtentikazzjoni bbażata fuq header bi tliet headers ta' awtentikazzjoni possibbli:

Metodu 1: SMSBAT API Key

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

Metodu 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

Metodu 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

Endpoints Disponibbli

Metodu Endpoint Deskrizzjoni
POST /api/CascadeMessage/send_message/async Messaġġ kaskata ġenerali li jintbagħat
POST /api/CascadeMessage/send_message/tg-viber/async Kaskata prijoritizzata tat-telegramma

Kif Taħdem

B'talba API waħda, Cascade awtomatikament twassal il-messaġġ tiegħek fuq diversi kanali:

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

Il-messaġġ jitwassal permezz tal-ewwel kanal disponibbli, b'riżerva awtomatiku għall-kanal li jmiss jekk il-kunsinna tfalli.

Karatteristiċi Ewlenin

Kunsinna Multi-Kanali

Ibgħat messaġġ wieħed, tilħaq lill-utenti fuq kwalunkwe pjattaforma:

  • Telegram Bot
  • Viber Bot
  • Messaġġi tan-Negozju Viber
  • RCS (Servizzi ta' Komunikazzjoni Sinjuri)
  • SMS

Sostituzzjoni Varjabbli

Uża kontenut dinamiku b'placeholders varjabbli:

  • %name=id% - Varjabbli tat-test
  • %url=id% - varjabbli tal-URL
  • %short_url=id% - Varjabbli tal-URL imqassra

Skedar tal-Messaġġ

Skeda messaġġi għall-kunsinna fil-futur:

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

Time-to-Live (TTL)

Issettja l-ħin ta' skadenza għall-messaġġi:

{
  "ttl": 3600
}

Tipi ta' Messaġġi

Cascade API jappoġġja:

  • Transazzjonali - Konfermi tal-ordnijiet, notifiki
  • Promo - Messaġġi ta' kummerċjalizzazzjoni u promozzjonali
  • Stħarriġ Viber - Stħarriġ interattiv
  • Sejħiet Flash - Verifika tat-telefon

Format ta’ Rispons

Risposti b'suċċess jerġgħu lura:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID għall-identifikazzjoni tal-messaġġ
  • trackinId - String għat-traċċar tal-istatus tal-kunsinna

Quick Start

  1. Ibgħat Messaġġi - Ibda tibgħat messaġġi kaskata
  2. Varjabbli tal-Messaġġ - Uża kontenut dinamiku
  3. Tipi ta' messaġġi - Esplora tipi ta' messaġġi

Talba Eżempju

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

Immaniġġjar ta' Żbalji

Kodiċi tal-istatus HTTP:

  • "200 OK" - Talba b'suċċess
  • 400 Talba Ħażina - Format ta' talba mhux validu
  • `401 Mhux awtorizzat' - Awtentikazzjoni falliet
  • "429 Wisq Talbiet" - Inqabeż il-limitu tar-rata
  • "500 Żball Intern tas-Server" - Żball tas-server

Benefiċċji

Integrazzjoni Unika

Integrazzjoni API waħda għall-kanali kollha tal-messaġġi - l-ebda ħtieġa li tintegra ma' kull pjattaforma separatament.

Rotot Awtomatiku

Ir-rotot intelliġenti jiżgura l-kunsinna tal-messaġġi permezz tal-aħjar kanal disponibbli għal kull riċevitur.

Ottimizzazzjoni tal-Ispejjeż

Cascade tipprova kanali orħos l-ewwel, awtomatikament taqa 'lura għal għażliet aktar għaljin biss meta jkun meħtieġ.

Rati Ogħla ta' Kunsinna

Diversi kanali ta' riżerva jiżguraw li l-messaġġ tiegħek jasal lir-riċevitur anki jekk il-kanal primarju jfalli.

Il-passi li jmiss