SMTP υποβολές για transactional email

Εκτός από το HTTP API, το Flexmail υποστηρίζει αποστολή transactional email μέσω SMTP. Αυτό είναι χρήσιμο όταν η εφαρμογή ή η πλατφόρμα σας έχει ήδη ενσωματωμένη υποστήριξη SMTP — ένα CMS, πλατφόρμα ηλεκτρονικού εμπορίου ή παλαιό σύστημα που αποστέλλει email μέσω SMTP relay.

Η υποβολή SMTP περιλαμβάνεται στο transactional προϊόν χωρίς επιπλέον κόστος. Παρέχει την ίδια αξιοπιστία παράδοσης και δυνατότητες παρακολούθησης με το API, με μερικές διαφορές στις προεπιλογές και τις υποστηριζόμενες λειτουργίες.

Σημείωση

Η υποβολή SMTP δεν είναι ενεργοποιημένη από προεπιλογή. Πρέπει να ζητήσετε ρητά πρόσβαση. Δείτε "Αίτηση πρόσβασης" παρακάτω.

Αίτηση πρόσβασης

Η πρόσβαση SMTP δεν ενεργοποιείται αυτόματα κατά την ενεργοποίηση του transactional προϊόντος. Για να ζητήσετε διαπιστευτήρια SMTP για τον λογαριασμό σας, επικοινωνήστε με την υποστήριξη Flexmail στο support@flexmail.eu και συμπεριλάβετε το ID του λογαριασμού σας στο αίτημα. Το όνομα χρήστη και ο κωδικός πρόσβασης SMTP θα σας παρασχεθούν ως μέρος της απάντησης διαπιστευτηρίων.

Σημείωση

Τα διαπιστευτήρια SMTP σας είναι ξεχωριστά από το προσωπικό σας access token. Το όνομα χρήστη και ο κωδικός πρόσβασης για SMTP παρέχονται από το Flexmail κατόπιν αιτήματος — μη χρησιμοποιείτε το ID του λογαριασμού σας και το προσωπικό access token ως διαπιστευτήρια SMTP.

Ρυθμίσεις σύνδεσης

Μόλις χορηγηθεί η πρόσβαση SMTP, χρησιμοποιήστε τις ακόλουθες ρυθμίσεις:

Ρύθμιση

Τιμή

Διακομιστής

submission.flexmail.eu

Θύρα

587

Ασφάλεια σύνδεσης

STARTTLS

Όνομα χρήστη

Παρέχεται από το Flexmail κατόπιν αιτήματος

Κωδικός πρόσβασης

Παρέχεται από το Flexmail κατόπιν αιτήματος

Προσαρμοσμένες κεφαλίδες

Οι υποβολές SMTP υποστηρίζουν αρκετές προαιρετικές προσαρμοσμένες κεφαλίδες που ελέγχουν τη συμπεριφορά και την παρακολούθηση μηνυμάτων. Αυτές λειτουργούν παρόμοια με τις επιλογές που είναι διαθέσιμες στο HTTP API.

Κεφαλίδα

Περιγραφή

X-Flexmail-Tag

Προσθήκη ετικέτας για κατηγοριοποίηση μηνυμάτων και συσσώρευση στατιστικών. Πρέπει να είναι σε μορφή snake_case (1–50 χαρακτήρες, π.χ. order_confirmation).

X-Flexmail-Metadata-{key}

Προσθήκη προσαρμοσμένων μεταδεδομένων ως ζεύγη κλειδιού/τιμής. Αντικαταστήστε το {key} με το όνομα πεδίου σας σε snake_case. Η τιμή πρέπει να έχει 1–80 χαρακτήρες.

X-Flexmail-Open-Tracking

Ορίστε σε true για ενεργοποίηση παρακολούθησης ανοίγματος. Απενεργοποιημένο από προεπιλογή.

X-Flexmail-Link-Tracking

Ορίστε σε true για ενεργοποίηση link tracking. Απενεργοποιημένο από προεπιλογή.

Παράδειγμα:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Σημείωση

Η παρακολούθηση ανοίγματος και link tracking είναι απενεργοποιημένα από προεπιλογή τόσο για υποβολές SMTP όσο και για το HTTP API. Προσθέστε τις αντίστοιχες κεφαλίδες εάν θέλετε να ενεργοποιηθεί η παρακολούθηση.

Message ID και συσχέτιση webhook

Η αρχική κεφαλίδα Message-ID από το υποβληθέν email σας αποθηκεύεται αυτόματα ως μεταδεδομένα με το κλειδί original_message_id. Αυτό σας επιτρέπει να συσχετίζετε συμβάντα παράδοσης webhook με τα μηνύματα που αποστείλατε από το δικό σας σύστημα.

SMTP vs. HTTP API

Οι δύο μέθοδοι έχουν ορισμένες διαφορές στις προεπιλογές και τις δυνατότητες:

Λειτουργία

HTTP API

Υποβολή SMTP

Παρακολούθηση ανοίγματος

Απενεργοποιημένο από προεπιλογή

Link tracking

Απενεργοποιημένο από προεπιλογή

Αρχικό Message-ID

Δ/Υ

Διατηρείται ως μεταδεδομένα original_message_id

Inline συνημμένα

Υποστηρίζονται

Δεν υποστηρίζονται

Email μόνο με απλό κείμενο

Υποστηρίζεται

Δεν υποστηρίζεται

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

HTML emails με ή χωρίς multipart απλού κειμένου.
Παρακολούθηση ανοίγματος και link tracking (μέσω προσαρμοσμένων κεφαλίδων).
Παραλήπτες CC και BCC.
Συνημμένα — πρέπει να είναι κωδικοποιημένα σε base64. Τα inline συνημμένα δεν υποστηρίζονται.
Περιορισμός ρυθμού ανά παραλήπτη, συνεπής με τα όρια ρυθμού API.

Απαιτήσεις

Η διεύθυνση From πρέπει να είναι επαληθευμένος αποστολέας στον λογαριασμό Flexmail σας.
Ο τομέας αποστολής πρέπει να έχει επαλήθευση ταυτότητας με SPF, DKIM και DMARC, και πρέπει να έχει διαμορφωθεί return-path. Αυτές οι απαιτήσεις είναι ίδιες με αυτές για το HTTP API.

Διαχείριση σφαλμάτων

Τα σφάλματα υποβολής αναφέρονται μέσω NDR (Non-Delivery Report) που αποστέλλεται στη διεύθυνση αποστολέα envelope. Τα συμβάντα αναπήδησης και όλα τα άλλα συμβάντα μηνύματος είναι επίσης διαθέσιμα μέσω του endpoint λεπτομερειών μηνύματος και webhooks, με τον ίδιο τρόπο όπως και οι αποστολές API.

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

Δείτε "Ξεκινώντας με το transactional API" για την πλήρη διαδικασία ρύθμισης λογαριασμού.
Δείτε "Transactional webhooks" για λήψη συμβάντων παράδοσης και παρακολούθησης σε πραγματικό χρόνο.
Δείτε "Αντιμετώπιση προβλημάτων transactional" εάν η σύνδεση SMTP ή η παραδοσιμότητα δεν λειτουργεί όπως αναμένεται.