Resolució de problemes de correu electrònic transaccional

Aquest article cobreix els problemes més habituals amb el correu electrònic transaccional de Flexmail —errors d'autenticació, problemes de capacitat de lliurament i errors de l'API o SMTP— i què fer en cada cas.

Errors d'autenticació i configuració

L'API retorna un error 401 No autoritzat

L'ID del vostre compte o el token d'accés personal és incorrecte. Comproveu tots dos acuradament:

  • El nom d'usuari és el vostre ID de compte numèric, no la vostra adreça de correu electrònic.
  • La contrasenya és un token d'accés personal creat a Configuració > API > Tokens d'accés personal, no la vostra contrasenya d'inici de sessió de Flexmail.
  • Assegureu-vos que el token s'ha copiat completament sense espais finals ni salts de línia.
  • Si teniu dubtes, creeu un token nou i torneu-ho a provar.

La connexió SMTP falla o s'esgota el temps

Comproveu el següent:

  • Esteu usant l'amfitrió submission.flexmail.eu, port 587, amb STARTTLS.
  • El vostre servidor o entorn d'allotjament permet connexions de sortida al port 587. Alguns proveïdors d'allotjament compartit bloquegen aquest port; contacteu el vostre allotjament per confirmar-ho.
  • Les vostres credencials SMTP són el nom d'usuari i la contrasenya proporcionats per Flexmail quan van activar el vostre accés SMTP. Aquests estan separats de l'ID del vostre compte i el token d'accés personal, que s'usen únicament per a l'API HTTP.
  • La vostra adreça de remitent està verificada a Flexmail.

L'adreça del remitent no està verificada

Si intenteu enviar des d'una adreça que no està verificada a Flexmail, l'enviament serà rebutjat. Aneu a Configuració > Afegir o eliminar remitents, afegiu l'adreça i feu clic a l'enllaç de verificació del correu electrònic que Flexmail envia.

Problemes de capacitat de lliurament

Els correus electrònics van al correu brossa

La ubicació al correu brossa en el correu electrònic transaccional és gairebé sempre causada per una de tres coses:

  • L'autenticació del correu electrònic no està configurada o és incorrecta. Comproveu que els registres SPF, DKIM i DMARC estan al seu lloc per al vostre domini d'enviament. Fins i tot un registre absent o mal configurat pot causar ubicació al correu brossa. Les instruccions de configuració estan a la documentació de l'API a email-api.flexmail.eu/documentation sota Autenticació de correu electrònic.
  • La reputació de remitent és baixa. Si el vostre domini o IP té un historial de queixes de correu brossa o taxes de rebot altes —de qualsevol plataforma d'enviament, no només de Flexmail— els proveïdors de safata d'entrada poden enrutar el vostre correu electrònic al correu brossa. Vegeu "Entendre la reputació de remitent" per a com avaluar i millorar la reputació.
  • El contingut activa els filtres de correu brossa. Certs patrons de línia d'assumpte, molts enllaços o correus electrònics amb moltes imatges i poc text poden activar els filtres de correu brossa. Feu proves dels vostres correus electrònics transaccionals amb una eina com Mail-Tester (mail-tester.com) per identificar problemes a nivell de contingut.

Els correus electrònics no arriben en absolut

Si l'API retorna una resposta d'èxit però el correu electrònic no arriba:

  • Comproveu els vostres events de webhook (si estan configurats): un event de rebot poc après de l'enviament indica un error de lliurament.
  • Verifiqueu que l'adreça del destinatari existeix i s'ha escrit correctament.
  • Demaneu al destinatari que comprovi la carpeta de correu brossa.
  • Comproveu si el domini del destinatari té una política DMARC estricta: sense DKIM correctament configurat, els vostres correus electrònics podrien ser rebutjats silenciosament.
  • Alguns sistemes de correu electrònic corporatius rebutgen el correu electrònic de remitents nous o amb baixa reputació. Proveu d'enviar a una adreça personal de Gmail o Outlook per descartar el filtratge del costat del destinatari.

Taxa de rebot alta

Una taxa de rebot alta en el correu electrònic transaccional generalment significa que esteu enviant a adreces que no existeixen o que ja no estan actives. Comproveu el vostre procés de recollida d'adreces:

  • Esteu validant el format de l'adreça de correu electrònic en el punt d'entrada?
  • Esteu enviant un correu electrònic de confirmació o verificació abans de confiar en una nova adreça?
  • Esteu eliminant les adreces amb rebot dur del vostre sistema ràpidament?

Important

Continuar enviant a adreces amb rebot dur danya la vostra reputació de remitent amb cada enviament. Configureu el tractament de webhooks per als events de rebot i suprimiu aquelles adreces al vostre sistema de seguida.

Errors de l'API i de la integració

L'API retorna un error 422 o 400

Aquests errors indiquen un problema amb la vostra sol·licitud: un camp obligatori absent, un valor de paràmetre no vàlid o un cos de sol·licitud mal format. Comproveu el missatge d'error al cos de la resposta per a més detalls. La documentació de l'API a email-api.flexmail.eu/documentation enumera tots els paràmetres obligatoris i opcionals per a cada endpoint.

L'API retorna un error 429 Massa sol·licituds

Heu assolit un límit de taxa. La documentació de l'API especifica els límits de taxa per al vostre nivell de subscripció. Afegiu lògica de reintent amb backoff exponencial a la vostra integració per gestionar-ho de manera elegant.

Les variables de plantilla no s'estan substituint

Si el text de marcador de posició apareix literalment al correu electrònic lliurat:

  • Comproveu que esteu passant els valors de les variables correctament a la sol·licitud de l'API. Vegeu la secció Plantilles de la documentació de l'API per a l'estructura exacta dels paràmetres.
  • Comproveu que la sintaxi del marcador de posició a la vostra plantilla coincideix exactament amb el que espera l'API.
  • Assegureu-vos que esteu fent referència a l'ID de plantilla correcte a la vostra crida a l'API.

Els webhooks no arriben

Si el vostre endpoint de webhook no rep events:

  • Confirmeu que el vostre endpoint és accessible públicament a través d'HTTPS.
  • Comproveu que el vostre endpoint retorna una resposta 2xx ràpidament: un endpoint lent o que no respon farà que Flexmail consideri que el lliurament ha fallat.
  • Comproveu els registres del vostre servidor per a les sol·licituds POST entrants per descartar un problema d'enrutament o tallafocs.
  • Verifiqueu que l'URL del vostre endpoint de webhook està registrada correctament a l'API.

Obtenir ajuda

Si heu treballat amb els anteriors i el problema persisteix, contacteu l'equip de suport de Flexmail a support@flexmail.eu. Incloeu el següent al vostre missatge per accelerar el diagnòstic:

  • L'ID del missatge d'un enviament fallat (de la resposta de l'API o dels vostres registres).
  • L'adreça de correu electrònic del destinatari amb la qual heu fet proves.
  • El missatge d'error o el cos de la resposta de l'API, si és aplicable.
  • El resultat d'una eina de comprovació d'autenticació de correu electrònic com MXToolbox o Mail-Tester.

Passos següents

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.