Dominios y DNS

#Cómo funciona

Para enviar con tu dominio, Postal necesita que publiques algunos registros DNS. Demuestran que el dominio es tuyo y hacen que los correos electrónicos superen las comprobaciones de SPF, DKIM y DMARC de los proveedores, lo que evita la carpeta de spam.

1. Añade el dominio en el panel o con POST /domains. Recomendamos un subdominio solo para correos electrónicos, como mail.lojaexemplo.com.br, si el dominio principal ya envía por otro servicio.
2. Crea los registros que se muestran en tu proveedor de DNS (Registro.br, Cloudflare, Route 53, GoDaddy…).
3. Haz clic en Verificar (o llama a POST /domains/{id}/verify). Postal comprueba los registros por su cuenta durante un máximo de 72 horas y avisa mediante el webhook domain.updated.

#Registros de envío

Ejemplo para lojaexemplo.com.br en la región sa-east-1. Los valores exactos de tu dominio, sobre todo la clave DKIM, están en el panel y en GET /domains/{id}.

Los nombres son relativos al dominio: postal es postal.lojaexemplo.com.br. Algunos proveedores piden el nombre completo y otros lo completan solos; si el panel señala postal.lojaexemplo.com.br.lojaexemplo.com.br, quita el dominio del nombre. El subdominio postal puede ser otro, con custom_return_path al crearlo. Como el SPF queda en el subdominio del Return-Path, el SPF de tu dominio principal no cambia.

#DMARC

Postal no lo exige, pero los grandes proveedores (Gmail, Outlook, Yahoo) exigen DMARC a quien envía volumen. Si tu dominio aún no lo tiene, empieza monitorizando:

Cuando los informes muestren que todo pasa, endurece la política a p=quarantine y después a p=reject. El diagnóstico de entregabilidad de cada correo electrónico avisa cuando falta DMARC.

#Seguimiento de aperturas y clics

Activa open_tracking y click_tracking en el dominio para recibir los eventos email.opened y email.clicked. Por defecto, los enlaces rastreados usan un dominio de la infraestructura de envío. Para usar una dirección tuya, define tracking_subdomain (por ejemplo, links) y crea el registro:

El seguimiento de aperturas depende de imágenes y no es exacto: varios clientes de correo cargan o bloquean las imágenes automáticamente.

#Recepción (MX)

Para recibir correos electrónicos en tu dominio (planes de pago), activa capabilities.receiving y apunta el MX del dominio a Postal:

Después, crea buzones de entrada para las direcciones que quieres recibir.

#Estado de la verificación

Cada registro tiene además su propio status y, cuando algo está mal, un diagnostic que explica el problema (valor distinto, registro duplicado…). Corrige y verifica de nuevo.

#Cuando un registro desaparece

Una vez verificado, el dominio se sigue comprobando a diario, a una hora que cambia de un dominio a otro. Si un registro obligatorio de envío (el DKIM o los del Return-Path) deja de encontrarse:

1. Postal anota la falta y vuelve a comprobar en 5 minutos, para no reaccionar a un fallo momentáneo del DNS. Una consulta que falla nunca cuenta como registro desaparecido.
2. Si la segunda comprobación coincide, el dominio sigue verificado y enviando, pero pasa a incluir records_missing en GET /domains/{id} (con since, deadline_at y los records que faltan). Sale el webhook domain.updated y los miembros del equipo con las notificaciones de dominio activadas reciben un correo electrónico con el registro exacto y el plazo. La comprobación pasa a hacerse cada hora.
3. Si el registro sigue sin aparecer 72 horas después de la primera falta, el dominio pasa a failed (o partially_failed, si queda uno de los obligatorios) y deja de enviar. Postal sigue buscando los registros cada 6 horas.
4. Cuando el registro vuelve, dentro o fuera del plazo, el aviso desaparece y el dominio vuelve a verified por sí solo. Hacer clic en Verificar en un dominio que aún envía solo adelanta la comprobación; en uno que cayó, reinicia la verificación de 72 horas.

Los registros de seguimiento y de recepción no entran en esta regla.

#Regiones

La región define desde dónde salen tus correos electrónicos y dónde se guardan los datos de envío. Por defecto es São Paulo.

#TLS

Con tls: "opportunistic" (predeterminado), Postal usa TLS siempre que el servidor del destinatario lo acepta y entrega sin TLS cuando no lo acepta. Con enforced, el mensaje solo se entrega con TLS.

#Dominio en otra cuenta

Si al añadir el dominio Postal dice que ya está registrado, es porque está en otra cuenta (de un exempleado o de una prueba antigua, por ejemplo). Demuestra que controlas el DNS con una reclamación: crea el registro TXT postal-domain-verification=… y el dominio se transfiere a tu cuenta, con claves DKIM nuevas.