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

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

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

ရိုက်	ရည်ရွယ်ချက်	ချန်နယ်များ	အပြန်အလှန်အကျိုးပြု
အရောင်းအဝယ်	အရေးကြီးသော အသိပေးချက်များ	အားလုံး	မရှိ
ပရိုမိုရှင်း	စျေးကွက်လှုပ်ရှားမှုများ	အားလုံး	ဟုတ်ကဲ့ (ခလုပ်)
viber_survey	စစ်တမ်းများနှင့် တုံ့ပြန်ချက်	Viber, SMS	ဟုတ်ကဲ့ (ရွေးချယ်စရာများ)
flashcall	ဖုန်းအတည်ပြုချက်	ဖုန်းခေါ်ဆိုမှု	မရှိ

ငွေလွှဲစာတိုများ

မှာယူမှုအတည်ပြုချက်များ၊ အကောင့်အပ်ဒိတ်များနှင့် စနစ်သတိပေးချက်များကဲ့သို့သော အရေးကြီးသော သတိပေးချက်များ။

လက္ခဏာများ

• ဦးစားပေးပို့ဆောင်ခြင်း။
• ပရိုမိုးရှင်းအကြောင်းအရာမရှိပါ။
• တိုတိုနှင့်တိုက်ရိုက်
• အချိန်-အထိခိုက်မခံ
• Telegram → Viber → RCS → SMS

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

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

ဥပမာ

{
  "id": "tx-order-12345",
  "fromName": "YourStore",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "transaction",
  "text": "Order #12345 confirmed. Total: $99.99. Delivery: Jan 25. Track: https://example.com/track/12345",
  "ttl": 86400
}

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

• ✅ ဖြစ်နိုင်လျှင် စာလုံးရေ ၁၆၀ အောက် မက်ဆေ့ချ်များကို သိမ်းဆည်းပါ။
• ✅ သက်ဆိုင်ရာ အရောင်းအ၀ယ်အသေးစိတ်ကို ထည့်သွင်းပါ။
• ✅ ခြေရာခံလင့်ခ်များကို ပေးဆောင်ပါ။
• ✅ ရှင်းလင်းပြတ်သားသော၊ ပရော်ဖက်ရှင်နယ်ဘာသာစကားကို အသုံးပြုပါ။
• ❌ မားကတ်တင်းအကြောင်းအရာ မပါဝင်ပါနှင့်
• ❌ အီမိုဂျီများကို အလွန်အကျွံမသုံးပါနှင့်

Use Case ဖြင့် နမူနာများ

အော်ဒါအတည်ပြုခြင်း။

{
  "messageType": "transaction",
  "text": "Order #12345 confirmed. Total: $99.99. Expected delivery: Jan 25."
}

ငွေပေးချေမှု အသိပေးချက်

{
  "messageType": "transaction",
  "text": "Payment of $150.00 to Merchant ABC successful. Transaction ID: TXN789. Balance: $850.00"
}

လုံခြုံရေးသတိပေးချက်

{
  "messageType": "transaction",
  "text": "New login detected from iPhone at 10:30 AM. Location: New York. If this wasn't you, secure your account immediately."
}

Delivery Update

{
  "messageType": "transaction",
  "text": "Your package is out for delivery! Expected arrival: 2-4 PM. Track: https://track.example.com/PKG123"
}

ပရိုမိုးရှင်းမက်ဆေ့ခ်ျ

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

လက္ခဏာများ

• ကြွယ်ဝသောမီဒီယာပံ့ပိုးမှု
• အပြန်အလှန်အကျိုးသက်ရောက်မှုခလုတ်များ
• လုပ်ဆောင်ရန် အာရုံစိုက်ပါ။
• ပိုရှည်သော TTL ကိုလက်ခံနိုင်သည်။
• Telegram → Viber → RCS → SMS

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

• ထုတ်ကုန်မိတ်ဆက်ပွဲ
• အရောင်းကြေငြာချက်များ
• ပွဲဖိတ်စာများ
• သတင်းလွှာလှုပ်ရှားမှုများ
• အထူးကမ်းလှမ်းချက်များ
• အမှတ်တံဆိပ်အသိအမြင်

ဥပမာ

