Πρότυπα Viber Transactional & OTP Μηνυμάτων
Από την 1η Ιουλίου 2026, η χρήση προτύπων (templates) είναι υποχρεωτική για όλα τα Transactional Viber Business μηνύματα.
Αυτό περιλαμβάνει μηνύματα όπως επιβεβαιώσεις παραγγελιών, υπενθυμίσεις ραντεβού και κωδικοί μιας χρήσης (OTP), τα οποία δεν θα υποστηρίζουν πλέον ελεύθερο κείμενο.
Τα Transactional Message Templates είναι δομημένες μορφές μηνυμάτων που αποτελούνται αποκλειστικά από κείμενο με ενημερωτικό περιεχόμενο και επιτρέπουν στις επιχειρήσεις να αποστέλλουν τυποποιημένα μηνύματα με δυναμικές παραμέτρους για εξατομίκευση.
Η αλλαγή αυτή αφορά αποκλειστικά το transactional messaging και δεν επηρεάζει τις promotional Viber καμπάνιες.
Οι Δύο Κατηγορίες
Το Viber υποστηρίζει δύο τύπους transactional templates:
| Κατηγορία | Περιγραφή |
|---|---|
| Transactional | Χρησιμοποιούνται για ειδοποιήσεις πελατών όπως επιβεβαιώσεις παραγγελιών, υπενθυμίσεις ραντεβού και ενημερώσεις υπηρεσιών. |
| OTP | Χρησιμοποιούνται για ροές αυθεντικοποίησης που απαιτούν κωδικό μιας χρήσης. |
Μέρος 1 — Δημιουργία Template
Βήμα 1 — Δημιουργία Template
Δημιουργήστε και διαχειριστείτε τα Viber Transactional Templates σας μέσω της πλατφόρμας της Apifon ή μέσω API.
-
Μέσω της πλατφόρμας της Apifon (Mookee UI) — ακολουθήστε τα βήματα που περιγράφονται παρακάτω.
-
Μέσω API — διαχειριστείτε τα templates προγραμματιστικά. Για πλήρεις οδηγίες, ανατρέξτε στο Viber Templates REST API.
Και στις δύο περιπτώσεις, το template υποβάλλεται στη Viber για έγκριση. Η απάντηση επιστρέφεται αμέσως με κατάσταση PENDING και ενημερώνεται αυτόματα μόλις η Viber ολοκληρώσει την αξιολόγηση.
Δημιουργία template μέσω του Mookee:
- Μεταβείτε στο mookee.apifon.com και συνδεθείτε.
- Στο αριστερό μενού, κάντε κλικ στην επιλογή Πρότυπα.
.png?width=550&height=350&name=Email%20Marketing%20Images%20(6).png)
- Επιλέξτε την καρτέλα Viber.

- Κάντε κλικ στο κουμπί + Προσθήκη.

- Επιλέξτε Transactional ως τύπο template.

- Επιλέξτε είτε OTP είτε Transactional ως κατηγορία. Κάθε κατηγορία έχει διαφορετικές απαιτήσεις, για παράδειγμα τα OTP templates απαιτούν κωδικό μιας χρήσης.

- Δώστε όνομα και γλώσσα στο template σας.

- Επιλέξτε το Viber Sender ID σας από το dropdown. Πρέπει να είναι ένα ενεργό Όνομα Αποστολέα που εμφανίζεται στις Viber καμπάνιες σας. Αν δεν εμφανίζεται, πρέπει πρώτα να ενεργοποιήσετε ένα Viber Sender ID.

Βήμα 2 — Ορισμός Παραμέτρων και Σώματος Μηνύματος
- Στη δεξιά πλευρά, κάτω από την προεπισκόπηση μηνύματος, κάντε κλικ στο Add Variable. Εισαγάγετε ένα Variable name και ένα Example value, και κάντε κλικ στο Add & Insert.
- Variable name — το όνομα του placeholder (π.χ.
NAME,ORDER). Αυτό εμφανίζεται μέσα στις αγκύλες
στο σώμα του μηνύματος. - Example value — μια δειγματική τιμή για προεπισκόπηση (π.χ.
Maria,A-4471).

