TurboSMS API လိုက်ဖက်မှု

SMSBAT သည် TurboSMS API နှင့် တွဲဖက်အသုံးပြုနိုင်သော အလွှာတစ်ခုကို အပြည့်အဝ ပံ့ပိုးပေးပါသည်။ ၎င်းသည် သင့်အား TurboSMS အတွက် ဒီဇိုင်းထုတ်ထားသည့် သင်၏လက်ရှိပေါင်းစပ်မှုများကို SMSBAT သို့ တိုက်ရိုက်ပြောင်းရွှေ့နိုင်စေမည့် မက်ဆေ့ချ်ဖွဲ့စည်းပုံများ သို့မဟုတ် အဆုံးမှတ်ပေးချေမှုများကို ပြန်လည်ရေးသားရန် မလိုအပ်ပါ။

ကျွန်ုပ်တို့သည် SMS နှင့် Viber မက်ဆေ့ချ်များပေးပို့ခြင်း (အဝိုင်းလေးများနှင့် စစ်တမ်းများကဲ့သို့ အဆင့်မြင့်အင်္ဂါရပ်များအပါအဝင်)၊ သင်နှင့်ရင်းနှီးပြီးသား တောင်းဆိုမှုကိုယ်ထည်တည်ဆောက်ပုံများကို အသုံးပြု၍ အခြေအနေများကို ရယူခြင်းနှင့် မက်ဆေ့ချ်အသေးစိတ်အချက်အလက်များကို ရယူခြင်းတို့ကို ပံ့ပိုးပေးပါသည်။

စစ်မှန်ကြောင်းအထောက်အထားပြခြင်း။

မူရင်း TurboSMS API မှ တစ်ခုတည်းသော ကွာခြားချက်မှာ အထောက်အထားစိစစ်ခြင်း ယန္တရားဖြစ်သည်။ TurboSMS သည် စိတ်ကြိုက် token query parameter သို့မဟုတ် သီးခြား auth header ကိုအသုံးပြုသော်လည်း SMSBAT သည် စံ Bearer Token လိုအပ်ပါသည်။

တောင်းဆိုမှုအားလုံးအတွက် ‘ခွင့်ပြုချက်’ ခေါင်းစီးတွင် သင်၏ SMSBAT API တိုကင်ကို ထည့်သွင်းရပါမည်-

Authorization: Bearer YOUR_SMSBAT_TOKEN

အခြေခံ URL

အဆုံးမှတ်အားလုံးကို SMSBAT API အခြေခံ URL သို့ ဦးတည်သင့်သည်-

https://restapi.smsbat.com

---

မက်ဆေ့ခ်ျတစ်ခုတည်း ပို့ပါ။

အဆုံးမှတ်- POST /api/tsms/message/send

ပေါင်းစပ်ပေးပို့ခြင်းအတွက် ပံ့ပိုးမှုဖြင့် SMS နှင့် Viber မက်ဆေ့ချ်များ ပေးပို့ခြင်းအား ခွင့်ပြုသည် (Viber with SMS fallback)။ ၎င်းသည် ပေးပို့ရန် တောင်းဆိုချက်တစ်ခုတည်းကို လုပ်ဆောင်ပြီး လက်ခံသူတိုင်းအတွက် ပေးပို့မှုရလဒ်များကို ပြန်ပေးသည်။

အဓိကလုပ်ဆောင်နိုင်စွမ်း

• ** ပြောင်းလွယ်ပြင်လွယ်ရှိသော ကန့်သတ်ချက်များ-** ကမ္ဘာလုံးဆိုင်ရာ ကန့်သတ်ချက်များကို သီးခြား SMS/Viber ကန့်သတ်ချက်များဖြင့် လွှမ်းမိုးနိုင်သည်။
• ** အကြောင်းအရာ-** Viber အဝိုင်းလေး၊ စစ်တမ်းများ၊ ဖိုင် ပူးတွဲပါဖိုင်များနှင့် အပြန်အလှန်အကျိုးပြုသော ခလုတ်များကို ပံ့ပိုးပေးသည်။
• အမှားအယွင်းများကို ကိုင်တွယ်ခြင်း- အမှားများ (ဖွဲ့စည်းတည်ဆောက်ထားသော အမှားတုံ့ပြန်မှုများ) အတွက်ပင် HTTP 200 ကို ပြန်ပေးသည်။ စနစ်အမှားများအတွက် FATAL_ERROR အနေအထားဖြင့် တုံ့ပြန်မှု_ကုဒ်- 999။
• လက်ခံသူအမှားများ- သတ်မှတ်ထားသော လက်ခံသူအမှားများကို တုံ့ပြန်မှု_ရလဒ် အခင်းအကျင်းတွင် ပြန်ပေးသည်။ မအောင်မြင်သော လက်ခံသူများသည် message_id: null နှင့် သတ်မှတ်ထားသော အမှားကုဒ်များ ရှိသည်။

တောင်းဆိုမှု နမူနာ (ပေါင်းစပ်မက်ဆေ့ဂျ်)