{
  "id": "promo-summer-sale",
  "fromName": "YourBrand",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "promo",
  "text": "🌟 Summer Sale! Up to 50% off on selected items. Shop now: https://example.com/sale",
  "ttl": 259200
}

Variable များဖြင့်

{
  "messageType": "promo",
  "text": "Hi %name=1%! Exclusive offer: Use code %name=2% for 20% off. Shop: %short_url=1%",
  "variables": [
    {"id": 1, "type": "name", "value": "John"},
    {"id": 2, "type": "name", "value": "VIP20"},
    {"id": 1, "type": "short_url", "value": "https://store.com/sale?utm=sms"}
  ]
}

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

• ✅ ရှင်းလင်းသော ခေါ်ဆိုမှု-လုပ်ဆောင်ရန် ပါဝင်သည်။
• ✅ ဆွဲဆောင်မှုရှိသောဘာသာစကားကို အသုံးပြုပါ။
• ✅ URLs များသို့ ခြေရာခံ ဘောင်များကို ထည့်ပါ။
• ✅ variable များဖြင့် စိတ်ကြိုက်လုပ်ပါ။
• ✅ ချန်နယ်များစွာတွင် စမ်းသပ်ပါ။
• ❌ ဖောက်သည်များကို spam မပြုပါနှင့်
• ❌ အထင်မှားစေသော အကြောင်းအရာများကို မသုံးပါနှင့်
• ❌ စာလုံးကန့်သတ်ချက်ထက် မကျော်လွန်စေရပါ။

Use Case ဖြင့် နမူနာများ

ကုန်ပစ္စည်းမိတ်ဆက်ပွဲ

{
  "messageType": "promo",
  "text": "🎉 NEW ARRIVAL: iPhone 15 Pro now available! Pre-order today and get free shipping. Visit: https://store.com/iphone15"
}

Flash Sale

{
  "messageType": "promo",
  "text": "⚡ FLASH SALE: 2 hours only! Extra 30% off everything. Use code: FLASH30. Shop now: https://store.com/flash"
}

ပွဲဖိတ်စာ

{
  "messageType": "promo",
  "text": "You're invited! VIP Shopping Event on Jan 25 at 6 PM. Exclusive deals + refreshments. RSVP: https://events.com/vip"
}

လှည်းသမား

{
  "messageType": "promo",
  "text": "Hi %name=1%! You left items in your cart. Complete purchase now and get 10% off with code CART10: %short_url=1%"
}

Viber Survey

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

လက္ခဏာများ

• တုံ့ပြန်မှုရွေးချယ်စရာ 2-5 ခု
• စာလုံး 85 လုံးသာကန့်သတ်ထားသည်။
• Viber တွင်အပြန်အလှန်အကျိုးသက်ရောက်မှုရှိသည်။
• SMS သို့ ပြန်သွားရန် (အပြန်အလှန်တုံ့ပြန်မှုမရှိဘဲ)
• တစ်ခုတည်းမေးခွန်းပုံစံ

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

• ဖောက်သည်ကျေနပ်မှုစစ်တမ်းများ
• ထုတ်ကုန်တုံ့ပြန်ချက်
• ဝန်ဆောင်မှုအရည်အသွေးအဆင့်သတ်မှတ်ချက်များ
• စျေးကွက်သုတေသန
• ဖြစ်ရပ်တုံ့ပြန်ချက်
• အသားတင်မြှင့်တင်သူရမှတ် (NPS)

ဥပမာ

{
  "id": "survey-satisfaction-001",
  "fromName": "YourBrand",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "viber_survey",
  "text": "How satisfied are you with our service?",
  "surveyOptions": [
    "Very Satisfied",
    "Satisfied",
    "Neutral",
    "Dissatisfied",
    "Very Dissatisfied"
  ],
  "ttl": 604800
}

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

• ** စာသား ** - အများဆုံး 85 လုံး
• ရွေးချယ်စရာများ- ရွေးချယ်မှု 2-5 ခု
• ရွေးချယ်ခွင့်အရှည်- တစ်ခုစီတွင် စာလုံး 30 အောက်ထားပါ။
• TTL- အကြံပြုထားသည် 7-30 ရက်

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

✅ ရှင်းရှင်းလင်းလင်း မေးခွန်းတစ်ခုမေးပါ။

