सन्देशका प्रकारहरू

Cascade API ले चार सन्देश प्रकारहरूलाई समर्थन गर्दछ, प्रत्येक फरक प्रयोग केसहरू र च्यानलहरूको लागि अनुकूलित।

सिंहावलोकन

प्रकार	उद्देश्य	च्यानलहरू	अन्तरक्रियात्मक
'लेनदेन'	महत्वपूर्ण सूचनाहरू	सबै	छैन
'प्रोमो'	मार्केटिङ अभियान	सबै	हो (बटन)
`viber_survey`	पोल र प्रतिक्रिया	भाइबर, एसएमएस	हो (विकल्प)
`फ्लैशकल`	फोन प्रमाणिकरण	फोन कल	छैन

लेनदेन सन्देशहरू

अर्डर पुष्टिहरू, खाता अद्यावधिकहरू, र प्रणाली अलर्टहरू जस्ता महत्वपूर्ण सूचनाहरू।

विशेषताहरू

उच्च प्राथमिकता वितरण
कुनै प्रचार सामग्री छैन
प्रत्यक्ष र संक्षिप्त
समय-संवेदनशील
मार्फत रूट गरिएको: टेलिग्राम → Viber → RCS → SMS

केसहरू प्रयोग गर्नुहोस्

अर्डर पुष्टिकरणहरू
भुक्तानी सूचनाहरू
खाता अलर्ट
सुरक्षा सूचनाहरू
डेलिभरी अपडेटहरू
पासवर्ड रिसेटहरू

उदाहरण

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

उत्तम अभ्यासहरू

✅ सम्भव भएसम्म सन्देशहरूलाई १६० वर्णभन्दा कम राख्नुहोस्
✅ सान्दर्भिक लेनदेन विवरणहरू समावेश गर्नुहोस्
✅ ट्र्याकिङ लिङ्कहरू प्रदान गर्नुहोस्
✅ स्पष्ट, व्यावसायिक भाषा प्रयोग गर्नुहोस्
❌ मार्केटिङ सामग्री समावेश नगर्नुहोस्
❌ इमोजी धेरै प्रयोग नगर्नुहोस्

प्रयोग केस द्वारा उदाहरणहरू

अर्डर पुष्टि

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

प्रोमो सन्देशहरू

समृद्ध मिडिया र अन्तरक्रियात्मक तत्वहरूको साथ मार्केटिङ र प्रचार अभियानहरू।

विशेषताहरू

रिच मिडिया समर्थन
अन्तरक्रियात्मक बटनहरू
कल-टु-एक्शन केन्द्रित
लामो TTL स्वीकार्य
मार्फत रूट गरिएको: टेलिग्राम → Viber → RCS → SMS

केसहरू प्रयोग गर्नुहोस्

उत्पादन प्रक्षेपण
बिक्री घोषणाहरू
कार्यक्रम निमन्त्रणा
न्यूजलेटर अभियानहरू
विशेष प्रस्तावहरू
ब्रान्ड जागरूकता

उदाहरण

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

उत्तम अभ्यासहरू

✅ स्पष्ट कल-टु-एक्शन समावेश गर्नुहोस्
✅ आकर्षक भाषा प्रयोग गर्नुहोस्
✅ URL मा ट्र्याकिङ प्यारामिटरहरू थप्नुहोस्
✅ चरहरूसँग निजीकृत गर्नुहोस्
✅ धेरै च्यानलहरूमा परीक्षण गर्नुहोस्
❌ ग्राहकहरूलाई स्प्याम नगर्नुहोस्
❌ भ्रामक सामग्री प्रयोग नगर्नुहोस्
❌ वर्ण सीमा नाघ्नुहोस्

प्रयोग केस द्वारा उदाहरणहरू

उत्पादन लन्च

