Relay SMTP

Envía correos por SMTP autenticado sin exponer el proveedor detrás de Publiq — el mismo pipeline de envío y observabilidad que la API HTTP.

Si tu sistema ya habla SMTP —un ERP heredado, una herramienta que solo sabe enviar por smtplib/nodemailer, un script antiguo que preferís no reescribir— no necesitás migrar a la API HTTP para usar Publiq. El relay SMTP es un ingress que acepta conexiones SMTP autenticadas e inyecta cada mensaje en el mismo pipeline de envío que usa emails.send — cola, renderizado, entrega y todos los eventos de observabilidad (sent, delivered, opened, clicked, bounced). Publiq nunca expone qué proveedor de entrega está detrás: para tu cliente SMTP, solo existe smtp.publiq.digital.

No es un relay abierto. Toda conexión debe autenticarse con AUTH — no existe una vía de envío anónimo.

Puertos: 587 (STARTTLS) o 465 (TLS implícito)

El relay escucha en dos puertos, ambos cifrados:

587 — envío con STARTTLS. La conexión empieza en texto plano y hace upgrade a TLS antes del AUTH. Es el puerto por defecto de la mayoría de las bibliotecas SMTP modernas.
465 — TLS implícito. La conexión nace cifrada (TLS desde el handshake inicial), sin paso de upgrade. Preferí este puerto si tu cliente/biblioteca soporta TLS implícito directamente.

Usá el que sea más simple de configurar en tu cliente — el comportamiento de envío es idéntico en ambos.

El AUTH solo se acepta una vez que el canal está cifrado (STARTTLS o TLS implícito). No hay fallback en texto plano — autenticarse antes del TLS es rechazado.

Autenticación

El relay acepta AUTH PLAIN o AUTH LOGIN. El usuario puede ser cualquier valor (no se verifica) — lo que realmente te autentica es la contraseña, que debe ser una API Key de Publiq con alcance send-only. Esto sigue la misma convención de relay SMTP que usan SendGrid y Mailgun, así que si ya integraste con alguno de los dos, la configuración te va a resultar familiar.

Ejemplo de configuración de un cliente SMTP genérico:

Host:      smtp.publiq.digital   (verificá el host exacto en tu panel — smtp.publiq.digital es ilustrativo)
Puerto:    587 (STARTTLS) o 465 (TLS implícito)
Usuario:   cualquier valor (ej.: "publiq")
Contraseña: postly_sk_... (tu API Key con alcance send-only)

El remitente (from) y los destinatarios (to) se leen directamente de los comandos MAIL FROM / RCPT TO del protocolo SMTP, no de los encabezados MIME. Asunto, cuerpo (texto/HTML) y adjuntos vienen del cuerpo del mensaje como es habitual.

Dos restricciones importantes:

Tamaño máximo del mensaje: 25 MB. Los mensajes más grandes se rechazan antes de entrar al pipeline.
La API Key necesita alcance send-only. Las claves con alcance full o read-only se rechazan con error de autenticación (SMTP 535) — el relay no acepta ningún otro alcance.

Ver también

emails.send — el mismo pipeline de envío, con más control (plantillas, variables, idempotencia).
Errores, idempotencia y reintentos — cómo interpretar fallos y evitar envíos duplicados.