အကြောင်းအရာသို့ ကရန်

Viber မက်ဆေ့ခ်ျ

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

မက်ဆေ့ဂျ်အမျိုးအစားများ ခြုံငုံသုံးသပ်ချက်

ရိုက် ရည်ရွယ်ချက် ကြွယ်ဝသောမီဒီယာ အပြန်အလှန်အကျိုးပြု
viber_promo စျေးကွက်လှုပ်ရှားမှုများ ✅ Images, Videos ✅ ခလုတ်များ
viber_trans အရောင်းအဝယ်ဆိုင်ရာ အသိပေးချက်များ ✅ PDFs ❌
viber_carousel ထုတ်ကုန်ပြပွဲများ ✅ ပုံများ ✅ ခလုတ်မျိုးစုံ
viber_survey စစ်တမ်းများနှင့် တုံ့ပြန်ချက် ❌ ✅ ရွေးချယ်စရာမျိုးစုံ
viber_otp တစ်ကြိမ်စကားဝှက်များ ❌ ❌

Viber ပရိုမိုးရှင်း

စျေးကွက်ရှာဖွေရေး ကမ်ပိန်းများအတွက် ကြွယ်ဝသော မီဒီယာပံ့ပိုးမှုဖြင့် ပရိုမိုးရှင်းစာတိုများ။

ပံ့ပိုးထားသော အကြောင်းအရာ

  • ရုပ်ပုံသီးသန့်
  • စာသားသာ
  • စာသား + ခလုတ်
  • ပုံ + စာသား + ခလုတ်
  • ဗီဒီယို + စာသား
  • ဗီဒီယို + စာသား + ခလုတ်
  • ဗီဒီယိုသာ

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

ကန့်သတ်ချက် ရိုက် လိုအပ်သည် ဖော်ပြချက်
img string မရှိ ပုံ URL
ဗီဒီယို string မရှိ ဗီဒီယိုဖိုင် URL
ပုံငယ် string မရှိ ဗီဒီယို အစမ်းကြည့်ပုံ
buttonText string မရှိ လုပ်ဆောင်ရန် ခလုတ်တံဆိပ်
buttonAction string မရှိ URL ဦးတည်ရာ
fileSize ကိန်းပြည့် မရှိ ဗီဒီယိုဖိုင်အရွယ်အစား
ကြာချိန် ကိန်းပြည့် မရှိ ဗီဒီယို အရှည် စက္ကန့်

ဥပမာများ

စာသား + ရုပ်ပုံ + ခလုတ်

စာသား + ရုပ်ပုံ + ခလုတ် နမူနာ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

ဗီဒီယို + စာသား + ခလုတ်

ဗီဒီယို + စာသား + ခလုတ် နမူနာ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

ရုပ်ပုံသီးသန့်

Image Only Example

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

စာသားသီးသန့်

Text Only Example

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

ဗီဒီယိုသီးသန့်

ဗီဒီယိုသာ နမူနာ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

ဗီဒီယို + စာသား

ဗီဒီယို + စာသားနမူနာ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Viber ငွေလွှဲခြင်း။

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

ပံ့ပိုးထားသော အကြောင်းအရာ

  • စာသားသာ
  • PDF ဖိုင် + စာသား
  • PDF ဖိုင်သာ

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

ကန့်သတ်ချက် ရိုက် လိုအပ်သည် ဖော်ပြချက်
fileUrl string မရှိ PDF စာရွက်စာတမ်း URL
ဖိုင်အမည် string မရှိ ပူးတွဲပါဖိုင်
fileType string မရှိ ဖိုင်အမျိုးအစား ("pdf")

ဥပမာများ

စာသားသီးသန့်

Text Only Example

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

စာသား + PDF

စာသား + PDF ဥပမာ

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

PDF သီးသန့်

PDF Only Example

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Viber ဝိုင်းလေး

ထုတ်ကုန်များ သို့မဟုတ် အကြောင်းအရာများအတွက် ရှာဖွေကြည့်နိုင်သော ခင်းကျင်းပြသထားသော အရာများစွာ။

ဖွဲ့စည်းပုံ

တစ်ခုစီတွင် ပါဝင်သော အဝိုင်းလေးများ၏ အခင်းအကျင်း၊

  • ခေါင်းစဉ်
  • ပုံ
  • မူလခလုတ် (ပင်မလုပ်ဆောင်ချက်)
  • ဒုတိယခလုတ် (အစားထိုးလုပ်ဆောင်ချက်)

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

ကန့်သတ်ချက် ရိုက် လိုအပ်သည် ဖော်ပြချက်
ဝိုင်းလေး ခင်းကျင်း ဟုတ်တယ် အဝိုင်းလေးများ
items ခင်းကျင်း ဟုတ်တယ် တစ်ဦးချင်းကတ်္

ဥပမာ

Viber ဝိုင်းလေး ဥပမာ

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

Viber Survey

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

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

