މެސެޖް ޓައިޕްސް

ކެސްކޭޑް އެޕީއައި އިން ހަތަރު މެސެޖް ވައްތަރަކަށް ސަޕޯޓް ކުރާއިރު، ކޮންމެ މެސެޖެއް ވެސް ތަފާތު ޔޫސް ކޭސްތަކާއި ޗެނަލްތަކަށް އޮޕްޓިމައިޒްކޮށްފައިވެ އެވެ.

އޯވަރވިއު

ވައްތަރު	މަޤްޞަދު	ޗެނަލްތަކުން	އިންޓަރެކްޓިވް
މުޢާމަލާތް	ކްރިޓިކަލް ނޮޓިފިކޭޝަންތައް	ހުރިހާ	ނޫން
ޕްރޮމޯ	މާކެޓިންގ ކެމްޕޭންތައް	ހުރިހާ	އާދެ (ބަޓަންތައް)
ވައިބަރ_ސަރވޭ	ޕޯލްސް އާއި ފީޑްބެކް	ވައިބަރ، އެސްއެމްއެސް	އާދެ (އޮޕްޝަންސް)
ފްލެޝްކޯލް	ފޯނުން ޔަގީންކުރުން	ފޯނު ކޯލް	ނޫން

މުއާމަލާތުގެ މެސެޖުތައް

އޯޑަރ ކޮންފަރމްސް، އެކައުންޓް އަޕްޑޭޓްސް، އަދި ސިސްޓަމް އެލާޓްސް ފަދަ ކްރިޓިކަލް ނޮޓިފިކޭޝަންސް.

ސިފަތައް

• ހައި ޕްރިއޮރިޓީ ޑެލިވަރީ
• ޕްރޮމޯޝަނަލް ކޮންޓެންޓެއް ނެތް
• ސީދާ އަދި ޚުލާޞާ
• ވަގުތަށް ނާޒުކު
• ރޫޓް ކުރެވޭނީ: ޓެލެގްރާމް → ވައިބަރ → އާރްސީއެސް → އެސްއެމްއެސް މެދުވެރިކޮށެވެ

ޔޫސް ކޭސްސް

• އޯޑަރ ކޮންފަރމްސް ކުރުން
• ފައިސާ ދެއްކުމުގެ ނޮޓިފިކޭޝަން
• އެކައުންޓް އެލާޓް ދިނުން
• ސެކިއުރިޓީ ނޮޓިފިކޭޝަންތައް
• ޑެލިވަރީ އަޕްޑޭޓްސް
• ޕާސްވޯޑް ރީސެޓްކުރުން

މިސާލު

{
  "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
}

އެންމެ ރަނގަޅު އުސޫލުތައް

• ✅ މެސެޖުތައް ވީހާވެސް ގިނައިން 160 އަކުރުގެ ދަށުގައި ބެހެއްޓުން
• ✅ މުއާމަލާތުގެ ކަމާބެހޭ ތަފްސީލް ހިމަނާށެވެ
• ✅ ޓްރެކިންގ ލިންކްތައް ފޯރުކޮށްދިނުން
• ✅ ސާފު، ޕްރޮފެޝަނަލް ބަސް ބޭނުންކުރުން
• ❌ މާކެޓިންގ ކޮންޓެންޓް ނުހިމަނާށެވެ
• ❌ އިމޯޖީ މާބޮޑަށް ބޭނުން ނުކުރުން

މިސާލުތައް ޔޫސް ކޭސް އަށް ބަލާފައި

އޯޑަރ ކޮންފަރމް ކުރުން

{
  "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."
}

ޑެލިވަރީ އަޕްޑޭޓް

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

ޕްރޮމޯ މެސެޖްތައް

ރިޗް މީޑިއާ އާއި އިންޓަރެކްޓިވް އެލިމެންޓްތަކާއެކު މާކެޓިންގ އަދި ޕްރޮމޯޝަނަލް ކެމްޕޭންތައް ކުރިއަށް ގެންދިއުމެވެ.

ސިފަތައް

• މުއްސަނދި މީޑިއާ ސަޕޯޓް
• އިންޓަރެކްޓިވް ބަޓަންސް
• ކޯލް ޓު އެކްޝަން ފޯކަސް ކުރެވިފައި
• ދިގު ޓީޓީއެލް ބަލައިގަނެވޭނެއެވެ
• ރޫޓް ކުރެވޭނީ: ޓެލެގްރާމް → ވައިބަރ → އާރްސީއެސް → އެސްއެމްއެސް މެދުވެރިކޮށެވެ

