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

Lietotājs ievada tālruņa numuru 2. API ierosina zibatmiņas zvanu
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