Αποστολή και εξατομίκευση transactional emails
Κάθε κλήση transactional API περιλαμβάνει πλήρες HTML του email σας απευθείας στο σώμα αιτήματος. Αυτό σας δίνει πλήρη έλεγχο στο περιεχόμενο και τη δομή κάθε μηνύματος που αποστέλλει η εφαρμογή σας.
Πώς λειτουργεί
Μεταβιβάζετε το HTML (και προαιρετικά απλό κείμενο) απευθείας στο σώμα αιτήματος API. Η εφαρμογή σας δημιουργεί δυναμικά το περιεχόμενο email και το συμπεριλαμβάνει σε κάθε αίτημα.
Εξατομίκευση
Η εξατομίκευση σας επιτρέπει να εισάγετε δυναμικές τιμές στο email σας — το μικρό όνομα του παραλήπτη, αριθμό παραγγελίας, όνομα προϊόντος, τιμή. Ορίζετε placeholders στο HTML σας και μεταβιβάζετε τις αντίστοιχες τιμές στην κλήση API.
Η ακριβής σύνταξη placeholder και οι παράμετροι API για μεταβίβαση τιμών μεταβλητών τεκμηριώνονται στην τεκμηρίωση Flexmail Email API στη διεύθυνση email-api.flexmail.eu/documentation, στις ενότητες Εξατομίκευσης.
Συνηθισμένες μεταβλητές εξατομίκευσης
Τυπικές μεταβλητές που χρησιμοποιούνται σε transactional emails περιλαμβάνουν:
- Όνομα παραλήπτη (μικρό όνομα, πλήρες όνομα)
- Αριθμός παραγγελίας ή αναφοράς
- Ονόματα και ποσότητες προϊόντων
- Τιμές και σύνολα
- Ημερομηνίες και προθεσμίες
- Σύνδεσμοι επιβεβαίωσης ή επαναφοράς
- URL ή κωδικοί συγκεκριμένοι για τον λογαριασμό
Δοκιμή εξατομίκευσης
Πριν τεθείτε σε παραγωγή, δοκιμάστε το email σας με ρεαλιστικές τιμές μεταβλητών για να βεβαιωθείτε ότι όλα τα placeholders επιλύονται σωστά. Η τεκμηρίωση API περιλαμβάνει καθοδήγηση για αποστολή δοκιμαστικών μηνυμάτων με προσαρμοσμένες τιμές μεταβλητών.
Ελέγξτε ιδιαίτερα ότι:
- Όλα τα placeholders αντικαθίστανται — καμία ακατέργαστη σύνταξη μεταβλητής δεν εμφανίζεται στο παραδοθέν email.
- Οι τιμές εναλλακτικής λύσης εμφανίζονται σωστά όταν δεν μεταβιβάζεται προαιρετική μεταβλητή.
- Οι σύνδεσμοι αναλύονται στις σωστές διευθύνσεις URL μετά από αντικατάσταση μεταβλητής.
Σημαντικό
Εάν απαιτούμενη μεταβλητή λείπει από την κλήση API και δεν ορίζεται εναλλακτική τιμή, το placeholder μπορεί να εμφανιστεί κυριολεκτικά στο παραδοθέν email. Πάντα δοκιμάζετε με το ίδιο σύνολο μεταβλητών που θα αποστέλλει η εφαρμογή σας στην παραγωγή.
Επόμενα βήματα
- Δείτε "Ξεκινώντας με το transactional API" για ρύθμιση λογαριασμού και πρώτη αποστολή.
- Ελέγξτε την ενότητα Πρότυπα στην τεκμηρίωση API στη διεύθυνση email-api.flexmail.eu/documentation για την πλήρη αναφορά παραμέτρων.
- Δείτε "Transactional webhooks" για παρακολούθηση παράδοσης και δέσμευσης για αποστολές βάσει προτύπου.