Resend Compartido para Portafolio
Implementa correo electrónico para múltiples productos mediante una sola cuenta de Resend y un dominio verificado. Optimizado para un desarrollador independiente o un portafolio pequeño que usa el nivel gratuito, sin que cada app parezca el mismo producto.
Modelo central
Comparte infraestructura, no la identidad del producto:
Una cuenta de Resend
└── Dominio de remitente verificado existente
├── Identidad de remitente del Producto A
├── Identidad de remitente del Producto B
└── Identidad de remitente del Producto C
Cada app conserva lo suyo:
- nombre visible del remitente
- bandeja de entrada de destino
- enrutamiento de Reply-To
- convenciones de asunto
- plantillas HTML con marca visual y texto plano
- variables de entorno de despliegue
- registros de entrega y comportamiento ante fallos
Todas las apps comparten la cuota de nivel gratuito de la cuenta y la reputación del dominio verificado.
Descubrimiento del portafolio
Antes de la implementación:
- Inspecciona la app de destino y cualquier app hermana que ya tenga una configuración de Resend funcionando.
- Identifica la cuenta de Resend canónica y el dominio ya verificado.
- Confirma el nombre visible del producto, la bandeja de entrada compartida del remitente, el destinatario interno, la bandeja de entrada de soporte para Reply-To y los tipos de correo esperados.
- Confirma si el despliegue de destino ya tiene una clave API de Resend.
- No le pidas al usuario que cree otra cuenta, verifique otro dominio o compre un plan a menos que la cuenta existente no pueda cumplir con un requisito explícito.
Estrategia de cuenta y clave
Reutiliza la misma cuenta de Resend y dominio verificado. Prefiere una clave API separada por app desplegada cuando la cuenta lo permita; esto limita el impacto de una clave filtrada o rotada, manteniéndose en una sola cuenta y cuota. Reutiliza la misma clave solo cuando no haya claves separadas disponibles o el usuario prefiera explícitamente ese compromiso.
Nunca copies secretos de otro repositorio al control de código fuente. Agrega la clave seleccionada directamente al entorno secreto de cada despliegue.
Configuración por producto
Usa variables solo del lado del servidor y nombres específicos del producto cuando sea práctico. Resuelve sus valores a partir de la cuenta de Resend existente del usuario, la configuración de remitente verificado y la bandeja de entrada prevista del producto; nunca copies identidades de ejemplo en una implementación.
| Rol de la variable | Propósito |
|---|---|
| Clave API de Resend | Autentica la llamada al proveedor desde el servidor |
| Identidad de remitente del producto | Combina el nombre visible del producto actual con una dirección en el dominio verificado existente |
| Destinatario de contacto del producto | Recibe las notificaciones internas de este producto |
| Dirección de respuesta del producto | Recibe las respuestas a los mensajes dirigidos al usuario cuando es diferente del destinatario de contacto |
El nombre visible proporciona la identidad del producto; la dirección verificada existente proporciona la capacidad de entrega. Nunca uses una variable NEXT_PUBLIC_ o equivalente expuesta al cliente para una clave API.
Enrutamiento del formulario de contacto
Envía dos mensajes separados:
Notificación interna
De: identidad de remitente configurada del producto
Para: bandeja de entrada interna configurada del producto
Reply-To: dirección validada enviada por el visitante
Confirmación al visitante
De: identidad de remitente configurada del producto
Para: dirección validada enviada por el visitante
Reply-To: bandeja de entrada interna configurada del producto
No pongas al visitante y a la bandeja de entrada interna en una misma lista de destinatarios. Los mensajes separados evitan la exposición de direcciones y permiten contenido diferente.
Trata la notificación interna como entrega principal. Devuelve éxito del formulario solo después de que Resend la acepte y devuelva un ID de mensaje. Intenta la confirmación al visitante después; registra su fallo sin afirmar que la consulta principal se perdió.
Aislamiento de marca
Crea una plantilla distinta para cada producto manteniendo el patrón del módulo de proveedor reutilizable. Personaliza:
- nombre y descriptor del producto
- colores, tipografía y tratamiento del encabezado
- texto de vista previa del correo
- asuntos y tono
- pie de página, dirección de soporte y expectativas de respuesta
Usa diseños de tabla, CSS en línea, un ancho de contenido de 600–640px, valores de usuario escapados y una versión de texto plano. No reutilices la identidad visual de otro producto solo porque la infraestructura de envío es compartida.
Salvaguardas del nivel gratuito compartido
- Revisa los límites actuales del nivel gratuito de Resend en lugar de confiar en números recordados.
- Recuerda que cada app consume la misma cuota de la cuenta.
- Envía solo mensajes transaccionales necesarios; evita notificaciones duplicadas.
- Mantén controles anti-spam en formularios públicos: validación, límites de longitud, honeypot y limitación de velocidad cuando corresponda.
- Evita bucles de reintento que puedan enviar duplicados. Persiste o usa idempotencia donde el flujo de trabajo tenga un riesgo significativo de reintento.
- Monitorea rechazos del proveedor y errores de cuota sin registrar secretos ni datos personales innecesarios.
- Escala a otra cuenta o plan de pago solo cuando el volumen medido, el aislamiento, el cumplimiento normativo o los requisitos de reputación lo justifiquen.
Implementación confiable
- Instala el paquete oficial
resenden el espacio de trabajo correcto. - Mantén las llamadas al proveedor en un módulo solo del lado del servidor.
- Valida
result.data?.idy asegúrate de queresult.erroresté ausente. - Captura excepciones del SDK y de red.
- Establece
replyToexplícitamente. - Devuelve
503cuando el correo no esté configurado y502cuando la entrega principal falle. - Preserva alternativas de contacto directo por correo, teléfono o mensajería en la interfaz de usuario.
- Nunca reportes un manejo solo de registro como una entrega exitosa.
Verificación
- Confirma que el dominio compartido esté verificado en la cuenta de Resend reutilizada.
- Confirma los valores específicos del producto para From, To y Reply-To.
- Prueba la entrega interna, luego la confirmación al visitante, luego responder en ambas direcciones.
- Prueba la validación, el honeypot, la clave faltante, el rechazo del proveedor y las rutas alternativas.
- Ejecuta los comandos de verificación de tipos, lint, prueba y compilación nativos del repositorio.
- Confirma que el despliegue contenga su clave API y variables del producto.
- Realiza un envío real antes de afirmar que la entrega en vivo funciona.