For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /es/docs/web/email.md (or send Accept: text/markdown).
Email y correo
Plantillas transaccionales, herramientas de vista previa y adaptadores de proveedor.
Lea su primer mensaje local y luego habilite la entrega
El correo electrónico transaccional significa un mensaje activado por una acción de la aplicación, como un código de inicio de sesión o el resultado de una tarea. Con el servidor web en ejecución, mantenga EMAIL_PROVIDER=local en apps/web/.env.local.. Complete la configuración de la base de datos, solicite un código de inicio de sesión en /auth, luego abra /mail-preview e inspeccione el último mensaje. Un mensaje local que aparece aquí no es un correo electrónico enviado a su bandeja de entrada externa.
Para enviar mensajes reales, elija un proveedor de correo electrónico, cree su cuenta, verifique un dominio que controle y siga su guía dedicada. Coloque la clave API y la dirección del remitente en apps/web/.env.local, guarde y reinicie el servidor web. Solicite un nuevo código de inicio de sesión y luego verifique tanto el registro de entrega del proveedor como la bandeja de entrada de destino, incluido el spam. La verificación del dominio y la aprobación del remitente pueden llevar tiempo.
Si el mensaje falla, inspeccione el error de entrega y la verificación del remitente antes de realizar la solicitud repetidamente. La ruta /mail-preview es solo de desarrollo y devuelve 404 en producción. Mantenga el alcance de marketing separado de este remitente transaccional para que una campaña de boletín no pueda interrumpir el correo de verificación de la cuenta.
Mantén separada la entrega transaccional
El módulo de correo gestiona mensajes transaccionales del producto, incluida la autenticación y la finalización de tareas. El contacto comercial pertenece a un flujo propio del producto consumidor y debe seguir separado de esta ruta transaccional.
Configura el adaptador de entrega
Usa el adaptador local para pruebas deterministas. Configura el adaptador de producción seleccionado y sus credenciales del servidor antes de habilitar la entrega externa. Nunca coloques secretos del proveedor de correo en la configuración del cliente ni en los registros.
Registra la entrega por separado
El resultado generado y el correo de finalización tienen resultados independientes. Revisa los registros de entrega antes de afirmar que un mensaje se envió correctamente. Prueba un fallo de entrega sin tratarlo como un fallo de generación ni enviar de nuevo el mismo trabajo al modelo.
Configuración y ajustes
EMAIL_PROVIDER=local mantiene la entrega determinista durante el desarrollo. Para la entrega en producción elige uno de los adaptadores configurados — Resend (RESEND_API_KEY), AWS SES (AWS_REGION más las claves de acceso), Postmark, SendGrid, Mailgun, SMTP genérico o Brevo — y verifica que EMAIL_FROM coincide con una identidad de remitente que el proveedor acepta.
Todas las plantillas viven en src/transactional-mail-templates.ts. La ruta /mail-preview solo de desarrollo renderiza cada plantilla para que los cambios se revisen visualmente en lugar de enviando correo.
EMAIL_PROVIDER=resend
EMAIL_FROM=Your Product <[email protected]>Flujo de implementación
Los códigos de autenticación, magic links, invitaciones, avisos de facturación y correos de tarea completada pasan todos por el mismo remitente transaccional con el texto de la locale resuelta. Las campañas de outreach son una preocupación de producto separada y nunca comparten esta ruta.
Previsualiza una plantilla en mail-preview antes de editar texto o layout; mantén los valores de marca (nombre, colores, tiles del logo) viniendo de la configuración para que los productos derivados reestilicen sin forkear plantillas.
Verificación y solución de problemas
Afirma sobre los mensajes registrados del adaptador local en tests — destinatario, asunto y cuerpo renderizado. Un envío fallido debe surgir como un resultado de entrega, no como un workflow roto. Usa la ruta smoke opcional con REAL_SMOKE_EMAIL_ALLOWED_DOMAIN para entrega real.