• ✅ မျှတသောရွေးချယ်မှုများကို ပေးဆောင်ပါ။
• ✅ရိုးရှင်းသောဘာသာစကားကိုအသုံးပြုပါ။
• ✅ ရွေးချယ်စရာများကို တိုတိုတုတ်တုတ်ထားပါ။
• ✅ သင့်လျော်သော TTL (7+ ရက်) သတ်မှတ်ပါ
• ❌ မေးခွန်းပေါင်းများစွာ မမေးပါနဲ့။
• ❌ နည်းပညာဆိုင်ရာ ဗန်းစကား မသုံးပါနဲ့။
• ❌ တုံ့ပြန်မှုများကို ဘက်မလိုက်ပါနဲ့။

Use Case ဖြင့် နမူနာများ

ဖောက်သည်ကျေနပ်မှု (NPS)

{
  "messageType": "viber_survey",
  "text": "How likely are you to recommend us to a friend?",
  "surveyOptions": [
    "0 - Not at all",
    "1-6 - Unlikely",
    "7-8 - Likely",
    "9-10 - Very Likely"
  ]
}

ကုန်ပစ္စည်း တုံ့ပြန်ချက်

{
  "messageType": "viber_survey",
  "text": "How do you rate our new product?",
  "surveyOptions": [
    "⭐️ Excellent",
    "⭐️ Good",
    "⭐️ Average",
    "⭐️ Poor",
    "⭐️ Very Poor"
  ]
}

ဝန်ဆောင်မှု အရည်အသွေး

{
  "messageType": "viber_survey",
  "text": "Was your support experience helpful?",
  "surveyOptions": [
    "Yes, very helpful",
    "Somewhat helpful",
    "Not helpful"
  ]
}

ပွဲ တုန့်ပြန်ချက်

{
  "messageType": "viber_survey",
  "text": "Would you attend our events again?",
  "surveyOptions": [
    "Definitely yes",
    "Probably yes",
    "Not sure",
    "Probably not",
    "Definitely not"
  ]
}

Flash Call

SMS ကုဒ်များအစား အလိုအလျောက်ခေါ်ဆိုမှုများကို အသုံးပြု၍ ဖုန်းအတည်ပြုခြင်း။

လက္ခဏာများ

• ကုန်ကျစရိတ်သက်သာသော စစ်ဆေးမှု
• SMS ထက် ပိုမြန်သည် (1-3 စက္ကန့်)
• အသိပေးချက်များတွင်မြင်ရသောကုဒ်မရှိပါ။
• SIM လဲလှယ်တိုက်ခိုက်မှုများကိုခံနိုင်ရည်ရှိသည်။
• ဖုန်းခေါ်ဆိုမှုသာ (Telegram/Viber မပါ)

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

• အသုံးပြုသူမှတ်ပုံတင်ခြင်း။
• ဝင်ရောက်စစ်ဆေးခြင်း
• ဖုန်းနံပါတ်အတည်ပြုခြင်း။
• two-factor authentication
• အကောင့်ပြန်လည်ရယူခြင်း။
• ငွေသွင်းငွေထုတ်အတည်ပြုချက်

ဥပမာ

{
  "id": "verify-user-12345",
  "fromName": "YourApp",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "flashcall",
  "ttl": 300
}

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

1. အသုံးပြုသူသည် ဖုန်းနံပါတ်ကို ထည့်သွင်းပါ။
2. API သည် flash call ကို စတင်သည်။
3. 1-2 မြည်ပြီးနောက်ခေါ်ဆိုမှုရပ်ဆိုင်းသည်။
4. အက်ပ်သည် ခေါ်ဆိုသူ ID ကို ဖမ်းယူသည်။
5. ခေါ်ဆိုသူ ID ကို ပုံစံနှင့် ဆန့်ကျင်ပြီး အတည်ပြုထားသည်။
6. အသုံးပြုသူ စစ်မှန်ကြောင်း အတည်ပြုထားသည်။

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

• ✅ TTL အတိုသတ်မှတ်ပါ (60-300 စက္ကန့်)
• ✅ ခေါ်ဆိုသူ ID ထောက်လှမ်းမှုကို အကောင်အထည်ဖော်ပါ။
• ✅ SMS ပေးပို့ရန်
• ✅ခွင့်ပြုချက်တောင်းဆိုမှုများကိုကိုင်တွယ်ပါ။
• ✅ ရှင်းလင်းသော ညွှန်ကြားချက်များကို ပြသပါ။
• ❌ ပရိုမိုးရှင်းအတွက် အသုံးမပြုပါနှင့်
• ❌ TTL ကို အကြာကြီးမထားပါနဲ့။

