SMS မက်ဆေ့ချ်များ

SMSBAT API ကို အသုံးပြု၍ ပုံမှန် စာတိုများ ပို့ပါ။ SMS သည် မိုဘိုင်းလ်စက်ပစ္စည်းများအားလုံးတွင် အမြင့်ဆုံး ပေးပို့မှုနှုန်းထားဖြင့် ကမ္ဘာလုံးဆိုင်ရာ စာတိုပေးပို့မှု ချန်နယ်ဖြစ်သည်။

ခြုံငုံသုံးသပ်ချက်

SMS (Short Message Service) သည်-

• အချိန်အရေးပါသောသတိပေးချက်များ
• Viber/RCS မက်ဆေ့ဂျ်များအတွက် Fallback
• စမတ်ဖုန်းမပါဘဲအသုံးပြုသူများထံသို့ရောက်ရှိ
• မိုဘိုင်းကွန်ရက်များအားလုံးတွင် တစ်ကမ္ဘာလုံး လိုက်ဖက်ညီမှု
• မြင့်မားသောပို့ဆောင်မှုနှုန်း (95%+)

အခြေခံ SMS Message

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

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

ကန့်သတ်ချက်များ

ကန့်သတ်ချက်	ရိုက်	လိုအပ်သည်	ဖော်ပြချက်
from	string	ဟုတ်တယ်	အက္ခရာဂဏန်း ပေးပို့သူ ID (စာလုံး 11 လုံးအထိ)
to	string	ဟုတ်တယ်	လက်ခံသူဖုန်းနံပါတ် E.164 ဖော်မတ်
ရိုက်	string	ဟုတ်တယ်	"sms"
စာသား	string	ဟုတ်တယ်	မက်ဆေ့ခ်ျအကြောင်းအရာ
customerMessageId	string	မရှိ	သင့်အတွင်းပိုင်း ခြေရာခံ ID
ttl	ကိန်းပြည့်	မရှိ	Time-to-s live in စက္ကန့်

ဥပမာများ

ရိုးရှင်းသော SMS

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

ဖောက်သည် ID ဖြင့် SMS

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

TTL ဖြင့် SMS

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

အက္ခရာ Encoding

GSM 7-bit Encoding

ပုံမှန် GSM အက္ခရာ (SMS တစ်ခုလျှင် အက္ခရာ 160)-

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

တိုးချဲ့ထားသော GSM စာလုံးများ

ဤအက္ခရာများကို အက္ခရာ 2 လုံးအဖြစ် ရေတွက်သည်-

| ^ € { } [ ] ~ \

Unicode (UCS-2) Encoding

အထူးအက္ခရာများပါသော မက်ဆေ့ချ်များသည် ယူနီကုဒ် ကုဒ်နံပါတ်ကို အသုံးပြုသည် (SMS တစ်ခုလျှင် စာလုံး 70 လုံး)

• အီမိုဂျီ- 😀 🎉 ❤️
• Cyrillic: А Б В Г Д Е Ж
• အထူးသင်္ကေတများ- ✓ ✗ ★ ♥

မက်ဆေ့ဂျ်အရှည်

SMS တစ်ခုတည်း

• GSM 7-bit- စာလုံးရေ ၁၆၀
• Unicode: စာလုံး 70 လုံး

အပိုင်းပေါင်းများစွာ SMS

သင့်မက်ဆေ့ချ်သည် ကန့်သတ်ချက်ထက်ကျော်လွန်သောအခါ၊ ၎င်းကို အပိုင်းများစွာသို့ ခွဲသွားသည်-

• GSM 7-bit- တစ်ပိုင်းလျှင် စာလုံးရေ 153 လုံး
• Unicode: တစ်ပိုင်းလျှင် စာလုံး 67 လုံး

ဥပမာ

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

ဤမက်ဆေ့ဂျ် (စာလုံး 201 လုံး) ကို အပိုင်း ၂ ပိုင်းခွဲပါမည်။

တုံ့ပြန်မှု

အောင်မြင်မှုတုံ့ပြန်ခြင်း။

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

တုံ့ပြန်မှုနယ်ပယ်များ

လယ်	ဖော်ပြချက်
messageId	ခြေရာခံခြင်း
အဆင့်အတန်း	မက်ဆေ့ခ်ျအခြေအနေ (လက်ခံသည်၊ ပယ်ချသည်)
အပိုင်း	SMS အစိတ်အပိုင်းများ
to	လက်ခံသူဖုန်းနံပါတ်

ပေးပို့သူ ID

အက္ခရာဂဏန်း ပေးပို့သူ

ပေးပို့သူအဖြစ် သင့်အမှတ်တံဆိပ်အမည်ကို အသုံးပြုပါ (စာလုံး 11 လုံးအထိ)

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

ကန့်သတ်ချက်များ-

• အများဆုံး 11 လုံး
• စာလုံးများနှင့်နံပါတ်များသာ
• နေရာလွတ်များ သို့မဟုတ် အထူးဇာတ်ကောင်များမရှိပါ။
• လက်ခံသူသည် အက္ခရာဂဏန်းဖြင့် ပေးပို့သူများထံ စာမပြန်နိုင်ပါ။

ဂဏန်းပေးပို့သူ

ပေးပို့သူအဖြစ် ဖုန်းနံပါတ်ကို အသုံးပြုပါ (နှစ်လမ်းသွား SMS အတွက်)

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Cases ကိုအသုံးပြုပါ။

OTP အတည်ပြုခြင်း။

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

မှာယူမှု အသိပေးချက်

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

ရက်ချိန်းသတိပေးချက်များ

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

