შეტყობინების ტიპები

Cascade API მხარს უჭერს შეტყობინებების ოთხ ტიპს, თითოეული ოპტიმიზირებულია სხვადასხვა გამოყენების შემთხვევებისა და არხებისთვის.

მიმოხილვა

ტიპი	დანიშნულება	არხები	ინტერაქტიული
ტრანზაქცია	კრიტიკული შეტყობინებები	ყველა	არა
პრომო	მარკეტინგული კამპანიები	ყველა	დიახ (ღილაკები)
viber_გამოკითხვა	გამოკითხვები და გამოხმაურება	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 სიმბოლოზე ნაკლები
• ✅ ჩართეთ შესაბამისი ტრანზაქციის დეტალები
• ✅ მიაწოდეთ თვალთვალის ბმულები
• ✅ გამოიყენეთ მკაფიო, პროფესიონალური ენა
• ❌ არ შეიტანოთ მარკეტინგული შინაარსი
• ❌ არ გამოიყენოთ emojis ზედმეტად

მაგალითები გამოყენების შემთხვევაში

შეკვეთის დადასტურება

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

Flash ფასდაკლება

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

ინტერაქტიული გამოკითხვები და გამოკითხვები მომხმარებელთა გამოხმაურების შესაგროვებლად.

მახასიათებლები

• 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 წამი)
• ✅ განახორციელეთ აბონენტის ID გამოვლენა
• ✅ მოგვაწოდეთ 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)

შედარებითი მატრიცა

თვისება	გარიგება	პრომო	გამოკითხვა	ფლეშ ზარი
მდიდარი მედია	❌	✅	❌	❌
ინტერაქტიული	❌	✅	✅	❌
პერსონალიზაცია	✅	✅	✅	❌
ტიპიური 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 ფუნქციები