ޔޫސް ކޭސްސް

• ޕްރޮޑަކްޓް ލޯންޗްކުރުން
• ވިއްކުމުގެ އިޢުލާންތައް
• އިވެންޓުގެ ދައުވަތު
• ނިއުސްލެޓަރ ކެމްޕޭންތައް
• ޚާއްޞަ އޮފާތައް
• ބްރޭންޑް ހޭލުންތެރިކުރުން

މިސާލު

{
  "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
}

ވެރިއޭބަލްސް އާއި އެކު

{
  "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"}
  ]
}

އެންމެ ރަނގަޅު އުސޫލުތައް

• ✅ ސާފު ކޯލް ޓު އެކްޝަން ހިމަނާށެވެ
• ✅ ޝައުގުވެރިވާ ބަސް ބޭނުންކުރުން
• ✅ ޔޫއާރްއެލްތަކަށް ޓްރެކިންގ ޕެރެމިޓަރސް އިތުރުކުރުން
• ✅ ވެރިއޭބަލްތަކާއެކު ޕާސަނަލައިޒް ކުރުން
• ✅ އެތައް ޗެނަލްތަކެއްގައި ޓެސްޓްކުރުން
• ❌ ކަސްޓަމަރުންނަށް ސްޕޭމް ނުކުރުން
• ❌ އޮޅުވާލާ ކޮންޓެންޓް ބޭނުން ނުކުރުން
• ❌ އަކުރުތަކުގެ ޙައްދުތަކަށްވުރެ އިތުރު ނުކުރުން

މިސާލުތައް ޔޫސް ކޭސް އަށް ބަލާފައި

ޕްރޮޑަކްޓް ލޯންޗްކުރުން

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

ފްލެޝް ސޭލް

{
  "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%"
}

ވައިބަރ ސާރވޭ

ކަސްޓަމަރުންގެ ފީޑްބެކް އެއްކުރުމަށް އިންޓަރެކްޓިވް ޕޯލްތަކާއި ސާވޭތައް ހެދުން.

ސިފަތައް

• 2-5 ރެސްޕޮންސް އޮޕްޝަންސް
• ޓެކްސްޓް ލިމިޓް ކުރެވިފައިވަނީ 85 އަކުރަށް
• ވައިބަރ ގައި އިންޓަރެކްޓިވް އިންޓަރފޭސް
• އެސްއެމްއެސް އަށް ފޯލްބެކް (އިންޓަރެކްޓިވިޓީ ނެތި)
• އެއް ސުވާލުގެ ފޯމެޓް

ޔޫސް ކޭސްސް

• ކަސްޓަމަރުންގެ ހިތްހަމަޖެހުމުގެ ސާވޭތައް
• ޕްރޮޑަކްޓް ފީޑްބެކް
• ޚިދުމަތުގެ ފެންވަރު ރޭޓިންގ
• މާކެޓް ރިސާޗް
• އިވެންޓް ފީޑްބެކް
• ނެޓް ޕްރޮމޯޓަރ ސްކޯރ (އެންޕީއެސް)

މިސާލު

{
  "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 އަކުރުގެ ދަށުގައި ބެހެއްޓުން
• ޓީޓީއެލް: 7-30 ދުވަހުގެ މުއްދަތަށް ލަފާދެއެވެ

އެންމެ ރަނގަޅު އުސޫލުތައް

• ✅ ސާފު އެއް ސުވާލެއް ކުރާށެވެ
• ✅ ބެލެންސްޑް އޮޕްޝަންސް ފޯރުކޮށްދިނުން
• ✅ ސާދާ ބަސް ބޭނުންކުރުން
• ✅ އިޚްތިޔާރުތައް ޚުލާޞާކޮށް ބެހެއްޓުން
• ✅ އެކަށީގެންވާ ޓީޓީއެލް ސެޓްކުރުން (7+ ދުވަސް)
• ❌ އެތައް ސުވާލެއް ނުކުރުން
• ❌ ޓެކްނިކަލް ޖާގަން ބޭނުން ނުކުރުން
• ❌ ޖަވާބުތައް ބަޔާސް ނުކުރުން

މިސާލުތައް ޔޫސް ކޭސް އަށް ބަލާފައި

ކަސްޓަމަރުންގެ ހިތްހަމަޖެހުން (އެންޕީއެސް)

{
  "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"
  ]
}