ကန့်သတ်ချက် ရိုက် လိုအပ်သည် ဖော်ပြချက်
စစ်တမ်း အရာဝတ္ထု ဟုတ်တယ် မြေတိုင်းပုံး
ရွေးချယ်စရာများ ခင်းကျင်း ဟုတ်တယ် 1-5 အဖြေရွေးချယ်မှုများ

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

  • အများဆုံးတုံ့ပြန်မှုရွေးချယ်စရာ 5 ခုကိုပံ့ပိုးထားသည်။
  • ရွေးချယ်မှုတစ်ခုစီသည် တိုတိုလေးဖြစ်သင့်သည် (အကြံပြုထားသည်- စာလုံး 30 အောက်)

ဥပမာ

Viber စစ်တမ်းနမူနာ

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

Viber OTP

ကြိုတင်သတ်မှတ်ထားသော ပုံစံများဖြင့် တစ်ကြိမ်စကားဝှက်ပေးပို့ခြင်း။

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

  • ကြိုတင်သတ်မှတ်ထားသော ပုံစံ ၉ ခု
  • ကန့်သတ်ချက်များ အတည်ပြုခြင်း (TEXT၊ NUMBER အမျိုးအစား)
  • ဘာသာစကားမျိုးစုံပံ့ပိုးမှု (19 ဘာသာစကား)
  • Case-sensitive variable အမည်များ

ပံ့ပိုးထားသော ဘာသာစကားများ

ယူကရိန်း၊ အင်္ဂလိပ်၊ ရုရှား၊ ပိုလန်၊ ရိုမေးနီးယား၊ စပိန်၊ ဂျာမန်၊ ပြင်သစ်၊ အီတလီ၊ ပေါ်တူဂီ၊ ဒတ်ခ်ျ၊ တူရကီ၊ အာရပ်၊ ဟီဘရူး၊ ဟိန္ဒီ၊ တရုတ်၊ ဂျပန်၊ ကိုရီးယား၊ ဗီယက်နမ်

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

ကန့်သတ်ချက် ရိုက် လိုအပ်သည် ဖော်ပြချက်
templateId string (UUID) ဟုတ်တယ် နမူနာပုံစံ အမှတ်အသား
templateLang string ဟုတ်တယ် ISO ဘာသာစကားကုဒ်
templateParams အရာဝတ္ထု ဟုတ်တယ် ပုံစံခွက်

ဥပမာ

Viber OTP ဥပမာ

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

နမူနာပုံစံ- "မင်းရဲ့ကုဒ်- 123456။ 10 မိနစ်အထိ အကျုံးဝင်ပါတယ်။ ဒီကုဒ်ကို ဘယ်တော့မှ မမျှဝေပါနဲ့။"

ပံ့ပိုးထားသော ပုံစံများနှင့် အတည်ပြုချက်များ

Viber သည် ကြိုတင်သတ်မှတ်ထားပြီး တင်းကြပ်စွာ ထိန်းချုပ်ထားသော ပုံစံများကို ပေးဆောင်သည်။ ပေးထားသော ကိန်းရှင်ဘောင်များသည် မှန်ကန်သောဒေတာအမျိုးအစားများနှင့် ကိုက်ညီရပါမည်။

ဒေတာအမျိုးအစားများ- - NUMBER- [0-9]၊ +၊ - နှင့် . ဂဏန်းများသာ။ / သို့မဟုတ် whitespace ကဲ့သို့သော သင်္ကေတများကို ပံ့ပိုးမထားပါ။ - TEXT: မည်သည့် ဘာသာစကား အက္ခရာ၊ သင်္ကေတများ (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc)။ - ပုံမှန်မြေပုံဆွဲခြင်း- <letters> ၏ sequence သည် <number> sequence နှင့် ကပ်လျက် မတည်ရှိနိုင်ပါ။ ၎င်းတို့သည် နေရာလွတ် ခွဲခြားရန် လိုအပ်သည်။ တင်းပလိတ်များအတွင်းတွင် အဖြူကွက်နှစ်ထပ် `` ကို ယေဘုယျအားဖြင့် တားမြစ်ထားသည်။ လင့်ခ်များအတွက်၊ ၎င်းတို့သည် ကန့်သတ်ချက်များထက်ကျော်လွန်ပါက နေရာလွတ်များကို ရှောင်ကြဉ်ပါ။

အောက်တွင် Standard ISO template 9 ခု ရှိပါသည်။ သတ်မှတ်ထားသောနိုင်ငံများတွင် သင်၏မှတ်ပုံတင်ခြင်းလိုအပ်ချက်များအပေါ်အခြေခံ၍ ID များကို အစားထိုးပါ။ နောက်ထပ်ဘာသာစကားများထည့်ပါက ပံ့ပိုးကူညီမှုထံ ဆက်သွယ်ပါ။

1. "ကုဒ်သက်သက် (မည်သည့်ပင်နံပါတ်)"

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

2. "လုပ်ဆောင်ချက်- ဤကုဒ်ကို အသုံးပြုပါ"