- Variable name — το όνομα του placeholder (π.χ.
- Στο κεντρικό πεδίο, γράψτε το σώμα του μηνύματός σας.

Χρησιμοποιήστε το κουμπί Add Variable για να εισαγάγετε ονόματα μεταβλητών στο σώμα του μηνύματός σας. - Ακολουθήστε όλους τους κανόνες επικύρωσης που εμφανίζονται στην επάνω δεξιά γωνία του editor (όρια χαρακτήρων, κανόνες μορφοποίησης κ.λπ.).
- Όταν είστε έτοιμοι, κάντε κλικ στο Submit for Approval.
Βεβαιωθείτε ότι η λίστα επαφών σας περιλαμβάνει τα μεταβλητά πεδία που χρησιμοποιεί το template σας (π.χ. NAME, ORDER). Αν ένας παραλήπτης δεν έχει κάποιο απαραίτητο πεδίο, το μήνυμα δεν θα παραδοθεί σε αυτόν.
Σύμφωνα με τους περιορισμούς της Viber:
- Μπορείτε να προσθέσετε έως 8 μεταβλητές ανά μήνυμα.
- Το μέγιστο μήκος για κάθε value είναι 125 χαρακτήρες.
Βήμα 3 — Παρακολούθηση Έγκρισης και Λήψη Template ID
- Στο μενού Templates, κάντε κλικ στο φίλτρο Transactional για να δείτε μόνο τα transactional templates σας.
- Περιμένετε την αξιολόγηση της Viber. Η κατάσταση ενημερώνεται αυτόματα:
Κατάσταση Σημασία PENDING Υποβλήθηκε, αναμένεται αξιολόγηση από τη Viber. APPROVED Η Viber αποδέχτηκε το template. DECLINED Η Viber απέρριψε το template. Δημιουργήστε νέο template με τις απαραίτητες αλλαγές και υποβάλετε ξανά για έγκριση. - Μόλις γίνει APPROVED, είστε έτοιμοι για αποστολή.
Αν δημιουργήσετε το template μέσω της πλατφόρμας Mookee και θέλετε να το χρησιμοποιήσετε στα API requests σας, κάντε κλικ στο εικονίδιο Copy για να αντιγράψετε το Viber Template ID και συμπεριλάβετέ το στο send request σας.
Μέρος 2 — Αποστολή Μηνύματος με Transactional Template
Αποστολή μέσω της Πλατφόρμας Apifon
Μόλις το template εγκριθεί, ακολουθήστε τα παρακάτω βήματα για να στείλετε την Viber καμπάνια σας από την πλατφόρμα της Apifon:
Ακολουθήστε τη συνηθισμένη διαδικασία δημιουργίας Viber καμπάνιας. Στο τρίτο βήμα του σχεδιασμού της καμπάνιας, επιλέξτε ένα από τα παρακάτω:- Αν έχετε εγκεκριμένο template: Μεταβείτε στην επιλογή Templates για να το επιλέξετε. Το κείμενο συμπληρώνεται αυτόματα.
- Αν δεν έχετε template: Γράψτε το κείμενο του μηνύματος απευθείας στο πεδίο, συμπεριλαμβάνοντας τις μεταβλητές.
Και στις δύο περιπτώσεις, βεβαιωθείτε ότι οι μεταβλητές στο κείμενο της καμπάνιας χρησιμοποιούν μονές αγκύλες {ΤΙΜΗ} αντί για διπλές . Η πλατφόρμα απαιτεί αυτή τη μορφή για την εξατομίκευση καμπανιών.
-
Προγραμματίστε την καμπάνια τουλάχιστον 10 λεπτά μπροστά. Με αυτόν τον τρόπο ενεργοποιείται το auto-templating.
Αποστολή μέσω API
Για αναλυτικές οδηγίες σχετικά με την αποστολή και διαχείριση των Viber Templates, συμβουλευτείτε τo API Documentation μας.
Βήμα 1 — Αναφορά στο Template
Στο send request, τοποθετήστε το template_id στην καταχώρηση του Viber channel.
Βήμα 2 — Παροχή Τιμών για Κάθε Παραλήπτη
Κάθε παραλήπτης φέρει το δικό του σύνολο τιμών εξατομίκευσης. Για κάθε παράμετρο που δηλώνει το template, ο παραλήπτης πρέπει να παρέχει μια αντίστοιχη τιμή.
Το Πιο Σημαντικό — Αντιστοίχιση Ονομάτων Μεταβλητών
Τα ονόματα μεταβλητών πρέπει να ταιριάζουν ακριβώς.
Όταν δημιουργείτε ένα template στην πλατφόρμα Apifon, επιλέγετε εσείς τα ονόματα των μεταβλητών. Στο σώμα του μηνύματος, κάθε μεταβλητή περικλείεται σε διπλά άγκιστρα.
Αυτά τα ακριβή ονόματα πρέπει να εμφανίζονται στα subscriber fields του API request. Κάθε παραλήπτης φέρει ένα params block, το οποίο πρέπει να περιέχει ένα κλειδί για κάθε όνομα μεταβλητής που δηλώνει το template, με την ίδια ακριβώς ορθογραφία (τα ονόματα είναι case-sensitive).
Η πλατφόρμα διαβάζει κάθε δηλωμένο όνομα (π.χ. NAME, ORDER), το αναζητά στα params του συγκεκριμένου subscriber και συμπληρώνει το template για αυτόν τον παραλήπτη.
Κανόνες Αντιστοίχισης Μεταβλητών
| Σενάριο | Αποτέλεσμα |
|---|---|
Μια μεταβλητή (π.χ. ORDER) λείπει από τα params ενός subscriber |
Το σύνολο του request απορρίπτεται (403), με αναφορά στον συγκεκριμένο subscriber και τη μεταβλητή που λείπει. |
Το όνομα γράφεται διαφορετικά (Order αντί ORDER) |
Αντιμετωπίζεται ως απούσα → απόρριψη. Τα ονόματα πρέπει να ταιριάζουν ακριβώς. |
| Ένας subscriber έχει επιπλέον params που δεν χρησιμοποιεί το template | Επιτρέπεται — τα επιπλέον αγνοούνται. Διαβάζονται μόνο τα δηλωμένα ονόματα. |
| Μια τιμή υπερβαίνει τους 125 χαρακτήρες ή περιέχει σύνδεσμο | Απόρριψη, με αναφορά στον subscriber και τη μεταβλητή. |
Βήμα 3 — Παράδοση
Τα έγκυρα requests διοχετεύονται μέσα από το κανονικό pipeline της πλατφόρμας και παραδίδονται στη Viber ως transactional template μηνύματα, με το εγκεκριμένο κείμενο συμπληρωμένο ανά παραλήπτη.
Ξεκινήστε να δημιουργείτε το πρώτο σας template σήμερα!