Solución de problemas de SMTP

Usa esta página cuando el SMTP relay rechace un mensaje o tu cliente no consiga conectarse. Los errores se agrupan según la fase de la conversación SMTP en la que se producen, y cada uno indica su causa y su solución.

Encontrar el código de respuesta

• En tu aplicación. Las bibliotecas de correo incluyen la respuesta del servidor en el error, por ejemplo Error: Invalid login: 535 Authentication failed en Nodemailer o SMTPAuthenticationError: (535, b'Authentication failed') en Python.
• En Emailit. Email API›Logs registra cada mensaje enviado con el origen SMTP y su código de respuesta, además de los rechazos por límite de velocidad y los inicios de sesión fallidos de las claves que Emailit puede identificar. Filtra por Status code o por API key.
• Con una prueba manual. Ejecuta el comando cURL de Enviar un mensaje de prueba con -v para ver toda la conversación.

Los códigos que empiezan por 4 son temporales: los clientes bien configurados los reintentan más tarde. Los códigos que empiezan por 5 son permanentes: corrige la causa antes de volver a enviar.

Referencia rápida

Errores de inicio de sesión

Se producen cuando tu cliente envía AUTH.

535 Authentication failed

Causa. La contraseña no es una clave de API válida de ningún espacio de trabajo. Puede que la clave tenga una errata o espacios de más, que se haya eliminado o regenerado, o que sea una clave antigua que ya sustituiste.

Solución. Vuelve a copiar la clave del sitio donde la guardaste al crearla. Emailit solo muestra las claves una vez, así que, si ya no la tienes, crea una clave nueva en Email API›API Keys. Usa emailit como usuario y la clave completa, que empieza por secret_, como contraseña. Consulta ¿Por qué SMTP devuelve 535 Authentication failed?.

454 Temporary authentication failure

Causa. Emailit no ha podido comprobar la clave por un error interno.

Solución. Vuelve a intentarlo al cabo de un momento. Si continúa durante más de unos minutos, consulta status.emailit.com y contacta con soporte.

Errores de límite de velocidad

Se producen cuando tu cliente envía MAIL FROM para empezar un mensaje.

452 4.4.5 Messages per second limit exceeded

Causa. Tu espacio de trabajo ha enviado en el último segundo más mensajes de los que permite su límite por segundo, que por defecto es 2. El límite se comparte con la API y cuenta cada transacción SMTP como un mensaje. Los números entre paréntesis muestran el recuento actual y el límite.

Solución. La mayoría de los clientes reintentan los 452 automáticamente. Para evitarlo, envía a través de una cola con concurrencia limitada, o reutiliza una conexión y envía los mensajes uno tras otro. Si necesitas una velocidad mayor, usa Request Increase en la tarjeta Sending Limits de la página de inicio del panel. Consulta Límites.

452 4.5.3 Daily message limit exceeded

Causa. El espacio de trabajo ha alcanzado su límite diario, que por defecto es de 5000 mensajes y se comparte con la API.

Solución. Los envíos se reanudan después de las 00:00 UTC. Solicita un límite diario mayor desde la tarjeta Sending Limits de la página de inicio del panel. Los espacios de trabajo Pro y Business también reciben aumentos automáticos cuando su salud de envío es buena.

Errores temporales

451 Temporary local error in processing

Causa. Emailit ha sufrido un error interno al procesar el comando. Puede ocurrir en cualquier fase.

Solución. Vuelve a intentarlo más tarde. Los servidores de correo y la mayoría de las bibliotecas lo hacen automáticamente con las respuestas 4xx. Si persiste, contacta con soporte e indica la hora del intento.

Errores de destinatario

Se producen cuando tu cliente envía RCPT TO para cada destinatario.

501 Invalid RCPT TO

Causa. La dirección del destinatario tiene un formato incorrecto, por ejemplo no tiene @ o no hay nada antes o después de la arroba. El mensaje completo es Invalid RCPT TO format o Invalid RCPT TO.

Solución. Valida las direcciones antes de enviar. Comprueba que no haya valores vacíos ni nombres visibles donde solo se espera una dirección.

530 Authentication required

Causa. El cliente no ha iniciado sesión, o el inicio de sesión ha fallado y ha seguido adelante igualmente. Sin iniciar sesión, el relay solo acepta correo para las direcciones de entrada y de rebote propias de Emailit.

Solución. Activa la autenticación SMTP en tu cliente y configura el usuario y la contraseña. Comprueba si hay un 535 anterior en la misma sesión.

535 Mail server has been suspended