ငွေပေးချေမှု အတည်ပြုချက်များ

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

အကောင်းဆုံးအလေ့အကျင့်များ

Message အကြောင်းအရာ

• ✅ မက်ဆေ့ချ်များကို တိုတိုရှင်းရှင်းထားပါ။
• ✅ ပေးပို့သူ၏ အထောက်အထားကို ထည့်သွင်းပါ။
• ✅ လိုအပ်ပါက call-to-action ထည့်ပါ။
• ✅ မှန်ကန်သောသဒ္ဒါနှင့် စာလုံးပေါင်းကို အသုံးပြုပါ။
• ❌ အလွန်အကျွံ သတ်ပုံဖြတ်ခြင်းကို ရှောင်ကြဉ်ပါ။
• ❌ CAPS အားလုံးကို မသုံးပါနှင့်
• ❌ သံသယဖြစ်ဖွယ်ရှိသော URL အတိုကောက်များကို ရှောင်ကြဉ်ပါ။

ဇာတ်ကောင်အသုံးပြုမှု

• ပေးပို့ခြင်းမပြုမီဇာတ်ကောင်အရေအတွက်ကိုစစ်ဆေးပါ။
• တိုးချဲ့ထားသော GSM စာလုံးများကို သတိပြုပါ (2 အဖြစ်ရေတွက်ပါ)
• အစုလိုက်မပို့မီ အထူးဇာတ်ကောင်များဖြင့် စမ်းသပ်ပါ။
• ပိုရှည်သော မက်ဆေ့ချ်များအတွက် GSM ကုဒ်ကို အသုံးပြုရန် စဉ်းစားပါ။

ဖုန်းနံပါတ်များ

• E.164 ဖော်မတ်- +380XXXXXXXXX ကို အမြဲသုံးပါ။
• မပေးပို့မီ ဖုန်းနံပါတ်များကို စစ်ဆေးပါ။
• သင့်စာရင်းမှ မမှန်ကန်သောနံပါတ်များကို ဖယ်ရှားပါ။
• သင့်အဆက်အသွယ်စာရင်းကို အပ်ဒိတ်လုပ်ထားပါ။

အချိန်ကိုက်

• ဒေသစံတော်ချိန်ကို လေးစားပါ။
• ည (၁၀) နာရီမှ ည (၈) နာရီအတွင်း ပေးပို့ခြင်းကို ရှောင်ကြဉ်ပါ။
• စီးပွားရေးဆိုင်ရာ မက်ဆေ့ချ်များအတွက် အလုပ်ချိန်ကို ထည့်သွင်းစဉ်းစားပါ။
• အချိန်ထိခိုက်လွယ်သော မက်ဆေ့ချ်များအတွက် သင့်လျော်သော TTL ကို သတ်မှတ်ပါ။

လိုက်နာခြင်း။

• စျေးကွက်ရှာဖွေရေးမက်ဆေ့ခ်ျများမပို့မီသဘောတူညီချက်ရယူပါ။
• ပရိုမိုးရှင်း SMS အတွက် ဖယ်ထုတ်ရန် ညွှန်ကြားချက်များ ထည့်သွင်းပါ။
• ဒေသဆိုင်ရာစည်းမျဉ်းများ (GDPR စသည်ဖြင့်) လိုက်နာပါ။
• “မနှောင့်ယှက်ရ” စာရင်းများကို လေးစားပါ။

ကိုင်တွယ်မှုအမှား

အဖြစ်များသောအမှားများ

အမှား	အကြောင်းရင်း	ဖြေရှင်းချက်
INVALID_RECIPIENT	ဖုန်းဖော်မတ်မှား	E.164 ဖော်မတ်
INVALID_SENDER	မမှန်ကန်သော ပေးပို့သူ ID	ပေးပို့သူ ID စည်းမျဉ်းများ
MESSAGE_TOO_LONG	အများဆုံး အရှည်	မက်ဆေ့ချ်ကို ခွဲရန် သို့မဟုတ် အတိုချုံ့ပါ။
INVALID_ENCODING	ပံ့ပိုးမထားသော စာလုံးများ	GSM သို့မဟုတ် ယူနီကုဒ်

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

မက်ဆေ့ချ်အပိုင်းများကို လျှော့ချပါ။

• စာလုံးရေ 160 (GSM) သို့မဟုတ် 70 (Unicode) အောက်တွင် စာတိုများကို သိမ်းဆည်းပါ။
• ယူနီကုဒ်ကို အစပြုသော အထူးစာလုံးများကို ရှောင်ကြဉ်ပါ။
• သင့်လျော်သည့်အခါ အတိုကောက်များကို အသုံးပြုပါ။
• မလိုအပ်သောနေရာများကိုဖယ်ရှားပါ။

ဥပမာ Optimization

❌ မတိုင်မှီ (171 လုံး၊ SMS 2 စောင်)။

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ ပြီးနောက် (စာလုံးရေ 156 လုံး၊ 1 SMS)

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

အစုလိုက်ပို့ခြင်း။

တောင်းဆိုချက်တစ်ခုတွင် မက်ဆေ့ခ်ျများစွာ ပို့ပါ-

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

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

• Viber Messages - ကြွယ်ဝသောမီဒီယာစာတိုပေးပို့ခြင်း။
• RCS Messages - ကြွယ်ဝသော ဆက်သွယ်ရေးဝန်ဆောင်မှုများ
• Check Status - ပေးပို့မှုအခြေအနေကို ခြေရာခံပါ။
• Fallback Strategies - မှားယွင်းမှုများကို စီစဉ်သတ်မှတ်ပါ။