I-skip tungo sa nilalaman

Cascade API

Ang Cascade API ay nagbibigay-daan sa pagpapadala ng mga mensahe sa maraming platform na may iisang kahilingan, awtomatikong nagruruta sa Telegram Bot, Viber Bot, Viber Business Messages, RCS, at SMS.

Base URL

https://restapi.smsbat.com

Pagpapatotoo

Gumagamit ang Cascade API ng header-based na authentication na may tatlong posibleng authentication header:

Paraan 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

Paraan 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

Paraan 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

Magagamit na Mga Endpoint

Paraan Endpoint Paglalarawan
POST /api/CascadeMessage/send_message/async Pangkalahatang cascade message na nagpapadala
POST /api/CascadeMessage/send_message/tg-viber/async Telegram-prioritized cascade

Paano Ito Gumagana

Sa isang kahilingan sa API, awtomatikong inihahatid ng Cascade ang iyong mensahe sa maraming channel:

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

Ang mensahe ay inihahatid sa pamamagitan ng unang available na channel, na may awtomatikong fallback sa susunod na channel kung nabigo ang paghahatid.

Mga Pangunahing Tampok

Multi-Channel na Paghahatid

Magpadala ng isang mensahe, abutin ang mga user sa anumang platform:

  • Telegram Bot
  • Viber Bot
  • Mga Mensahe ng Viber Business
  • RCS (Rich Communication Services)
  • SMS

Pagpapalit ng Variable

Gumamit ng dynamic na content na may mga variable na placeholder:

  • %name=id% - Mga variable ng text
  • %url=id% - Mga variable ng URL
  • %short_url=id% - Mga pinaikling variable ng URL

Pag-iiskedyul ng Mensahe

Mag-iskedyul ng mga mensahe para sa paghahatid sa hinaharap:

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

Time-to-Live (TTL)

Itakda ang oras ng pag-expire para sa mga mensahe:

{
  "ttl": 3600
}

Mga Uri ng Mensahe

Sinusuportahan ng Cascade API ang:

  • Transaksyonal - Mga pagkumpirma ng order, mga abiso
  • Promo - Mga mensahe sa marketing at pang-promosyon
  • Viber Survey - Mga interactive na survey
  • Mga Flash Call - Pag-verify sa telepono

Format ng Tugon

Nagbabalik ang mga matagumpay na tugon:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID para sa pagkilala sa mensahe
  • trackinId - String para sa pagsubaybay sa katayuan ng paghahatid

Mabilis na Pagsisimula

  1. Send Messages - Magsimulang magpadala ng mga cascade messages
  2. Mga Variable ng Mensahe - Gumamit ng dynamic na nilalaman
  3. Mga Uri ng Mensahe - Galugarin ang mga uri ng mensahe

Halimbawa ng Kahilingan

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

Error sa Paghawak

Mga code ng status ng HTTP:

  • 200 OK - Matagumpay ang kahilingan
  • 400 Bad Request - Di-wastong format ng kahilingan
  • 401 Hindi awtorisado - Nabigo ang pagpapatunay
  • 429 Masyadong Maraming Kahilingan - Lumampas sa limitasyon sa rate
  • 500 Internal Server Error - Server error

Mga Benepisyo

Iisang Pagsasama

Isang pagsasama ng API para sa lahat ng mga channel sa pagmemensahe - hindi na kailangang isama sa bawat platform nang hiwalay.

Awtomatikong Pagruruta

Tinitiyak ng matalinong pagruruta ang paghahatid ng mensahe sa pamamagitan ng pinakamahusay na magagamit na channel para sa bawat tatanggap.

Pag-optimize ng Gastos

Sinusubukan muna ng Cascade ang mas murang mga channel, awtomatikong bumabalik sa mas mahal na mga opsyon kapag kailangan lang.

Mas Mataas na Rate ng Paghahatid

Tinitiyak ng maraming fallback na channel na naaabot ng iyong mensahe ang tatanggap kahit na nabigo ang pangunahing channel.

Mga Susunod na Hakbang