Kihagyás

Cascade API

A Cascade API lehetővé teszi az üzenetek küldését több platformon egyetlen kéréssel, automatikusan irányítva a Telegram Bot, a Viber Bot, a Viber Business Messages, az RCS és az SMS-eket.

Alap URL

https://restapi.smsbat.com

Hitelesítés

A Cascade API fejléc alapú hitelesítést használ három lehetséges hitelesítési fejléccel:

1. módszer: SMSBAT API-kulcs

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

2. módszer: 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

3. módszer: 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

Elérhető végpontok

Módszer Végpont Leírás
POST /api/CascadeMessage/send_message/async Általános kaszkád üzenetküldés
POST /api/CascadeMessage/send_message/tg-viber/async Telegram prioritású kaszkád

Hogyan működik

Egyetlen API-kéréssel a Cascade automatikusan több csatornán keresztül továbbítja üzenetét:

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

Az üzenet kézbesítése az első elérhető csatornán keresztül történik, automatikus visszalépéssel a következő csatornára, ha a kézbesítés sikertelen.

Főbb jellemzők

Többcsatornás kézbesítés

Küldj egy üzenetet, érd el a felhasználókat bármely platformon:

  • Telegram Bot
  • Viber Bot
  • Viber üzleti üzenetek
  • RCS (gazdag kommunikációs szolgáltatások)
  • SMS

Változó helyettesítése

Dinamikus tartalom használata változó helyőrzőkkel:

  • %name=id% - Szövegváltozók
  • %url=id% - URL-változók
  • %short_url=id% - Rövidített URL-változók

Üzenetütemezés

Üzenetek ütemezése jövőbeli kézbesítéshez:

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

Életig tartó idő (TTL)

Állítsa be az üzenetek lejárati idejét:

{
  "ttl": 3600
}

Üzenettípusok

A Cascade API támogatja:

  • Tranzakciós - Rendelési visszaigazolások, értesítések
  • Promó - Marketing és promóciós üzenetek
  • Viber Surveys - Interaktív felmérések
  • Flash hívások - Telefonos ellenőrzés

Válaszformátum

A sikeres válaszok visszaküldése:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • "messageId" - GUID az üzenet azonosításához
  • "trackinId" - Karakterlánc a kézbesítési állapot nyomon követéséhez

Gyorsindítás

  1. Üzenetek küldése - Kezdje el a lépcsőzetes üzenetek küldését
  2. Üzenetváltozók – Használjon dinamikus tartalmat
  3. Üzenettípusok – Fedezze fel az üzenettípusokat

Példa kérésre

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

Hibakezelés

HTTP állapotkódok:

  • "200 OK" - A kérés sikeres
  • 400 hibás kérés - Érvénytelen kérésformátum
  • 401 Jogosulatlan - A hitelesítés nem sikerült
  • 429 Túl sok kérés - Túllépte a sebességkorlátot
  • "500 Belső szerverhiba" - Szerverhiba

Előnyök

Egyetlen integráció

Egy API-integráció az összes üzenetküldési csatornához – nincs szükség az egyes platformokkal külön-külön történő integrációra.

Automatikus útválasztás

Az intelligens útválasztás biztosítja az üzenetek kézbesítését a legjobb elérhető csatornán keresztül minden egyes címzett számára.

Költségoptimalizálás

A Cascade először az olcsóbb csatornákat próbálja ki, és csak szükség esetén tér vissza automatikusan a drágább lehetőségekhez.

Magasabb kézbesítési árak

Több tartalék csatorna biztosítja, hogy üzenete akkor is eljusson a címzetthez, ha az elsődleges csatorna meghibásodik.

Következő lépések