ကန့်သတ်ချက်များ- {pin} (NUMBER သို့မဟုတ် TEXT) ဥပမာ ဖော်မတ်- "အတည်ပြုရန်အတွက် ဤကုဒ် {pin} ကို အသုံးပြုပါ။"

3. "အမှတ်တံဆိပ် မှတ်ပုံတင်ခြင်း/ဝင်ရောက်ခွင့်"

ကန့်သတ်ချက်များ- {business_platform_name} (TEXT), {pin} (NUMBER သို့မဟုတ် TEXT) ဥပမာ ဖော်မတ်- "{business_platform_name} အတွက် သင့်ကုဒ်သည် {pin} ဖြစ်သည်။

4. "ကုဒ်အတည်ပြုချိန်"

ကန့်သတ်ချက်များ- {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) ဥပမာ ဖော်မတ်- "သင်၏ အတည်ပြုကုဒ်သည် {pin} ဖြစ်သည်။ ၎င်းသည် {code_validity_time} မိနစ်အတွက် အကျုံးဝင်ပါသည်။"

5. "Brand Access & Code Validation"

ကန့်သတ်ချက်များ- {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) ဥပမာဖော်မတ်- "{business_platform_name} အတည်ပြုကုဒ်သည် {pin} သည် {code_validity_time} မိနစ်အတွက် အကျုံးဝင်ပါသည်။"

(မှတ်ချက်- pin၊ business_platform_name နှင့် code_validity_time အသုံးပြုမှု ပေါင်းစပ်မှုများအပေါ် အခြေခံ၍ Viber စံ OTP စည်းမျဉ်းများအတွက် ကြိုတင်သတ်မှတ်ထားသော structural block 9 ခုအထိ ရှိပါသည်။

အထွေထွေလိုအပ်ချက်များ

Viber မက်ဆေ့ခ်ျအမျိုးအစားအားလုံး လိုအပ်သည်-

  • from- အက္ခရာဂဏန်း ပေးပို့သူ ID
  • to- E.164 ဖော်မတ်ရှိ ဖုန်းနံပါတ်
  • type: မက်ဆေ့ချ် အမျိုးအစား သတ်မှတ်မှု
  • ttl- စက္ကန့်ပိုင်းအတွင်း မက်ဆေ့ချ်သက်တမ်းကုန်ဆုံးချိန် (အကြံပြုထားသည်)

SMS သို့ ပြန်ပြောင်း

Viber မက်ဆေ့ခ်ျအမျိုးအစားအားလုံးသည် fallbacks array ပိတ်ဆို့ခြင်းကို အသုံးပြု၍ SMS တုံ့ပြန်မှုကို ပံ့ပိုးပေးသည်။ Viber ပေးပို့မှု မအောင်မြင်ပါက၊ မက်ဆေ့ဂျ်သည် အစားထိုးပြင်ဆင်ထားသော ချန်နယ်များသို့ အလိုအလျောက် ပြန်ကျသွားပါသည်။

Viber Promo -> SMS Fallback

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Viber Survey -> SMS Fallback

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Viber Trans -> SMS Fallback

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

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

ပုံများ

  • JPG သို့မဟုတ် PNG ဖော်မတ်ကို အသုံးပြုပါ။
  • အကြံပြုထားသောအရွယ်အစား- 800x600 ပစ်ဇယ်
  • ဖိုင်အရွယ်အစားကို 1MB အောက်ထားပါ။
  • HTTPS URLs ကိုသုံးပါ။

ဗီဒီယိုများ

  • MP4 format ကိုသုံးပါ။
  • ဖိုင်အရွယ်အစားကို 10MB အောက်ထားပါ။
  • ပုံသေးပုံ ထည့်သွင်းပါ။
  • ကြာချိန်နှင့် ဖိုင်အရွယ်အစားကို သတ်မှတ်ပါ။

ခလုတ်များ

  • ခလုတ်ကို စာလုံးအတိုထားပါ (စကားလုံး 2-3 လုံး)
  • ရှင်းလင်းပြတ်သားသော ခေါ်ဆိုမှု-လုပ်ဆောင်ရန် စကားစုများကို သုံးပါ။
  • HTTPS URL များကို အမြဲသုံးပါ။
  • မပို့မီ URL များကို စမ်းသပ်ပါ။

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

  • ပရိုမိုးရှင်းမက်ဆေ့ခ်ျများ- 24-72 နာရီ
  • ငွေလွှဲစာတိုများ- 24 နာရီ
  • OTP မက်ဆေ့ချ်များ- 5-10 မိနစ်
  • စစ်တမ်းများ 7-30 ရက်

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

  • SMS Messages - SMS တုံ့ပြန်မှုအကြောင်း လေ့လာပါ။
  • RCS Messages - ကြွယ်ဝသော ဆက်သွယ်ရေးဝန်ဆောင်မှုများ
  • Check Status - ပေးပို့မှုအခြေအနေကို ခြေရာခံပါ။