Resolución de problemas del correo electrónico transaccional

Este artículo cubre los problemas más comunes con el correo electrónico transaccional de Flexmail —errores de autenticación, problemas de entregabilidad y fallos de API o SMTP— y qué hacer en cada caso.

Errores de autenticación y configuración

La API devuelve un error 401 Unauthorized

Su ID de cuenta o su token de acceso personal es incorrecto. Compruebe ambos con detenimiento:

  • El nombre de usuario es su ID de cuenta numérico, no su dirección de correo electrónico.
  • La contraseña es un token de acceso personal creado en Ajustes > API > Tokens de acceso personal, no su contraseña de acceso a Flexmail.
  • Asegúrese de que el token se copió íntegramente, sin espacios al final ni saltos de línea.
  • En caso de duda, cree un nuevo token y vuelva a intentarlo.

La conexión SMTP falla o agota el tiempo de espera

Compruebe lo siguiente:

  • Está usando el host submission.flexmail.eu, el puerto 587, con STARTTLS.
  • Su servidor o entorno de alojamiento permite conexiones salientes en el puerto 587. Algunos proveedores de alojamiento compartido bloquean este puerto: póngase en contacto con su proveedor para confirmarlo.
  • Sus credenciales SMTP son el nombre de usuario y la contraseña que Flexmail le proporcionó cuando activó su acceso SMTP. Estas son distintas de su ID de cuenta y su token de acceso personal, que se usan solo para la API HTTP.
  • Su dirección de remitente está verificada en Flexmail.

Dirección de remitente no verificada

Si intenta enviar desde una dirección que no está verificada en Flexmail, el envío será rechazado. Vaya a Ajustes > Añadir o eliminar remitentes, añada la dirección y haga clic en el enlace de verificación del correo que Flexmail le envía.

Problemas de entregabilidad

Los correos van a la carpeta de spam

La llegada al spam en el correo transaccional se debe casi siempre a una de estas tres causas:

  • La autenticación del correo no está configurada o es incorrecta. Compruebe que los registros SPF, DKIM y DMARC están en vigor para su dominio de envío. Incluso un registro faltante o mal configurado puede causar problemas de spam. Las instrucciones de configuración están en la documentación de la API en email-api.flexmail.eu/documentation, en la sección de autenticación de correo electrónico.
  • La reputación del remitente es baja. Si su dominio o IP tiene un historial de quejas de spam o altas tasas de rebote —desde cualquier plataforma de envío, no solo Flexmail— los proveedores de bandeja de entrada pueden enrutar su correo a spam. Consulte «Comprender la reputación del remitente» para saber cómo evaluar y mejorar la reputación.
  • El contenido activa filtros de spam. Ciertos patrones en el asunto, exceso de enlaces o correos con muchas imágenes y poco texto pueden activar filtros de spam. Pruebe sus correos transaccionales con una herramienta como Mail-Tester (mail-tester.com) para identificar problemas a nivel de contenido.

Los correos no llegan en absoluto

Si la API devuelve una respuesta de éxito pero el correo no llega:

  • Compruebe los eventos de su webhook (si está configurado): un evento de rebote poco después del envío indica un fallo de entrega.
  • Verifique que la dirección del destinatario existe y está escrita correctamente.
  • Pida al destinatario que revise su carpeta de spam.
  • Compruebe si el dominio del destinatario tiene una política DMARC estricta: sin DKIM correctamente configurado, sus correos podrían ser rechazados silenciosamente.
  • Algunos sistemas de correo corporativos rechazan el correo de remitentes nuevos o con baja reputación. Intente enviar a una dirección personal de Gmail o Outlook para descartar el filtrado en el lado del destinatario.

Tasa de rebote alta

Una tasa de rebote alta en el correo transaccional suele significar que está enviando a direcciones que no existen o que ya no están activas. Revise su proceso de recopilación de direcciones:

  • ¿Valida el formato de la dirección de correo en el punto de entrada?
  • ¿Envía un correo de confirmación o verificación antes de confiar en una nueva dirección?
  • ¿Elimina con rapidez las direcciones con rebote duro de su sistema?

Importante

Seguir enviando a direcciones con rebote duro daña su reputación como remitente con cada envío. Configure el manejo de webhooks para eventos de rebote y suprima esas direcciones en su sistema de inmediato.

Errores de API e integración

La API devuelve un error 422 o 400

Estos errores indican un problema con su solicitud: un campo obligatorio faltante, un valor de parámetro no válido o un cuerpo de solicitud malformado. Compruebe el mensaje de error en el cuerpo de la respuesta para obtener detalles. La documentación de la API en email-api.flexmail.eu/documentation lista todos los parámetros obligatorios y opcionales para cada endpoint.

La API devuelve un error 429 Too Many Requests

Ha superado un límite de solicitudes. La documentación de la API especifica los límites de solicitudes para su nivel de suscripción. Añada lógica de reintento con retroceso exponencial a su integración para gestionarlo correctamente.

Las variables de plantilla no se reemplazan

Si el texto del marcador de posición aparece literalmente en el correo entregado:

  • Compruebe que está pasando los valores de las variables correctamente en la solicitud de API. Consulte la sección de Plantillas de la documentación de la API para conocer la estructura exacta de los parámetros.
  • Compruebe que la sintaxis del marcador de posición en su plantilla coincide exactamente con lo que espera la API.
  • Asegúrese de que está referenciando el ID de plantilla correcto en su llamada a la API.

Los webhooks no llegan

Si su endpoint de webhook no recibe eventos:

  • Confirme que su endpoint es accesible públicamente a través de HTTPS.
  • Compruebe que su endpoint devuelve una respuesta 2xx rápidamente: un endpoint lento o sin respuesta hará que Flexmail considere que la entrega ha fallado.
  • Compruebe los registros de su servidor en busca de solicitudes POST entrantes para descartar un problema de enrutamiento o de cortafuegos.
  • Verifique que la URL de su endpoint de webhook está registrada correctamente en la API.

Obtener ayuda

Si ha seguido todos los pasos anteriores y el problema persiste, póngase en contacto con el equipo de soporte de Flexmail en support@flexmail.eu. Incluya lo siguiente en su mensaje para agilizar el diagnóstico:

  • El ID del mensaje de un envío fallido (de la respuesta de la API o sus registros).
  • La dirección de correo electrónico del destinatario con el que realizó la prueba.
  • El mensaje de error o el cuerpo de la respuesta de la API, si procede.
  • El resultado de una herramienta de verificación de autenticación de correo como MXToolbox o Mail-Tester.

Próximos pasos

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