Անցնել պարունակությանը

Cascade API

Կասկադ API-ն հնարավորություն է տալիս հաղորդագրություններ ուղարկել բազմաթիվ հարթակներում մեկ հարցումով, ավտոմատ կերպով ուղղորդելով դեպի Telegram Bot, Viber Bot, Viber Business Messages, RCS և SMS:

Հիմնական URL

https://restapi.smsbat.com

Նույնականացում

Cascade API-ն օգտագործում է վերնագրի վրա հիմնված նույնականացում երեք հնարավոր նույնականացման վերնագրերով.

Մեթոդ 1. SMSBAT API բանալի

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. 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. Telegram-ի բոտի բանալի

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

Հասանելի վերջնակետեր

Մեթոդ Վերջնակետ Նկարագրություն
ՓՈՍՏ /api/CascadeMessage/send_message/async Ընդհանուր կասկադային հաղորդագրությունների ուղարկում
ՓՈՍՏ /api/CascadeMessage/send_message/tg-viber/async Telegram-ի առաջնահերթ կասկադ

Ինչպես է այն աշխատում

Մեկ API հարցումով Կասկադը ավտոմատ կերպով փոխանցում է ձեր հաղորդագրությունը բազմաթիվ ալիքներով.

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

Հաղորդագրությունն առաքվում է առաջին հասանելի ալիքով, իսկ եթե առաքումը ձախողվի, ավտոմատ հետադարձ դեպի հաջորդ ալիք:

Հիմնական հատկանիշներ

Բազմալիքային առաքում

Ուղարկեք մեկ հաղորդագրություն, հասեք օգտվողներին ցանկացած հարթակում.

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

Փոփոխական փոխարինում

Օգտագործեք դինամիկ բովանդակություն փոփոխական տեղապահներով.

  • %name=id% - Տեքստային փոփոխականներ
  • %url=id% - URL փոփոխականներ
  • %short_url=id% - Կարճացված URL փոփոխականներ

Հաղորդագրությունների պլանավորում

Պլանավորեք հաղորդագրություններ ապագա առաքման համար.

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

Ապրելու ժամանակը (TTL)

Հաղորդագրությունների լրանալու ժամանակը սահմանեք.

{
  "ttl": 3600
}

Հաղորդագրությունների տեսակները

Cascade API-ն աջակցում է.

  • ** Գործարքային ** - Պատվերների հաստատումներ, ծանուցումներ
  • **Promo ** - Մարքեթինգային և գովազդային հաղորդագրություններ
  • Viber Surveys - Ինտերակտիվ հարցումներ
  • Ֆլեշ զանգեր - Հեռախոսի ստուգում

Պատասխանի ձևաչափ

Հաջողված պատասխանները վերադարձվում են.

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • «messageId» - հաղորդագրությունների նույնականացման GUID
  • «trackinId» - Տող՝ առաքման կարգավիճակին հետևելու համար

Արագ մեկնարկ

  1. Ուղարկել հաղորդագրություններ - Սկսեք ուղարկել կասկադային հաղորդագրություններ
  2. Message Variables - Օգտագործեք դինամիկ բովանդակություն
  3. Հաղորդագրությունների տեսակները - Ուսումնասիրեք հաղորդագրությունների տեսակները

Հարցման օրինակ

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

Սխալների մշակում

HTTP կարգավիճակի կոդերը.

  • «200 OK» - հարցումը հաջողվեց
  • «400 Վատ հարցում» - Անվավեր հարցումի ձևաչափ
  • «401 Չլիազորված» - Նույնականացումը ձախողվեց
  • «429 Չափազանց շատ հարցումներ» - Գնահատման սահմանաչափը գերազանցվել է
  • 500 ներքին սերվերի սխալ - Սերվերի սխալ

Առավելությունները

Մեկ ինտեգրում

Մեկ API ինտեգրում բոլոր հաղորդագրությունների ալիքների համար. կարիք չկա ինտեգրվելու յուրաքանչյուր հարթակին առանձին:

Ավտոմատ երթուղում

Խելացի երթուղին ապահովում է հաղորդագրությունների առաքում յուրաքանչյուր ստացողի համար լավագույն հասանելի ալիքով:

Ծախսերի օպտիմիզացում

Կասկադը նախ փորձարկում է ավելի էժան ալիքներ՝ ավտոմատ կերպով անցնելով ավելի թանկ տարբերակներին միայն անհրաժեշտության դեպքում:

Առաքման ավելի բարձր գներ

Բազմաթիվ հետադարձ կապուղիներն ապահովում են, որ ձեր հաղորդագրությունը հասնում է ստացողին, նույնիսկ եթե հիմնական ալիքը ձախողվի:

Հաջորդ քայլերը