E EmDash CMS Everything Guides, use cases, plugins, templates
Español

Configuración de correo electrónico

En esta página

EmDash utiliza correo electrónico para inicio de sesión con enlace mágico, invitaciones de usuario y recuperación de cuenta. Un plugin de proveedor entrega el correo; usted elige y configura el proveedor instalando su plugin.

Esta guía cubre cómo funciona el flujo de correo electrónico, qué obtiene out of the box en desarrollo y cómo conectar un proveedor real para producción.

Cómo funciona la entrega de correo electrónico

Un único plugin de proveedor activo entrega todo el correo saliente. Si no hay ningún proveedor activo, las funciones que necesitan correo electrónico no están disponibles — los enlaces de invitación deben copiarse y compartirse manualmente desde la página de Usuarios.

Puede ver el estado actual en Settings → Email en el administrador: si un proveedor está activo, qué plugin es, y un botón send test email que ejercita todo el flujo.

Desarrollo: Proveedor de consola integrado

En desarrollo (astro dev), EmDash activa automáticamente un proveedor de consola integrado cuando no hay ningún otro proveedor seleccionado. No envía nada — registra cada correo electrónico en la terminal y mantiene los últimos 100 mensajes en memoria.

Esto significa que los enlaces mágicos e invitaciones funcionan out of the box en desarrollo: solicite un enlace mágico, luego copie la URL de su salida de terminal. También puede listar correos electrónicos capturados en el endpoint solo de desarrollo GET /_emdash/api/dev/emails (y eliminarlos con DELETE).

El proveedor de consola es solo para desarrollo y nunca se ejecuta en compilaciones de producción.

Producción: Instalar un plugin de proveedor

Cloudflare Workers

En Cloudflare, use el plugin cloudflareEmail() de @emdash-cms/cloudflare/plugins. Envía a través de Cloudflare Email Sending sobre un binding send_email del Worker, por lo que no necesita cuenta externa ni clave API. La guía de despliegue de Cloudflare le guía a través de la incorporación del dominio remitente, la adición del binding y el registro del plugin.

Node y otras plataformas

La familia de plugins mantenida por la comunidad emdash-smtp cubre SMTP genérico más proveedores alojados, incluyendo Amazon SES, Brevo, Mailgun, Postmark, Resend, SendGrid, Zoho y más.

pnpm add emdash-smtp

La siguiente configuración registra el plugin con EmDash:

import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import { emdashSmtp } from "emdash-smtp";

export default defineConfig({
	integrations: [
		emdash({
			// ...su configuración de base de datos/almacenamiento
			plugins: [emdashSmtp()],
		}),
	],
});

Las credenciales del proveedor se configuran a través de la configuración propia del plugin — consulte su README para la matriz de proveedores y detalles de configuración.

Dónde residen las credenciales del proveedor

Los plugins de proveedor declaran sus claves API y contraseñas como configuraciones de plugin. Ingréselas en la página de configuración del plugin en el administrador; EmDash las almacena en la base de datos junto con otras configuraciones de plugin, y rotar una clave significa pegar el nuevo valor allí. Secrets & Key Management describe el almacenamiento y sus advertencias.

Si un plugin puede leer un secreto de despliegue (wrangler secret put, .env) depende de su formato, así que siga su README. Los plugins en sandbox no pueden acceder a process.env o bindings de plataforma. Un plugin nativo puede leer process.env; no debe usar import.meta.env, que se inserta en tiempo de compilación y hornea el valor de la máquina de compilación en el bundle.

Seleccionar un proveedor y probar

  1. Instale y active el plugin de proveedor, luego abra Settings → Email en el administrador.

  2. Si hay más de un plugin de proveedor instalado, elija el activo allí — solo uno entrega a la vez.

  3. Use Send test email para verificar el flujo completo de extremo a extremo. El resultado muestra errores de entrega directamente, que es la forma más rápida de depurar credenciales.

Resolución de problemas

  • “No email provider is configured” — no hay ningún plugin de proveedor activo. Instale y active uno, luego selecciónelo en Settings → Email.
  • Magic links / invitaciones silenciosamente no disponibles — misma causa. Sin un proveedor, la página de Usuarios aún crea invitaciones, pero debe copiar el enlace de invitación manualmente.
  • Funciona en desarrollo, falla en producción — el desarrollo usa el proveedor de consola integrado, que enmascara un proveedor de producción faltante. Verifique Settings → Email en el sitio desplegado.
  • Los correos electrónicos llegan al spam — configure SPF/DKIM/DMARC para su dominio remitente en su proveedor de correo electrónico; esto es del lado del proveedor, no una configuración de EmDash.

Relacionado