MailLandDocs
Envío de emails

SMTP Relay

Envíe correos electrónicos a través del SMTP relay de Mail.Land utilizando protocolos SMTP estándar

MailLand proporciona un SMTP relay para aplicaciones que envían correo electrónico por SMTP. Utilice las mismas credenciales API para autenticarse y enviar a través de puertos SMTP estándar.

Configuración de conexión

ConfiguraciónValor
Hostsmtp.mail.land
Puerto 587Envío con STARTTLS (obligatorio)
AutenticaciónRequerida
UsuarioCualquier valor (por ejemplo, su correo o apikey)
ContraseñaSu clave API de MailLand
Tamaño máximo de mensaje15 MiB (15.728.640 bytes); los mensajes más grandes se rechazan con 552

En producción, solo el puerto 587 (STARTTLS) está publicado para el relay. El puerto 465 (TLS implícito) no está publicado, y el puerto 25 se enruta a la puerta de enlace de entrada independiente, no al relay.

Autenticación

La autenticación SMTP utiliza su clave API de MailLand como contraseña. El nombre de usuario puede ser cualquier valor; MailLand lo ignora y se autentica exclusivamente con la clave API.

Su credencial debe tener el canal Smtp habilitado. Si su credencial solo tiene habilitado Api, la autenticación SMTP será rechazada.

Username: apikey
Password: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

El correo y la contraseña de su cuenta no se aceptan para SMTP. Cree una credencial SMTP en el panel y úsela como contraseña.

Ejemplos de configuración

nodemailer-config.js
const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
  host: 'smtp.mail.land',
  port: 587,
  secure: false, // STARTTLS
  auth: {
    user: 'apikey',
    pass: 'ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...',
  },
});

await transporter.sendMail({
  from: '"Your App" <[email protected]>',
  to: '[email protected]',
  subject: 'Hello from MailLand',
  html: '<h1>Hello!</h1><p>Sent via SMTP relay.</p>',
  text: 'Hello! Sent via SMTP relay.',
});

Aplicación de credenciales

Las mismas reglas de credenciales aplican tanto para SMTP como para la REST API:

  • Flujo: las credenciales transaccionales limitan a 5 destinatarios por mensaje; las credenciales de marketing permiten hasta 1.000 destinatarios por mensaje
  • Alcance de dominio: si la credencial está limitada a dominios específicos, el dominio del remitente debe estar en la lista permitida
  • Lista blanca de IP: si la credencial tiene restricciones de IP, la IP de conexión debe estar permitida
  • Límites de velocidad: se aplican los límites de la credencial por minuto (si está definido), por hora (por defecto 1.000) y por día (por defecto 10.000) antes de los límites del plan del workspace. Superar uno de ellos devuelve un 421 transitorio. El límite por segundo no se aplica hoy
  • Modo: las credenciales sandbox aceptan y registran el correo pero nunca lo entregan, sea cual sea su sandboxBehavior

Límites de conexión por IP

Independientemente de los límites de velocidad de las credenciales, las conexiones SMTP tienen límite de velocidad por dirección IP:

LímiteValor predeterminado
Conexiones por minuto30
Conexiones por hora300

Estos límites se aplican antes de la autenticación. Si se exceden, la conexión es rechazada con un mensaje para reintentar más tarde.

Códigos de respuesta SMTP

CódigoSignificado
250Mensaje aceptado para entrega
421Transitorio: límite de velocidad de la credencial o del workspace, cuota o ritmo de calentamiento excedido. Reintente más tarde; no es un rechazo permanente
451Transitorio: el envío está en pausa por un pico de volumen, una pausa de marketing o una retención de entregabilidad. Mantenga el mensaje en cola y reintente; se acepta en cuanto se levanta la pausa
550Permanente: dominio no verificado, remitente/destinatario bloqueado, verificación requerida, o límite de destinatarios de marketing (1.000 por mensaje) excedido, o todos los destinatarios están suprimidos (5.7.1)
552Permanente: el mensaje excede el tamaño máximo (15 MiB), sus adjuntos superan 10 MiB en total una vez decodificados, o el mensaje ensamblado supera el presupuesto de mensajes de la plataforma (5.3.4)

Manejo de errores

Cuando un mensaje es rechazado, la respuesta SMTP incluye una razón legible. Un rechazo transitorio (reintentable) se ve así:

421 Try again later: rate limit exceeded
421 Try again later: monthly quota exceeded
421 Try again later: credential rate limit exceeded
451 4.7.0 Marketing emails are paused for this account

Un rechazo permanente se ve así:

550 5.7.1 Domain is not verified. Add DNS records at https://app.mail.land

A diferencia de la REST API (que devuelve 202 Accepted y procesa de forma asíncrona), SMTP puede rechazar mensajes de forma síncrona a nivel de conexión por violaciones de dominio, límite de velocidad y cuota.

SMTP vs REST API

CaracterísticaREST APISMTP Relay
ProtocoloHTTPSSMTP
AutenticaciónEncabezado X-API-KeySMTP AUTH (clave como contraseña)
RespuestaAsíncrona (202 Accepted)Síncrona (250 OK o error)
AdjuntosBase64 en JSONMIME estándar
PlantillasCampo templateIdNo soportado (use MIME)
Envío programadoCampo scheduledAtNo soportado
SeguimientoCampo trackingConfigurado por dominio
Variables por destinatarioto[].variablesNo soportado
Envío por lotesEndpoint send-batchNo soportado

Próximos pasos

En esta página