Ziņojumu veidi

Kaskādes API atbalsta četrus ziņojumu veidus, no kuriem katrs ir optimizēts dažādiem lietošanas gadījumiem un kanāliem.

Pārskats

Tips	Mērķis	Kanāli	Interaktīvs
”darījums”	Kritiskie paziņojumi	Visi	Nē
”reklāma”	Mārketinga kampaņas	Visi	Jā (pogas)
viber_survey	Aptaujas un atsauksmes	Viber, SMS	Jā (opcijas)
flashcall	Tālruņa pārbaude	Tālruņa zvans	Nē

Darījumu ziņojumi

Kritiskie paziņojumi, piemēram, pasūtījumu apstiprinājumi, konta atjauninājumi un sistēmas brīdinājumi.

Raksturlielumi

• Augstas prioritātes piegāde
• Nav reklāmas satura
• Tiešs un kodolīgs
• Laika jutīgums
• Maršrutēts caur: Telegram → Viber → RCS → SMS

Lietošanas gadījumi

• Pasūtījumu apstiprinājumi
• Maksājumu paziņojumi
• Konta brīdinājumi
• Drošības paziņojumi
• Piegādes atjauninājumi
• Paroles atiestatīšana

Piemērs

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

Labākā prakse

• ✅ Ja iespējams, saglabājiet ziņojumus, kas ir mazāki par 160 rakstzīmēm
• ✅ Iekļaujiet attiecīgo darījumu informāciju
• ✅ Nodrošiniet izsekošanas saites
• ✅ Izmantojiet skaidru, profesionālu valodu - ❌ Neiekļaujiet mārketinga saturu
• ❌ Nelietojiet emocijzīmes pārmērīgi

Piemēri pēc lietošanas gadījuma

Pasūtījuma apstiprinājums

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

Maksājuma paziņojums

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

Drošības brīdinājums

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

Piegādes atjauninājums

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

Reklāmas ziņojumi

Mārketinga un reklāmas kampaņas ar bagātinātu mediju un interaktīviem elementiem.

Raksturlielumi

• Bagātinātas multivides atbalsts
• Interaktīvās pogas
• Koncentrēts uz aicinājumu uz darbību
• Pieņemams ilgāks TTL
• Maršrutēts caur: Telegram → Viber → RCS → SMS

Lietošanas gadījumi

• Produktu palaišana
• Paziņojumi par pārdošanu
• Pasākumu ielūgumi
• Biļetenu kampaņas
• Īpašie piedāvājumi
• Zīmola atpazīstamība

Piemērs

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

Ar mainīgajiem

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

Labākā prakse

• ✅ Iekļaujiet skaidru aicinājumu uz darbību
• ✅ Izmantojiet saistošu valodu
• ✅ Pievienojiet izsekošanas parametrus URL
• ✅ Personalizējiet ar mainīgajiem
• ✅ Pārbaudi vairākos kanālos
• ❌ Nesūtiet klientiem surogātpastu
• ❌ Neizmantojiet maldinošu saturu
• ❌ Nepārsniedziet rakstzīmju ierobežojumus

Piemēri pēc lietošanas gadījuma

Produkta palaišana

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

Flash izpārdošana

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

Pasākuma ielūgums

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

Pamestie grozi

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

Interaktīvas aptaujas un aptaujas klientu atsauksmju apkopošanai.

Raksturlielumi

• 2-5 atbildes iespējas
• Teksta garums ir ierobežots līdz 85 rakstzīmēm
• Viber interaktīvs interfeiss
• Atkāpšanās uz SMS (bez interaktivitātes)
• Viena jautājuma formāts

Lietošanas gadījumi

• Klientu apmierinātības aptaujas
• Atsauksmes par produktiem
• Pakalpojumu kvalitātes vērtējumi
• Tirgus izpēte
• Atsauksmes par notikumu
• Net Promoter Score (NPS)

Piemērs

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

Ierobežojumi

• Teksts: ne vairāk kā 85 rakstzīmes
• Iespējas: 2-5 izvēles
• Opcijas garums: katrai jābūt mazākai par 30 rakstzīmēm
• TTL: ieteicams 7–30 dienas

Labākā prakse

• ✅ Uzdodiet vienu skaidru jautājumu
• ✅ Nodrošiniet sabalansētas iespējas
• ✅ Izmantojiet vienkāršu valodu
• ✅ Saglabājiet iespējas kodolīgi
• ✅ Iestatiet atbilstošu TTL (7+ dienas)
• ❌ Neuzdodiet vairākus jautājumus
• ❌ Nelietojiet tehnisko žargonu
• ❌ Nenovērojiet atbildes

Piemēri pēc lietošanas gadījuma

Klientu apmierinātība (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"
  ]
}

Produktu atsauksmes

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

Pakalpojuma kvalitāte

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

Atsauksmes par notikumu

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

Flash Call

Tālruņa verifikācija, izmantojot automātiskos zvanus, nevis SMS kodus.

Raksturlielumi

• Izmaksu efektīva pārbaude
• Ātrāk nekā SMS (1-3 sekundes)
• Paziņojumos nav redzama koda
• Izturīgs pret SIM maiņas uzbrukumiem
• Tikai tālruņa zvans (nav Telegram/Viber)

Lietošanas gadījumi

• Lietotāja reģistrācija
• Pieteikšanās pārbaude
• Tālruņa numura apstiprināšana
• Divu faktoru autentifikācija
• Konta atkopšana
• Darījuma apstiprinājums

Piemērs

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

Kā tas darbojas

1. Lietotājs ievada tālruņa numuru 2. API ierosina zibatmiņas zvanu
2. Saruna tiek pārtraukta pēc 1-2 zvaniem 4. Lietotne fiksē zvanītāja ID 5. Zvanītāja ID pārbaudīts saskaņā ar modeli 6. Lietotāja autentifikācija

Labākā prakse

• ✅ Iestatīt īsu TTL (60-300 sekundes)
• ✅ Ieviesiet zvanītāja ID noteikšanu
• ✅ Nodrošiniet SMS rezerves
• ✅ Apstrādājiet atļauju pieprasījumus
• ✅ Rādiet skaidrus norādījumus
• ❌ Neizmantojiet reklāmas nolūkos
• ❌ Neiestatiet garu TTL

Piemērs ar atkāpšanos

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

Pareizā veida izvēle

Lēmumu koks

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)

Salīdzināšanas matrica

Funkcija	Darījums	Promo	Aptauja	Flash Call
Bagātināta multivide	❌	✅	❌	❌
Interaktīvs	❌	✅	✅	❌
Personalizēšana	✅	✅	✅	❌
Tipisks TTL	Stundas	Dienas	Nedēļa	Minūtes
Izmaksas	Vidēja	Vidēja	Vidēja	Zems
Piegādes ātrums	Ātri	Ātri	Ātri	Ātrākais

Īstenošanas piemērs

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

Nākamie soļi

• Sūtīt ziņojumus - Sāciet sūtīt kaskādes ziņojumus
• Ziņojumu mainīgie - Personalizējiet ziņojumus
• SMSBAT API - Izpētiet SMSBAT funkcijas