Μετάβαση στο περιεχόμενο

Μηνύματα Viber

Το SMSBAT API υποστηρίζει πολλούς τύπους μηνυμάτων Viber για διαφορετικές περιπτώσεις χρήσης, από διαφημιστικές καμπάνιες έως ειδοποιήσεις συναλλαγών.

Επισκόπηση τύπων μηνυμάτων

Τύπος Σκοπός Rich Media Διαδραστική
viber_promo Καμπάνιες μάρκετινγκ ✅ Εικόνες, βίντεο ✅ Κουμπιά
viber_trans Ειδοποιήσεις συναλλαγών ✅ PDF ❌
viber_carousel Βιτρίνες προϊόντων ✅ Εικόνες ✅ Πολλαπλά κουμπιά
viber_survey Δημοσκοπήσεις και σχόλια ❌ ✅ Πολλαπλές επιλογές
viber_otp Κωδικοί πρόσβασης μίας χρήσης ❌ ❌

Viber Promo

Προωθητικά μηνύματα με πλούσια υποστήριξη μέσων για καμπάνιες μάρκετινγκ.

Υποστηριζόμενο περιεχόμενο

  • Μόνο εικόνα
  • Μόνο κείμενο
  • Κείμενο + κουμπί
  • Εικόνα + κείμενο + κουμπί
  • Βίντεο + κείμενο
  • Κουμπί βίντεο + κείμενο +
  • Μόνο βίντεο

Παράμετροι

Παράμετρος Τύπος Απαιτείται Περιγραφή
img χορδή Όχι Διεύθυνση URL εικόνας
βίντεο χορδή Όχι URL αρχείου βίντεο
μικρογραφία χορδή Όχι Εικόνα προεπισκόπησης βίντεο
buttonText χορδή Όχι Ετικέτα κουμπιού παρότρυνσης για δράση
"buttonAction" χορδή Όχι Κάντε κλικ στο κουμπί URL προορισμού
Μέγεθος αρχείου ακέραιος Όχι Μέγεθος αρχείου βίντεο σε byte
«διάρκεια» ακέραιος Όχι Διάρκεια βίντεο σε δευτερόλεπτα

Παραδείγματα

Κείμενο + Εικόνα + Κουμπί

Κείμενο + Εικόνα + Παράδειγμα κουμπιού

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

Βίντεο + Κείμενο + Κουμπί

Παράδειγμα βίντεο + κείμενο + κουμπί

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

Μόνο εικόνα

Παράδειγμα μόνο εικόνας

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

Μόνο κείμενο

Παράδειγμα μόνο κειμένου

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

Μόνο βίντεο

Παράδειγμα μόνο βίντεο

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Βίντεο + Κείμενο

Παράδειγμα βίντεο + κειμένου

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Viber Transactional

Ειδοποιήσεις συναλλαγών για ευαίσθητες στο χρόνο πληροφορίες, όπως επιβεβαιώσεις παραγγελιών και αποδείξεις.

Υποστηριζόμενο περιεχόμενο

  • Μόνο κείμενο
  • Αρχείο PDF + κείμενο
  • Μόνο αρχείο PDF

Παράμετροι

Παράμετρος Τύπος Απαιτείται Περιγραφή
fileUrl χορδή Όχι URL εγγράφου PDF
Όνομα αρχείου χορδή Όχι Εμφανιζόμενο όνομα για συνημμένο
«Τύπος αρχείου» χορδή Όχι Τύπος αρχείου (χρησιμοποιήστε "pdf")

Παραδείγματα

Μόνο κείμενο

Παράδειγμα μόνο κειμένου

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

Κείμενο + PDF

Παράδειγμα κειμένου + PDF

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Μόνο PDF

PDF μόνο Παράδειγμα

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Βιτρίνα με δυνατότητα περιήγησης πολλών στοιχείων για προϊόντα ή περιεχόμενο.

Δομή

Σειρά αντικειμένων καρουζέλ, καθένα από τα οποία περιέχει:

  • Τίτλος
  • Εικόνα
  • Κύριο κουμπί (κύρια δράση)
  • Δευτερεύον κουμπί (εναλλακτική ενέργεια)

Παράμετροι

