Help Center Μηνύματα Viber

Μηνύματα Viber

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

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

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

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

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

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

Παράμετροι

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
`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

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

Δομή

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

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

Παράμετροι

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

Παράδειγμα

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 αποτύχει, το μήνυμα επιστρέφει αυτόματα σε εναλλακτικά διαμορφωμένα κανάλια.

{
  "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 ημέρες

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

Μηνύματα SMS - Μάθετε για το εναλλακτικό SMS
Μηνύματα RCS - Πλούσιες υπηρεσίες επικοινωνίας
Έλεγχος κατάστασης - Παρακολούθηση της κατάστασης παράδοσης

Search Results

Μηνύματα Viber

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

Viber Promo

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

Παράμετροι

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

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

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

Μόνο εικόνα

Μόνο κείμενο

Μόνο βίντεο

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

Viber Transactional

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

Παράμετροι

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

Μόνο κείμενο

Κείμενο + PDF

Μόνο PDF

Viber Carousel

Δομή

Παράμετροι

Παράδειγμα

Έρευνα Viber

Παράμετροι

Περιορισμοί

Παράδειγμα

Viber OTP

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

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

Παράμετροι

Παράδειγμα

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

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

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

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

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

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

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

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

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

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

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

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

Εικόνες

Βίντεο

Κουμπιά

TTL (Time-to-Live)

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