ފްލެޝް ކޯލް

އެސްއެމްއެސް ކޯޑްގެ ބަދަލުގައި އޮޓޮމެޓިކް ކޯލް ބޭނުންކޮށްގެން ފޯނު ވެރިފިކޭޝަން.

ސިފަތައް

• ޚަރަދު ކުޑަ ވެރިފިކޭޝަން
• އެސްއެމްއެސް އަށް ވުރެ އަވަސް (1-3 ސިކުންތު)
• ނޮޓިފިކޭޝަންތަކުގައި ފެންނަ ކޯޑެއް ނެތެވެ
• ސިމް ސްވޮޕް އެޓޭކްތަކަށް ދިފާޢުވުން
• ހަމައެކަނި ފޯނުކޯލް (ޓެލެގްރާމް/ވައިބަރ ނެތް)

ޔޫސް ކޭސްސް

• ޔޫޒަރ ރެޖިސްޓްރޭޝަން
• ލޮގިން ވެރިފިކޭޝަން
• ފޯނު ނަންބަރު ސައްހަކުރުން
• ޓޫ ފެކްޓަރ އޮތެންޓިކޭޝަން
• އެކައުންޓް ރިކަވަރީ
• މުއާމަލާތް ކަށަވަރުކުރުން

މިސާލު

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

އެކަން ކުރާ ގޮތް

1. ޔޫޒަރ ފޯނު ނަންބަރު ޖައްސައެވެ
2. އެޕީއައި އިން ފްލެޝް ކޯލް އިނިޝިއޭޓް ކުރެއެވެ
3. ކޯލް ނިމޭނީ 1-2 ރިންގް ޖެހުމުންނެވެ
4. އެޕް އިން ކޯލަރ އައިޑީ ކެޕްޗާރ ކުރެއެވެ
5. ކޯލަރ އައިޑީ ޕެޓަރން އާއި އެއްގޮތަށް ވެރިފައިޑް ކުރެވިފައިވުން
6. ޔޫޒަރ އޮތެންޓިކޭޓް ކުރެވިފައިވުން

އެންމެ ރަނގަޅު އުސޫލުތައް

• ✅ ކުރު ޓީޓީއެލް ސެޓްކުރުން (60-300 ސިކުންތު)
• ✅ ކޯލަރ އައިޑީ ޑިޓެކްޝަން ތަންފީޒުކުރުން
• ✅ އެސްއެމްއެސް ފޯލްބެކް ފޯރުކޮށްދިނުން
• ✅ ހުއްދައަށް އެދޭ ކަންތައްތައް ބެލެހެއްޓުން
• ✅ ސާފު އިރުޝާދުތައް ދައްކާށެވެ
• ❌ ޕްރޮމޯޝަނަލް ބޭނުމުގައި ބޭނުން ނުކުރުން
• ❌ ދިގު ޓީޓީއެލް ސެޓް ނުކުރުން

ފޯލްބެކް އާއި އެކު މިސާލު

{
  "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)

އަޅާކިޔުމުގެ މެޓްރިކްސް

ފީޗާ	މުއާމަލާތް	ޕްރޮމޯ	ސާރވޭ	ފްލެޝް ކޯލް
ރިޗް މީޑިއާ	❌	✅	❌	❌
އިންޓަރެކްޓިވް	❌	✅	✅	❌
ޕާސަނަލައިޒޭޝަން	✅	✅	✅	❌
ޓިޕިކަލް ޓީޓީއެލް	ގަޑި	ދުވަސް	ހަފްތާ	މިނެޓް
ހަރަދު	މީޑިއަމް	މީޑިއަމް	މީޑިއަމް	ދަށް
ޑެލިވަރީ ސްޕީޑް	އަވަހަށް	އަވަހަށް	އަވަހަށް	އެންމެ އަވަސް

ތަންފީޒުކުރުމުގެ މިސާލު

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'
);

ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް

• މެސެޖްތައް ފޮނުވުން - ކެސްކޭޑް މެސެޖުތައް ފޮނުވަން ފެށުން
• މެސެޖް ވެރިއޭބަލްސް - މެސެޖުތައް ޕާސަނަލައިޒް ކުރުން
• SMSBAT API - އެސްއެމްއެސްބީއޭޓީގެ ފީޗާސްތައް ތަހުގީގުކުރުން