Παράμετρος Τύπος Απαιτείται Περιγραφή
«καρουσέλ» συστοιχία Ναι Σειρά αντικειμένων καρουζέλ
«αντικείμενα» συστοιχία Ναι Μεμονωμένα αντικείμενα κάρτας

Παράδειγμα

Viber Carousel Example

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

Έρευνα Viber

Διαδραστικές δημοσκοπήσεις και συλλογή σχολίων με επιλογές πολλαπλών επιλογών.

Παράμετροι

Παράμετρος Τύπος Απαιτείται Περιγραφή
«έρευνα» αντικείμενο Ναι Δοχείο έρευνας
"επιλογές" συστοιχία Ναι Πίνακας 1-5 επιλογών απαντήσεων

Περιορισμοί

  • Υποστηρίζονται έως και 5 επιλογές απόκρισης
  • Κάθε επιλογή πρέπει να είναι συνοπτική (συνιστάται: κάτω από 30 χαρακτήρες)

Παράδειγμα

Παράδειγμα έρευνας Viber

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

Viber OTP

Εφάπαξ παράδοση κωδικού πρόσβασης με προκαθορισμένα πρότυπα.

Βασικά χαρακτηριστικά

  • 9 προκαθορισμένα πρότυπα
  • Επικύρωση παραμέτρων (TEXT, NUMBER τύποι)
  • Υποστήριξη πολλών γλωσσών (19 γλώσσες)
  • Ονόματα μεταβλητών με διάκριση πεζών-κεφαλαίων

Υποστηριζόμενες γλώσσες

Ουκρανικά, Αγγλικά, Ρωσικά, Πολωνικά, Ρουμανικά, Ισπανικά, Γερμανικά, Γαλλικά, Ιταλικά, Πορτογαλικά, Ολλανδικά, Τουρκικά, Αραβικά, Εβραϊκά, Χίντι, Κινέζικα, Ιαπωνικά, Κορεάτικα, Βιετναμέζικα

Παράμετροι

Παράμετρος Τύπος Απαιτείται Περιγραφή
templateId συμβολοσειρά (UUID) Ναι Αναγνωριστικό προτύπου
templateLang χορδή Ναι Κωδικός γλώσσας ISO
templateParams αντικείμενο Ναι Πρότυπο αντιστοίχισης μεταβλητών

Παράδειγμα

Παράδειγμα Viber OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

Παράδειγμα προτύπου: "Ο κωδικός σας: 123456. Ισχύει για 10 λεπτά. Μην κοινοποιείτε ποτέ αυτόν τον κωδικό."

Υποστηριζόμενα πρότυπα και επικυρώσεις

Το Viber προσφέρει προκαθορισμένα και αυστηρά ελεγχόμενα πρότυπα. Οι παράμετροι μεταβλητών που διαβιβάζονται πρέπει να αντιστοιχούν στους σωστούς τύπους δεδομένων.

