Correo transaccional

---
name: correo-transaccional
description: que tu correo llegue a la bandeja de entrada y no a spam.
---

# Correo transaccional

Instrucciones para el agente que está construyendo esta app. Sigue esta skill cuando
mandes verificaciones, recuperación de contraseña, invitaciones, avisos o recibos.

## Cuándo usar esta skill

Actívala en cuanto se cumpla cualquiera de estas condiciones:

- Hay cuentas: verificar correo y recuperar contraseña ya son obligatorios.
- Mandas invitaciones, recibos, alertas o resúmenes.
- Algo pasa mientras el usuario no está mirando la pantalla.
- Estás replicando un producto cuyo valor central es enviar correo a mucha gente.

Mandar un correo es una llamada a una API; que llegue es otra cosa. La entregabilidad
depende de dominio propio, SPF, DKIM, DMARC y reputación acumulada, y es exactamente la
parte que no se puede improvisar.

## Cómo construirla

Usa este stack salvo que el proyecto ya tenga otro decidido: **Resend** o **Postmark**
con dominio propio verificado, plantillas en el repo, envío desde una cola.

1. Usa un subdominio dedicado (`mail.tudominio.com`) y verifica SPF, DKIM y DMARC antes
   del primer envío real.
2. Separa transaccional de marketing. Mezclarlos hunde la reputación de tus correos
   importantes.
3. Plantillas con **react-email** o **MJML**, exportadas a HTML con estilos inline y
   versión en texto plano. Nada de CSS moderno: los clientes de correo viven en 2005.
4. Encola los envíos y reintenta con espera creciente. Un correo no debe bloquear la
   respuesta HTTP.
5. Registra el resultado por mensaje (enviado, rebotado, quejado) y deja de escribir a
   direcciones que rebotan duro.
6. Pon un enlace de baja real en todo lo que no sea estrictamente transaccional.

## En qué te vas a trabar

- **La entregabilidad se construye con semanas de envío limpio.** Un dominio nuevo
  empieza sin crédito; no prometas entrega perfecta desde el primer día.
- **Envío masivo desde tu propio servidor SMTP es la manera más rápida de terminar en
  listas negras.** Usa un proveedor con reputación (Resend, Postmark), no tu propio
  servidor.
- **Gmail y Outlook exigen DMARC para remitentes con volumen.** Sin eso, el correo
  simplemente no llega, y no vas a ver un error que lo explique.

## Criterio de terminado

No declares el correo listo hasta que un mensaje de prueba llegue a Gmail y Outlook sin
caer en spam, con SPF, DKIM y DMARC en verde, y hasta que confirmes que un rebote duro
detiene los envíos futuros a esa dirección.