Αντιμετώπιση προβλημάτων transactional email

Αυτό το άρθρο καλύπτει τα πιο συνηθισμένα ζητήματα με το transactional email του Flexmail — σφάλματα επαλήθευσης ταυτότητας, προβλήματα παραδοσιμότητας και αποτυχίες API ή SMTP — και τι να κάνετε για το καθένα.

Σφάλματα επαλήθευσης ταυτότητας και ρύθμισης

Το API επιστρέφει σφάλμα 401 Unauthorized

Το ID λογαριασμού ή το προσωπικό access token σας είναι λάθος. Ελέγξτε τα δύο προσεκτικά:

• Το όνομα χρήστη είναι ο αριθμητικός κωδικός λογαριασμού σας, όχι η διεύθυνση email σας.
• Ο κωδικός πρόσβασης είναι προσωπικό access token δημιουργημένο στις Ρυθμίσεις > API > Personal access tokens, όχι ο κωδικός σύνδεσης Flexmail σας.
• Βεβαιωθείτε ότι το token αντιγράφηκε πλήρως χωρίς τελικά κενά ή αλλαγές γραμμής.
• Εάν αμφιβάλλετε, δημιουργήστε νέο token και δοκιμάστε ξανά.

Η σύνδεση SMTP αποτυγχάνει ή λήγει

Ελέγξτε τα εξής:

• Χρησιμοποιείτε host submission.flexmail.eu, θύρα 587, με STARTTLS.
• Ο διακομιστής ή το περιβάλλον hosting σας επιτρέπει εξερχόμενες συνδέσεις στη θύρα 587. Ορισμένοι πάροχοι κοινόχρηστου hosting αποκλείουν αυτή τη θύρα — επικοινωνήστε με τον host σας για επιβεβαίωση.
• Τα διαπιστευτήρια SMTP σας είναι το όνομα χρήστη και ο κωδικός πρόσβασης που παρείχε το Flexmail όταν ενεργοποίησε την πρόσβαση SMTP σας. Είναι ξεχωριστά από το ID λογαριασμού και το προσωπικό access token, που χρησιμοποιούνται μόνο για το HTTP API.
• Η διεύθυνση αποστολέα σας είναι επαληθευμένη στο Flexmail.

Η διεύθυνση αποστολέα δεν είναι επαληθευμένη

Εάν προσπαθήσετε να αποστείλετε από διεύθυνση που δεν είναι επαληθευμένη στο Flexmail, η αποστολή θα απορριφθεί. Μεταβείτε στις Ρυθμίσεις > Προσθήκη ή αφαίρεση αποστολέων, προσθέστε τη διεύθυνση και κάντε κλικ στον σύνδεσμο επαλήθευσης στο email που αποστέλλει το Flexmail.

Προβλήματα παραδοσιμότητας

Τα emails πηγαίνουν σε spam

Η τοποθέτηση σε spam για transactional email προκαλείται σχεδόν πάντα από ένα από τρία πράγματα:

• Η επαλήθευση ταυτότητας email δεν έχει διαμορφωθεί ή είναι εσφαλμένη. Ελέγξτε ότι οι εγγραφές SPF, DKIM και DMARC υπάρχουν για το domain αποστολής σας. Ακόμα και μία ελλείπουσα ή λανθασμένα διαμορφωμένη εγγραφή μπορεί να προκαλέσει τοποθέτηση σε spam. Οδηγίες διαμόρφωσης βρίσκονται στην τεκμηρίωση API στο email-api.flexmail.eu/documentation στην ενότητα Επαλήθευση ταυτότητας email.
• Η φήμη αποστολέα είναι χαμηλή. Εάν το domain ή η IP σας έχει ιστορικό παραπόνων spam ή υψηλά ποσοστά αναπήδησης — από οποιαδήποτε πλατφόρμα αποστολής, όχι μόνο από το Flexmail — οι πάροχοι inbox μπορεί να δρομολογήσουν το email σας στο spam. Δείτε "Κατανόηση φήμης αποστολέα" για αξιολόγηση και βελτίωση φήμης.
• Το περιεχόμενο ενεργοποιεί spam filters. Ορισμένα μοτίβα γραμμής θέματος, υπερβολικοί σύνδεσμοι ή emails με πολλές εικόνες και λίγο κείμενο μπορεί να ενεργοποιήσουν spam filters. Δοκιμάστε τα transactional emails σας με εργαλείο όπως το Mail-Tester (mail-tester.com) για εντοπισμό ζητημάτων σε επίπεδο περιεχομένου.

Τα emails δεν φτάνουν καθόλου

Εάν το API επιστρέφει επιτυχές response αλλά το email δεν φτάνει:

• Ελέγξτε τα συμβάντα webhook (εάν έχουν διαμορφωθεί) — ένα συμβάν αναπήδησης λίγο μετά την αποστολή υποδηλώνει αποτυχία παράδοσης.
• Επαληθεύστε ότι η διεύθυνση παραλήπτη υπάρχει και είναι σωστά γραμμένη.
• Ζητήστε από τον παραλήπτη να ελέγξει τον φάκελο spam.
• Ελέγξτε εάν το domain του παραλήπτη έχει αυστηρή πολιτική DMARC — χωρίς σωστά διαμορφωμένο DKIM, τα emails σας μπορεί να απορρίπτονται χωρίς ειδοποίηση.
• Ορισμένα εταιρικά συστήματα email απορρίπτουν email από νέους ή χαμηλής φήμης αποστολείς. Δοκιμάστε να αποστείλετε σε προσωπική διεύθυνση Gmail ή Outlook για αποκλεισμό φιλτραρίσματος από την πλευρά του παραλήπτη.