Fallback နှင့်အတူ ### ဥပမာ

{
  "id": "verify-001",
  "fromName": "YourApp",
  "toPhone": "+380XXXXXXXXX",
  "messageType": "flashcall",
  "ttl": 300,
  "fallback": {
    "messageType": "transaction",
    "text": "Your verification code: 123456"
  }
}

##မှန်ကန်သောအမျိုးအစားကိုရွေးချယ်ခြင်း။

ဆုံးဖြတ်ချက်သစ်ပင်

Is it time-critical or transactional?
├─ Yes → transaction
└─ No
   └─ Is it promotional?
      ├─ Yes → promo
      └─ No
         └─ Is it a survey?
            ├─ Yes → viber_survey
            └─ No → Is it for verification?
               ├─ Yes → flashcall
               └─ No → transaction (default)

နှိုင်းယှဉ်မက်ထရစ်

ထူးခြားချက်	ငွေလွှဲ	ပရိုမိုးရှင်း	မြေတိုင်း	Flash Call
ကြွယ်ဝသောမီဒီယာ	❌	✅	❌	❌
အပြန်အလှန်အကျိုးပြု	❌	✅	✅	❌
စိတ်ကြိုက်လုပ်ခြင်း	✅	✅	✅	❌
ရိုးရိုး TTL	နာရီ	နေ့ရက်များ	ရက်သတ္တပတ်	မိနစ်
ကုန်ကျစရိတ်	လတ်	လတ်	လတ်	နိမ့်
ပေးပို့မှုမြန်နှုန်း	မြန်	မြန်	မြန်	အမြန်ဆုံး

အကောင်အထည်ဖော်မှု ဥပမာ

class CascadeMessageBuilder {
  constructor(apiKey) {
    this.apiKey = apiKey;
  }

  buildTransaction(id, fromName, toPhone, text, ttl = 86400) {
    return {
      id,
      fromName,
      toPhone,
      messageType: 'transaction',
      text,
      ttl
    };
  }

  buildPromo(id, fromName, toPhone, text, ttl = 259200) {
    return {
      id,
      fromName,
      toPhone,
      messageType: 'promo',
      text,
      ttl
    };
  }

  buildSurvey(id, fromName, toPhone, text, options, ttl = 604800) {
    if (text.length > 85) {
      throw new Error('Survey text must be under 85 characters');
    }

    if (options.length < 2 || options.length > 5) {
      throw new Error('Survey must have 2-5 options');
    }

    return {
      id,
      fromName,
      toPhone,
      messageType: 'viber_survey',
      text,
      surveyOptions: options,
      ttl
    };
  }

  buildFlashCall(id, fromName, toPhone, ttl = 300) {
    return {
      id,
      fromName,
      toPhone,
      messageType: 'flashcall',
      ttl
    };
  }

  async send(message) {
    // Implementation to send message
  }
}

// Usage
const builder = new CascadeMessageBuilder('your-api-key');

// Transaction
const transaction = builder.buildTransaction(
  'order-123',
  'Store',
  '+380XXXXXXXXX',
  'Order confirmed'
);

// Promo
const promo = builder.buildPromo(
  'promo-001',
  'Brand',
  '+380XXXXXXXXX',
  'Sale now on!'
);

// Survey
const survey = builder.buildSurvey(
  'survey-001',
  'Brand',
  '+380XXXXXXXXX',
  'Rate our service?',
  ['Excellent', 'Good', 'Average', 'Poor']
);

// Flash Call
const flashCall = builder.buildFlashCall(
  'verify-001',
  'App',
  '+380XXXXXXXXX'
);

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

• Send Messages - Cascade မက်ဆေ့ခ်ျများ စတင်ပေးပို့ပါ။
• Message Variables - မက်ဆေ့ချ်များကို စိတ်ကြိုက်ပြင်ဆင်ပါ။
• SMSBAT API - SMSBAT ဝန်ဆောင်မှုများကို စူးစမ်းပါ။