Cascade API

Cascade 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

Method 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 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

ရနိုင်သော အဆုံးမှတ်များ

နည်းလမ်း	အဆုံးမှတ်	ဖော်ပြချက်
POST	`/api/CascadeMessage/send_message/async`	General cascade message ပို့ခြင်း
POST	`/api/CascadeMessage/send_message/tg-viber/async`	ကြေးနန်းစာ - ဦးစားပေး ကက်စ်ကိတ်

ဘယ်လိုအလုပ်လုပ်လဲ။

API တောင်းဆိုချက်တစ်ခုတည်းဖြင့်၊ Cascade သည် သင့်မက်ဆေ့ဂျ်ကို ချန်နယ်များစွာတွင် အလိုအလျောက်ပေးပို့သည်-

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

The message is delivered through the first available channel, with automatic fallback to the next channel if delivery fails.

အဓိကအင်္ဂါရပ်များ

ချန်နယ်မျိုးစုံ ပေးပို့ခြင်း။

မက်ဆေ့ချ်တစ်ခု ပို့ပါ၊ မည်သည့်ပလက်ဖောင်းပေါ်တွင်မဆို အသုံးပြုသူများထံ ဆက်သွယ်ပါ။

Telegram Bot
Viber Bot
Viber စီးပွားရေးသတင်းများ
RCS (ကြွယ်ဝသောဆက်သွယ်ရေးဝန်ဆောင်မှုများ)
SMS

ပြောင်းလဲနိုင်သော အစားထိုးမှု

ပြောင်းလဲနိုင်သော နေရာယူထားသော ဒိုင်နမစ်အကြောင်းအရာကို အသုံးပြုပါ-

%name=id% - စာသားပြောင်းလွဲမှုများ
%url=id% - URL ကိန်းရှင်များ
%short_url=id% - အတိုချုံ့ထားသော URL ကိန်းရှင်များ

မက်ဆေ့ချ် စီစဉ်ခြင်း။

အနာဂတ်ပေးပို့မှုအတွက် မက်ဆေ့ချ်များကို အချိန်ဇယားဆွဲပါ-

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

အချိန်မှ တိုက်ရိုက်ထုတ်လွှင့်ခြင်း (TTL)

မက်ဆေ့ဂျ်များအတွက် သက်တမ်းကုန်ဆုံးချိန်ကို သတ်မှတ်ပါ-

{
  "ttl": 3600
}

မက်ဆေ့ခ်ျအမျိုးအစားများ

Cascade API ကို ပံ့ပိုးသည်-

** အရောင်းအဝယ် ** - အမိန့်အတည်ပြုချက်များ၊ အသိပေးချက်များ
ပရိုမိုးရှင်း - စျေးကွက်ရှာဖွေရေးနှင့် ပရိုမိုးရှင်းမက်ဆေ့ချ်များ
Viber Surveys - အပြန်အလှန်အကျိုးပြုသော စစ်တမ်းများ
Flash Calls - ဖုန်းအတည်ပြုခြင်း။

တုံ့ပြန်မှုပုံစံ

အောင်မြင်သော တုံ့ပြန်မှုများ ပြန်လာသည်-

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]

messageId - မက်ဆေ့ဂျ်သတ်မှတ်ခြင်းအတွက် GUID
trackinId - ပေးပို့မှုအခြေအနေကို ခြေရာခံရန် စာကြောင်း

အမြန်စတင်ပါ။

Send Messages - Cascade မက်ဆေ့ခ်ျများ စတင်ပေးပို့ပါ။
Message Variables - ပြောင်းလဲနေသော အကြောင်းအရာများကို အသုံးပြုပါ။
Message Types - မက်ဆေ့ချ်အမျိုးအစားများကို စူးစမ်းပါ။

နမူနာတောင်းဆိုခြင်း။

{
  "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 Bad Request - မမှန်ကန်သော တောင်းဆိုချက်ဖော်မတ်
401 ခွင့်ပြုချက်မရှိဘဲ - အထောက်အထားစိစစ်ခြင်း မအောင်မြင်ပါ။
429 တောင်းဆိုမှု များလွန်းသည် - နှုန်းထားကန့်သတ်ချက်ကို ကျော်သွားပါပြီ။
500 အတွင်း ဆာဗာ အမှား - ဆာဗာ အမှား

အကျိုးကျေးဇူး

Single Integration

မက်ဆေ့ဂျ်ချန်နယ်အားလုံးအတွက် API ပေါင်းစည်းမှုတစ်ခု - ပလပ်ဖောင်းတစ်ခုစီနှင့် သီးခြားပေါင်းစပ်ရန် မလိုအပ်ပါ။

အလိုအလျောက်လမ်းကြောင်းပေးခြင်း

စမတ်ကျသောလမ်းကြောင်းသည် လက်ခံသူတိုင်းအတွက် အကောင်းဆုံးရရှိနိုင်သည့်ချန်နယ်မှတစ်ဆင့် မက်ဆေ့ဂျ်ပေးပို့မှုကို သေချာစေသည်။

ကုန်ကျစရိတ်ကို ပိုမိုကောင်းမွန်အောင်ပြုလုပ်ခြင်း။

Cascade သည် စျေးသက်သာသော ချန်နယ်များကို ဦးစွာ စမ်းကြည့်သည်၊ လိုအပ်သည့်အခါမှသာ ပိုစျေးကြီးသော ရွေးချယ်မှုများသို့ အလိုအလျောက် ပြန်ကျသွားပါသည်။

ပိုမိုမြင့်မားသော ပို့ဆောင်ခနှုန်းထားများ

ပင်မချန်နယ် ပျက်သွားသော်လည်း သင့်မက်ဆေ့ဂျ်သည် လက်ခံသူထံသို့ ရောက်ရှိကြောင်း ချန်နယ်များစွာမှ သေချာစေသည်။

နောက်အဆင့်များ

Send Cascade Messages - စာတိုပေးပို့နည်းကို လေ့လာပါ။
Message Variables - တက်ကြွသောအကြောင်းအရာများဖြင့် အလုပ်လုပ်ပါ။
Message Types - ရနိုင်သော မက်ဆေ့ခ်ျအမျိုးအစားများကို စူးစမ်းပါ။