Հաղորդագրությունների տեսակները

Cascade API-ն աջակցում է հաղորդագրությունների չորս տեսակի, որոնցից յուրաքանչյուրը օպտիմիզացված է տարբեր օգտագործման դեպքերի և ալիքների համար:

Տեսություն

Տեսակ	Նպատակը	Ալիքներ	Ինտերակտիվ
«գործարք»	Կրիտիկական ծանուցումներ	Բոլոր	Ոչ
«պրոմո»	Մարքեթինգային արշավներ	Բոլոր	Այո (կոճակներ)
«viber_survey»	Հարցումներ և արձագանքներ	Viber, SMS	Այո (տարբերակներ)
«flashcall»	Հեռախոսի ստուգում	Հեռախոսազանգ	Ոչ

Գործարքի հաղորդագրություններ

Կարևոր ծանուցումներ, ինչպիսիք են պատվերի հաստատումները, հաշվի թարմացումները և համակարգի ծանուցումները:

Բնութագիր

• Բարձր առաջնահերթ առաքում
• Ոչ մի գովազդային բովանդակություն
• Ուղղակի և հակիրճ
• Ժամանակի նկատմամբ զգայուն
• Երթուղղված՝ Telegram → 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
}

Լավագույն պրակտիկա

• ✅ Հնարավորության դեպքում հաղորդագրությունները պահեք 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"
}

Պրոմո հաղորդագրություններ

Մարքեթինգային և գովազդային արշավներ հարուստ մեդիա և ինտերակտիվ տարրերով:

Բնութագիր

• Հարուստ լրատվամիջոցների աջակցություն
• Ինտերակտիվ կոճակներ
• Գործողության կոչը կենտրոնացած է
• Ավելի երկար TTL ընդունելի է
• Երթուղղված՝ Telegram → 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%"
}

Viber Հարցում

Ինտերակտիվ հարցումներ և հարցումներ հաճախորդների հետադարձ կապի հավաքագրման համար:

Բնութագիր

• 2-5 արձագանքման տարբերակներ
• Տեքստը սահմանափակվում է 85 նիշով
• Ինտերակտիվ ինտերֆեյս Viber-ում
• Հետադարձ SMS (առանց ինտերակտիվության)
• Մեկ հարցի ձևաչափ

Օգտագործման դեպքեր

• Հաճախորդների բավարարվածության հարցումներ
• Ապրանքի հետադարձ կապ
• Ծառայությունների որակի վարկանիշներ
• Շուկայի հետազոտություն
• Իրադարձությունների հետադարձ կապ
• Զուտ խթանողի միավոր (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+ օր)
• ❌ Բազմաթիվ հարցեր մի տվեք
• ❌ Մի օգտագործեք տեխնիկական ժարգոն
• ❌ Մի կողմնակալ պատասխաններ

Օրինակներ ըստ օգտագործման դեպքի

Հաճախորդների բավարարվածություն (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-ից ավելի արագ (1-3 վայրկյան)
• Ծանուցումների մեջ տեսանելի կոդ չկա
• Դիմացկուն է SIM փոխանակման հարձակումներին
• Միայն հեռախոսազանգ (առանց Telegram/Viber)

Օգտագործման դեպքեր

• Օգտագործողի գրանցում
• Մուտքի ստուգում
• Հեռախոսահամարի վավերացում
• Երկու գործոնով նույնականացում
• Հաշվի վերականգնում
• Գործարքի հաստատում

Օրինակ

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

Ինչպես է այն աշխատում

1. Օգտագործողը մուտքագրում է հեռախոսահամարը
2. API-ն սկսում է ֆլեշ զանգ
3. Զանգն ավարտվում է 1-2 զանգից հետո
4. Հավելվածը գրավում է զանգահարողի ID-ն
5. Զանգահարողի ID-ն ստուգված է օրինակով
6. Օգտատիրոջ իսկությունը հաստատված է

Լավագույն պրակտիկա

• ✅ Սահմանել կարճ TTL (60-300 վայրկյան)
• ✅ Իրականացնել զանգահարողի նույնականացման հայտնաբերում
• ✅ Տրամադրել հետադարձ 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)

Համեմատության մատրիցա

Առանձնահատկություն	Գործարքի	Պրոմո	Հարցում	Ֆլեշ զանգ
Rich Media	❌	✅	❌	❌
Ինտերակտիվ	❌	✅	✅	❌
Անհատականացում	✅	✅	✅	❌
Տիպիկ 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 - Սկսեք ուղարկել կասկադային հաղորդագրություններ
• Message Variables - Անհատականացրեք հաղորդագրությունները
• SMSBAT API - Ուսումնասիրեք SMSBAT-ի առանձնահատկությունները