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

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

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 सुविधाहरू अन्वेषण गर्नुहोस्

Search Results

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

सिंहावलोकन

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

विशेषताहरू

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

उदाहरण

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

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

अर्डर पुष्टि

भुक्तानी सूचना

सुरक्षा सतर्कता

डेलिभरी अपडेट

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

विशेषताहरू

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

उदाहरण

चरहरू सहित

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

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

उत्पादन लन्च

फ्ल्यास बिक्री

कार्यक्रम निमन्त्रणा

परित्याग गरिएको कार्ट

भाइबर सर्वेक्षण

विशेषताहरू

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

उदाहरण

बाधाहरू

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

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

ग्राहक सन्तुष्टि (NPS)

उत्पादन प्रतिक्रिया

सेवा गुणस्तर

घटना प्रतिक्रिया

फ्ल्यास कल

विशेषताहरू

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

उदाहरण

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

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

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

सही प्रकार छनोट गर्दै

निर्णय रूख

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

कार्यान्वयन उदाहरण

अर्को चरणहरू