Viber Transactional & OTP Message Templates (el)

Από την 1η Ιουλίου 2026, η χρήση templates είναι υποχρεωτική για όλα τα Transactional Viber Business Messages.

Αυτό περιλαμβάνει μηνύματα όπως επιβεβαιώσεις παραγγελιών, υπενθυμίσεις ραντεβού και κωδικοί μιας χρήσης (OTP), τα οποία δεν θα υποστηρίζουν πλέον ελεύθερο κείμενο.

Τα Transactional Message Templates είναι δομημένες, μόνο-κειμένου μορφές μηνυμάτων που επιτρέπουν στις επιχειρήσεις να στέλνουν τυποποιημένα μηνύματα με δυναμικές παραμέτρους για εξατομίκευση.

Αυτή η απαίτηση αφορά μόνο το transactional messaging και δεν επηρεάζει τις promotional Viber καμπάνιες.

Οι Δύο Κατηγορίες

Το Viber υποστηρίζει δύο τύπους transactional templates:

Κατηγορία	Περιγραφή
Transactional	Χρησιμοποιούνται για ειδοποιήσεις πελατών όπως επιβεβαιώσεις παραγγελιών, υπενθυμίσεις ραντεβού και ενημερώσεις υπηρεσιών.
OTP	Χρησιμοποιούνται για ροές αυθεντικοποίησης που απαιτούν κωδικό μιας χρήσης.

Μέρος 1 — Δημιουργία Template

Βήμα 1 — Δημιουργία Template στην Πλατφόρμα της Apifon

Τα templates δημιουργούνται μέσω της πλατφόρμας Apifon, όχι μέσω API.

Αν στέλνετε μέσω API, θα πρέπει πρώτα να δημιουργήσετε το template στην πλατφόρμα Apifon και στη συνέχεια να χρησιμοποιήσετε το Viber Template ID.

Μεταβείτε στο mookee.apifon.com και συνδεθείτε.
Στο αριστερό μενού, κάντε κλικ στο Templates.
Επιλέξτε την καρτέλα Viber.
Κάντε κλικ στο κουμπί + Add.
Επιλέξτε Transactional ως τύπο template.
Επιλέξτε είτε OTP είτε Transactional ως κατηγορία. Κάθε κατηγορία έχει διαφορετικές απαιτήσεις· για παράδειγμα, τα OTP templates απαιτούν κωδικό μιας χρήσης.
Δώστε ένα περιγραφικό όνομα και τη γλώσσα του template σας.
Επιλέξτε Viber Sender ID από το dropdown. Πρέπει να είναι ένας από τους εγγεγραμμένους Viber senders σας. Αν δεν εμφανίζονται senders, πρέπει πρώτα να ρυθμίσετε ένα Viber Sender ID.

Βήμα 2 — Ορισμός Παραμέτρων και Σώματος Μηνύματος

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

Χρησιμοποιήστε το κουμπί Add Variable για να εισαγάγετε ονόματα μεταβλητών στο σώμα του μηνύματός σας.
Ακολουθήστε όλους τους κανόνες επικύρωσης που εμφανίζονται στην επάνω δεξιά γωνία του editor (όρια χαρακτήρων, κανόνες μορφοποίησης κ.λπ.).
Όταν είστε έτοιμοι, κάντε κλικ στο Submit for Approval.

Σύμφωνα με τους περιορισμούς της Viber:

Μπορείτε να προσθέσετε έως 8 μεταβλητές ανά μήνυμα.
Το μέγιστο μήκος για κάθε value είναι 125 χαρακτήρες.

Βήμα 3 — Παρακολούθηση Έγκρισης και Λήψη Template ID

Στο μενού Templates, κάντε κλικ στο φίλτρο Transactional για να δείτε μόνο τα transactional templates σας.

Περιμένετε την αξιολόγηση της Viber. Η κατάσταση ενημερώνεται αυτόματα:

Κατάσταση	Σημασία
PENDING	Υποβλήθηκε, αναμένεται αξιολόγηση από τη Viber.
APPROVED	Η Viber αποδέχτηκε το template.
DECLINED	Η Viber απέρριψε το template. Δημιουργήστε νέο template με τις απαραίτητες αλλαγές και υποβάλετε ξανά για έγκριση.

Μόλις γίνει APPROVED, είστε έτοιμοι για αποστολή.

Κάντε κλικ στο εικονίδιο Copy για να αντιγράψετε το Viber Template ID. Αυτό το ID απαιτείται κατά την αποστολή μηνυμάτων με αυτό το template μέσω API.
image-png-Jun-12-2026-12-31-02-7271-PM

Μέρος 2 — Αποστολή Μηνύματος με Template μέσω API

Για αναλυτικές οδηγίες σχετικά με την αποστολή και διαχείριση Viber Template requests, συμβουλευτείτε την 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 για αυτόν τον παραλήπτη.

Το Πιο Σημαντικό — Αντιστοίχιση Ονομάτων Μεταβλητών

Τα ονόματα μεταβλητών πρέπει να ταιριάζουν ακριβώς.

Όταν δημιουργείτε ένα 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 σήμερα.