{
  "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 वर्णहरूमा सीमित
Viber मा अन्तरक्रियात्मक इन्टरफेस
एसएमएसमा फलब्याक (अन्तरक्रिया बिना)
एकल-प्रश्न ढाँचा

केसहरू प्रयोग गर्नुहोस्

ग्राहक सन्तुष्टि सर्वेक्षण
उत्पादन प्रतिक्रिया
सेवा गुणस्तर मूल्याङ्कन
बजार अनुसन्धान
घटना प्रतिक्रिया
नेट प्रमोटर स्कोर (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
}

बाधाहरू

पाठ: अधिकतम ८५ वर्णहरू
विकल्प: २-५ विकल्पहरू
विकल्प लम्बाइ: प्रत्येकमा ३० वर्णभन्दा कम राख्नुहोस्
TTL: सिफारिस गरिएको ७-३० दिन

उत्तम अभ्यासहरू

✅ एउटा स्पष्ट प्रश्न सोध्नुहोस्
✅ सन्तुलित विकल्पहरू प्रदान गर्नुहोस्
✅ सरल भाषा प्रयोग गर्नुहोस्
✅ विकल्पहरू संक्षिप्त राख्नुहोस्
✅ उपयुक्त TTL सेट गर्नुहोस् (७+ दिन)
❌ धेरै प्रश्नहरू नगर्नुहोस्
❌ प्राविधिक शब्दावली प्रयोग नगर्नुहोस्
❌ प्रतिक्रियाहरूमा पक्षपात नगर्नुहोस्

प्रयोग केस द्वारा उदाहरणहरू

ग्राहक सन्तुष्टि (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"
  ]
}

फ्ल्यास कल

SMS कोडहरूको सट्टा स्वचालित कलहरू प्रयोग गरेर फोन प्रमाणीकरण।

विशेषताहरू

लागत प्रभावी प्रमाणीकरण
SMS भन्दा छिटो (१-३ सेकेन्ड)
सूचनाहरूमा कुनै देखिने कोड छैन
सिम स्वैप आक्रमणहरूको प्रतिरोधी
फोन कल मात्र (टेलीग्राम/भाइबर छैन)

केसहरू प्रयोग गर्नुहोस्

प्रयोगकर्ता दर्ता
लगइन प्रमाणिकरण
फोन नम्बर प्रमाणीकरण
दुई-कारक प्रमाणीकरण
खाता रिकभरी
लेनदेन पुष्टिकरण

उदाहरण

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

यसले कसरी काम गर्छ

प्रयोगकर्ताले फोन नम्बर प्रविष्ट गर्दछ
API ले फ्ल्यास कल सुरु गर्छ
1-2 घण्टी पछि कल समाप्त हुन्छ
एपले कलर ID क्याप्चर गर्छ
कलर आईडी ढाँचा विरुद्ध प्रमाणित
प्रयोगकर्ता प्रमाणीकरण

उत्तम अभ्यासहरू

✅ छोटो TTL सेट गर्नुहोस् (६०-३०० सेकेन्ड)
✅ कलर आईडी पत्ता लगाउने कार्य लागू गर्नुहोस्
✅ एसएमएस फलब्याक प्रदान गर्नुहोस्
✅ अनुमति अनुरोधहरू ह्यान्डल गर्नुहोस्
✅ स्पष्ट निर्देशनहरू देखाउनुहोस्
❌ प्रचारात्मक उद्देश्यका लागि प्रयोग नगर्नुहोस्
❌ लामो TTL सेट नगर्नुहोस्

फलब्याकको साथ उदाहरण

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

तुलना म्याट्रिक्स

विशेषता	लेनदेन	प्रोमो	सर्वेक्षण	फ्ल्यास कल
रिच मिडिया	❌	✅	❌	❌
अन्तरक्रियात्मक	❌	✅	✅	❌
निजीकरण	✅	✅	✅	❌
सामान्य 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 - क्यास्केड सन्देशहरू पठाउन सुरु गर्नुहोस्
सन्देश चर - सन्देशहरू निजीकृत गर्नुहोस्
SMSBAT API - SMSBAT सुविधाहरू अन्वेषण गर्नुहोस्