Τύποι δεδομένων: - ΑΡΙΘΜΟΣ: Μόνο αριθμοί «[0-9]», «+», «-» και «.». Σύμβολα όπως "/" ή κενό διάστημα δεν υποστηρίζονται. - ΚΕΙΜΕΝΟ: Οποιοδήποτε γλωσσικό αλφάβητο, σύμβολα (@#$%^&*().,<>;:!\"'+=-()[]{} \n κ.λπ.). - Κανονική αντιστοίχιση: Μια ακολουθία «<γράμματα>» δεν μπορεί να υπάρχει δίπλα σε μια ακολουθία «<αριθμός>». απαιτούν διαχωρισμό κενών χώρων. Τα διπλά κενά μέσα στα πρότυπα απαγορεύονται γενικά. Για συνδέσμους, αποφύγετε τα κενά εάν υπερβαίνουν τα όρια.

Παρακάτω είναι τα 9 τυπικά πρότυπα ISO. Αντικαταστήστε τα αναγνωριστικά με βάση τις απαιτήσεις εγγραφής σας σε συγκεκριμένες χώρες. Επικοινωνήστε με την υποστήριξη εάν προσθέσετε επιπλέον γλώσσες.

1. "ΜΟΝΟ Κωδικός (Οποιοδήποτε PIN)"

Απαιτήσεις: Υποστηρίζει PIN με αριθμούς και αγγλικά γράμματα, σύμβολα "-" ή ".". Το πρότυπο απαιτεί μορφοποίηση για να εμφανίζεται σωστά η επωνυμία σας μαζί με το PIN επαλήθευσης.

2. "Ενέργεια: Χρησιμοποιήστε αυτόν τον κωδικό"

Παράμετροι: {pin} (ΑΡΙΘΜΟΣ ή ΚΕΙΜΕΝΟ) Παράδειγμα μορφής: "Παρακαλώ χρησιμοποιήστε αυτόν τον κωδικό {pin} για επαλήθευση."

3. "Εγγραφή/Πρόσβαση επωνυμίας"

Παράμετροι: "{business_platform_name}" (TEXT), "{pin}" (NUMBER ή TEXT) Παράδειγμα μορφής: "Ο κωδικός σας για το {business_platform_name} είναι {pin}."

4. "Χρόνος επικύρωσης κώδικα"

Παράμετροι: "{pin}" (NUMBER/TEXT), "{code_validity_time}" (NUMBER) Παράδειγμα μορφής: "Ο κωδικός επαλήθευσης είναι {pin}. Ισχύει για {code_validity_time} λεπτά."

5. "Πρόσβαση επωνυμίας και επικύρωση κώδικα"

Παράμετροι: "{business_platform_name}" (TEXT), "{pin}" (NUMBER/TEXT), "{code_validity_time}" (NUMBER) Παράδειγμα μορφής: "Ο κωδικός επαλήθευσης {business_platform_name} είναι {pin} έγκυρος για {code_validity_time} λεπτά."

(Σημείωση: Υπάρχουν έως και 9 προκαθορισμένα δομικά μπλοκ για τυπικούς κανόνες OTP του Viber που βασίζονται σε συνδυασμούς της χρήσης «pin», «business_platform_name» και «code_validity_time»).

Γενικές απαιτήσεις

Όλοι οι τύποι μηνυμάτων Viber απαιτούν:

  • από: Αλφαριθμητικό αναγνωριστικό αποστολέα
  • προς: Αριθμός τηλεφώνου σε μορφή E.164
  • τύπος: Αναγνωριστικό τύπου μηνύματος
  • ttl: Χρόνος λήξης μηνύματος σε δευτερόλεπτα (συνιστάται)

Εναλλαγή στα SMS

Όλοι οι τύποι μηνυμάτων Viber υποστηρίζουν εναλλακτικό SMS χρησιμοποιώντας το μπλοκ συστοιχίας «εναλλακτικά». Εάν η παράδοση του Viber αποτύχει, το μήνυμα επιστρέφει αυτόματα σε εναλλακτικά διαμορφωμένα κανάλια.

Viber Promo -> Εναλλακτικό SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Έρευνα Viber -> Εναλλαγή SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Viber Trans -> Εφεδρικό SMS

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

Βέλτιστες πρακτικές

Εικόνες

  • Χρησιμοποιήστε μορφή JPG ή PNG
  • Προτεινόμενο μέγεθος: 800x600 pixel
  • Διατηρήστε το μέγεθος αρχείου κάτω από 1MB
  • Χρησιμοποιήστε διευθύνσεις URL HTTPS

Βίντεο

  • Χρησιμοποιήστε μορφή MP4
  • Διατηρήστε το μέγεθος αρχείου κάτω από 10MB
  • Συμπεριλάβετε μικρογραφία εικόνας
  • Καθορίστε τη διάρκεια και το μέγεθος αρχείου

Κουμπιά

  • Κρατήστε το κείμενο του κουμπιού σύντομο (2-3 λέξεις)
  • Χρησιμοποιήστε σαφείς φράσεις παρότρυνσης για δράση
  • Να χρησιμοποιείτε πάντα διευθύνσεις URL HTTPS
  • Δοκιμάστε τις διευθύνσεις URL πριν από την αποστολή

TTL (Time-to-Live)

  • Προωθητικά μηνύματα: 24-72 ώρες
  • Μηνύματα συναλλαγών: 24 ώρες
  • Μηνύματα OTP: 5-10 λεπτά
  • Έρευνες: 7-30 ημέρες

Επόμενα βήματα