{
  "sender": "GlobalSender",
  "text": "Test message",
  "recipients": ["380951111111", "380952222222"],
  "start_time": "2025-09-29T10:00:00Z",
  "sequence_id": "seq_12345",
  "sms": {
    "sender": "SMSSender",
    "text": "SMS version of message",
    "is_flash": false
  },
  "viber": {
    "sender": "ViberSender",
    "text": "Viber version of message",
    "ttl": 3600,
    "image_url": "https://example.com/image.png",
    "caption": "Button text",
    "action": "https://google.com",
    "count_clicks": true,
    "is_transactional": false
  }
}

တောင်းဆိုမှု နမူနာ (Viber ဝိုင်းလေး)

{
  "sender": "GlobalSender",
  "text": "Check out our products",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Check out our products",
    "is_transactional": false,
    "carousel": [
      {
        "title": "Product 1",
        "image_url": "https://example.com/product1.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product1",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product1"
      },
      {
        "title": "Product 2",
        "image_url": "https://example.com/product2.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product2",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product2"
      }
    ]
  }
}

တောင်းဆိုမှု နမူနာ (Viber Survey)

{
  "sender": "GlobalSender",
  "text": "Please rate our service",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Please rate our service",
    "is_transactional": true,
    "survey": [
      "Excellent",
      "Good",
      "Average",
      "Poor"
    ]
  }
}

---

မက်ဆေ့ခ်ျများစွာ (အသုတ်) ပို့ပါ

အဆုံးမှတ်- POST /api/tsms/message/sendmulti

ဤနည်းလမ်းသည် သင့်အား HTTP တောင်းဆိုချက်တစ်ခုတည်းတွင် send တောင်းဆိုချက်များစွာကို ပေးပို့နိုင်ပြီး ချိတ်ဆက်မှုအပေါ်ကို ချွေတာနိုင်သည်။ တောင်းဆိုချက် 100 အတွက် ဒေတာဖြင့် sendmulti ကိုခေါ်ဆိုခြင်းသည် တစ်ဦးချင်း send တောင်းဆိုချက် 100 ကို လုပ်ဆောင်ခြင်းထက် ပိုမိုမြန်ဆန်မည်ဖြစ်ပါသည်။

ဥပမာ တောင်းဆိုခြင်း။

{
  "batch_1": {
    "sender": "GlobalSender",
    "text": "Test message",
    "recipients": ["380982462128", "380501111111"],    
    "sms": {
        "sender": "SMSSender",
        "text": "SMS version of message"
    }
  },
  "batch_2": {
    "sender": "GlobalSender",
    "text": "Second message",
    "recipients": ["380501111111"],
    "viber": {
      "sender": "ViberSender",
      "text": "Viber message",
      "is_transactional": true
    }
  }
}

တုံ့ပြန်မှုဥပမာ

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": {
        "batch_1": {
            "response_code": 800,
            "response_status": "SUCCESS_MESSAGE_ACCEPTED",
            "response_result": [
                {
                    "phone": "380982462128",
                    "response_code": 0,
                    "message_id": "f1640579-ea75-4bc1-b708-1c3858bf222d",
                    "response_status": "OK"
                }
            ]
        },
        "batch_2": { ... }
    }
}

---

Message Status ကိုရယူပါ။

အဆုံးမှတ်- POST /api/tsms/message/status

၎င်းတို့၏ message_id ကို ပေးခြင်းဖြင့် ပေးပို့ထားသော စာများ၏ ပေးပို့မှု အခြေအနေများကို ပြန်လည်ရယူပါ။

ဥပမာ တောင်းဆိုခြင်း။

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "6b7f9ff5-28c8-4f38-913b-31af6021fbea"
  ]
}

---

Message အသေးစိတ်ကို ရယူပါ။

အဆုံးမှတ်- POST /api/tsms/message/details

SMS နှင့် Viber ချန်နယ်များ၊ စျေးနှုန်းနှင့် အချိန်အတိအကျ တံဆိပ်တုံးများ အပါအဝင် ဖန်တီးထားသော မက်ဆေ့ချ်များ၏ အသေးစိတ်အချက်အလက်များကို ထုတ်ယူနိုင်စေပါသည်။

ဥပမာ တောင်းဆိုခြင်း။

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "f1640579-ea75-4bc1-b708-1c3858bf222d"
  ]
}

တုံ့ပြန်မှုဥပမာ

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": [
        {
            "message_id": "573dcb46-7851-4e16-bb1f-721c13ef5f38",
            "sms": null,
            "viber": {
                "added": "2025-09-29T14:17:02.577Z",
                "start": "2025-09-29T10:00:00Z",
                "sent": "2025-09-29T14:17:02.577Z",
                "updated": "2025-09-29T14:17:02.577Z",
                "sender": "ViberSender",
                "text": "Viber version of message",
                "recipient": "380982462128",
                "message_type": "promotional",
                "status": "Queued",
                "price": 0,
                "ttl": 3600,
                "caption": "Button text",
                "action": "https://google.com"
            },
            "response_code": 0,
            "response_status": "OK"
        }
    ]
}