Υψηλό ποσοστό αναπήδησης

Υψηλό ποσοστό αναπήδησης σε transactional email συνήθως σημαίνει ότι αποστέλλετε σε διευθύνσεις που δεν υπάρχουν ή δεν είναι πλέον ενεργές. Ελέγξτε τη διαδικασία συλλογής διευθύνσεων:

• Επαληθεύετε τη μορφή διεύθυνσης email κατά την εισαγωγή;
• Αποστέλλετε email επιβεβαίωσης ή επαλήθευσης πριν εμπιστευτείτε νέα διεύθυνση;
• Αφαιρείτε αμέσως τις διευθύνσεις hard bounce από το σύστημά σας;

Σημαντικό

Η συνέχιση αποστολής σε διευθύνσεις hard bounce βλάπτει τη φήμη αποστολέα σας με κάθε αποστολή. Ρυθμίστε διαχείριση webhook για συμβάντα αναπήδησης και αποκλείστε αυτές τις διευθύνσεις στο σύστημά σας αμέσως.

Σφάλματα API και ενσωμάτωσης

Το API επιστρέφει σφάλμα 422 ή 400

Αυτά τα σφάλματα υποδηλώνουν πρόβλημα με το αίτημά σας — ελλείπον απαιτούμενο πεδίο, μη έγκυρη τιμή παραμέτρου ή κακοσχηματισμένο σώμα αιτήματος. Ελέγξτε το μήνυμα σφάλματος στο σώμα response για λεπτομέρειες. Η τεκμηρίωση API στο email-api.flexmail.eu/documentation παραθέτει όλες τις απαιτούμενες και προαιρετικές παραμέτρους για κάθε endpoint.

Το API επιστρέφει σφάλμα 429 Too Many Requests

Έχετε χτυπήσει όριο ρυθμού. Η τεκμηρίωση API καθορίζει τα όρια ρυθμού για το επίπεδο συνδρομής σας. Προσθέστε λογική επανάληψης με εκθετική καθυστέρηση στην ενσωμάτωσή σας για χειρισμό αυτού με χάρη.

Οι μεταβλητές προτύπου δεν αντικαθίστανται

Εάν το κείμενο placeholder εμφανίζεται κυριολεκτικά στο παραδοθέν email:

• Ελέγξτε ότι μεταβιβάζετε τις τιμές μεταβλητής σωστά στο αίτημα API. Δείτε την ενότητα Πρότυπα της τεκμηρίωσης API για την ακριβή δομή παραμέτρων.
• Ελέγξτε ότι η σύνταξη placeholder στο πρότυπό σας ταιριάζει ακριβώς με αυτό που αναμένει το API.
• Βεβαιωθείτε ότι αναφέρεστε στο σωστό ID προτύπου στην κλήση API σας.

Τα webhooks δεν φτάνουν

Εάν το endpoint webhook σας δεν λαμβάνει συμβάντα:

• Επιβεβαιώστε ότι το endpoint σας είναι δημόσια προσβάσιμο μέσω HTTPS.
• Ελέγξτε ότι το endpoint σας επιστρέφει γρήγορα response 2xx — αργό ή μη ανταποκρινόμενο endpoint θα κάνει το Flexmail να θεωρήσει ότι η παράδοση απέτυχε.
• Ελέγξτε τα αρχεία καταγραφής διακομιστή σας για εισερχόμενα αιτήματα POST για αποκλεισμό ζητήματος δρομολόγησης ή firewall.
• Επαληθεύστε ότι η URL endpoint webhook σας είναι καταχωρημένη σωστά στο API.

Λήψη βοήθειας

Εάν έχετε εργαστεί μέσα από τα παραπάνω και το ζήτημα παραμένει, επικοινωνήστε με την ομάδα υποστήριξης Flexmail στο support@flexmail.eu. Συμπεριλάβετε τα εξής στο μήνυμά σας για ταχύτερη διάγνωση:

• Το message ID μιας αποτυχημένης αποστολής (από το API response ή τα αρχεία καταγραφής σας).
• Τη διεύθυνση email παραλήπτη με την οποία δοκιμάσατε.
• Το μήνυμα σφάλματος ή σώμα response από το API, εάν ισχύει.
• Το αποτέλεσμα εργαλείου ελέγχου επαλήθευσης ταυτότητας email όπως MXToolbox ή Mail-Tester.

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

• Δείτε "Ξεκινώντας με το transactional API" για τη σωστή σειρά ρύθμισης.
• Δείτε "Κατανόηση φήμης αποστολέα" για αξιολόγηση και προστασία φήμης αποστολής.
• Ανατρέξτε στην τεκμηρίωση API στο email-api.flexmail.eu/documentation για κωδικούς σφαλμάτων και λεπτομέρειες ορίων ρυθμού.