Causa. El espacio de trabajo está suspendido, normalmente por una tasa de rebote alta. Consulta Salud de envío.

Solución. Contacta con soporte en support@emailit.com. Los envíos se reanudan cuando se levanta la suspensión.

550 Unverified workspaces can only send to workspace members’ account emails

Causa. El espacio de trabajo está en modo sandbox y el destinatario no es el email de la cuenta de un miembro del espacio de trabajo. El mensaje termina con la dirección bloqueada.

Solución. Haz las pruebas con el email de la cuenta de un miembro o solicita el acceso de producción. Consulta ¿Cómo pruebo los envíos antes de que se verifique mi espacio de trabajo?.

Errores del mensaje

Se producen después de que tu cliente envíe el mensaje con DATA.

552 Message too large (maximum size 40MB)

Causa. El mensaje, con los adjuntos codificados incluidos, ocupa más de 40 MB. La codificación Base64 hace que los adjuntos ocupen aproximadamente un tercio más que los archivos.

Solución. Envía adjuntos más pequeños, o sube los archivos grandes a tu propio almacenamiento e incluye un enlace.

530 From/Sender domain is not verified for this workspace

Causa. Una dirección de la cabecera From no está en un dominio de envío verificado del espacio de trabajo al que pertenece la clave. Motivos habituales: el dominio todavía no está verificado o está pendiente de revisión, la dirección del remitente está en un subdominio que no has añadido, la clave pertenece a otro espacio de trabajo o el mensaje no tiene cabecera From. La dirección del sobre MAIL FROM no influye.

Solución. Comprueba el estado del dominio en Email API›Domains, haz que la dirección del remitente coincida exactamente con un dominio verificado y usa una clave del mismo espacio de trabajo. Consulta ¿Por qué SMTP devuelve 530 From domain not verified?.

530 API key is restricted to sending domain

Causa. La clave es una clave Sending Only limitada a un dominio, y la dirección del remitente está en otro dominio. El mensaje indica el dominio permitido.

Solución. Envía desde el dominio permitido o usa una clave sin limitación de dominio.

550 Sending from this domain is paused

Causa. Emailit ha pausado el dominio del remitente porque su tasa de rebote ha superado el 5 %.

Solución. Encuentra el origen de los rebotes y limpia tu lista. Consulta Salud de envío y Rebotes y quejas.

550 Loop detected

Causa. El mensaje ya ha pasado más de cuatro veces por el relay de Emailit, normalmente porque unas reglas de reenvío lo mandan de un lado a otro.

Solución. Encuentra y rompe el bucle de reenvío entre tus sistemas o buzones.

550 Message processing failed

Causa. Emailit ha aceptado los datos, pero no ha podido almacenar el mensaje.

Solución. Vuelve a enviar el mensaje. Si vuelve a fallar, contacta con soporte e indica la hora del intento y las direcciones From y To.

Errores de correo entrante

452 Insufficient credits to receive inbound email

Causa. Se ha enviado un mensaje a una de tus direcciones de entrada, pero el espacio de trabajo no tiene créditos. Recibir un email cuesta 1 crédito. El servidor remitente recibe este error temporal y lo reintenta más tarde.

Solución. Recarga tus créditos o activa la recarga automática. El correo que el remitente reintente llegará cuando haya créditos disponibles.

Problemas de conexión

Para más detalles, consulta ¿Por qué recibo errores de TLS al conectarme a SMTP?.

Aceptado pero no entregado

Una respuesta 250 significa que Emailit ha aceptado el mensaje, no que haya llegado a la bandeja de entrada. Abre el email en Email API›Emails con el ID de la respuesta y comprueba su estado:

• Held: el espacio de trabajo se ha quedado sin créditos, el dominio se ha pausado o el mensaje ha obtenido una puntuación de 7 o más en las comprobaciones de spam. Corrige la causa y reintenta el envío. Consulta ¿Por qué está retenido mi email?.
• Suppressed: el destinatario está en tu lista de direcciones bloqueadas.
• Attempted: el servidor del destinatario ha devuelto un error temporal. Emailit reintenta durante unas 21 horas.
• Bounced o Failed: los detalles de la entrega muestran la respuesta del servidor receptor. Consulta Rebotes y quejas.

Para una lista de comprobación completa, consulta ¿Por qué no ha llegado mi email?.

¿Sigues teniendo problemas?

Escribe a support@emailit.com o pregunta en Discord. Incluye la hora del intento, el puerto, tu biblioteca de correo y la respuesta completa del servidor.