Minilección · Español

Cómo enviar correos automáticos desde tu sitio web

Ejecuta el proyecto de correo con un asistente, envía una confirmación controlada y verifica su llegada al buzón.

Comenzar la lección interactivaLeer los apuntes

¿Para quién es esta lección?

Para quienes quieren que una acción del sitio envíe correo. Se proporciona código servidor y el asistente puede configurarlo; no necesitas crear un servidor de correo.

Antes de empezar

Necesitas tu cuenta Resend, remitente verificado y buzón de prueba. Usa el proyecto completo separado de funciones Netlify y un asistente para configurarlo. Se aplican disponibilidad y condiciones del proveedor. Las respuestas resueltas son ejemplos, no pruebas realizadas en tu cuenta. Sustituye sus observaciones por tus resultados o indica el paso bloqueado.

Tiempo estimado: 21–38 min

Estimaciones con los archivos iniciales y las cuentas y herramientas necesarias ya listas. La configuración, las colas de publicación y las esperas de correo o DNS requieren tiempo adicional. La verificación del remitente y las esperas de entrega son adicionales. Tarifas y límites dependen de la cuenta.

Qué aprenderás

  • Configura remitente y destinatario controlados.
  • Activa un correo real de prueba y examina la entrega.
  • Gestiona peticiones fallidas sin fingir que llegó un mensaje.

Archivos del taller

Paso 1

Elige una acción de correo

Empieza con una confirmación fija y controlada.

Abre el proyecto con el asistente y decide qué evento enviará la confirmación. Usa solo el buzón del propietario configurado; el visitante no debe elegir destinatarios arbitrarios.

Distingue una petición aceptada por el proveedor de un mensaje que llega al buzón.

Un ejemplo concreto

La acción envía un Workshop confirmation fijo al destinatario configurado en el servidor. El visitante aporta un nombre, no un destino arbitrario. La referencia devuelta ayuda a rastrear, pero no demuestra llegada.

Abre este taller completo de correo. Sigue run-locally.txt y explica los valores privados de remitente, destinatario, clave del proveedor y código de práctica. Exclúyelos de archivos públicos. Ayúdame a ejecutar el proyecto y activar solo mi buzón configurado. Examina por separado aceptación y entrega real, incluida una tentativa rechazada.

Resend: enviar correo

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Envía un correo después de una acción web

Una función de servidor convierte una solicitud aceptada en una llamada al proveedor de correo.

El navegador debe solicitar una acción concreta, no conservar tu credencial privilegiada. Aquí envía un nombre a una función, que manda una confirmación en texto plano a tu bandeja configurada.

El ejemplo utiliza Resend. Otro proveedor de correo transaccional puede cumplir la misma función, pero su autenticación, la verificación del remitente y sus eventos de entrega serán distintos. Un buzón que una persona utiliza para recibir mensajes y responder es un servicio separado.

Ejemplo resuelto

La respuesta “accepted” significa que el proveedor aceptó el envío. No demuestra recepción en bandeja. Comprobaremos ese límite por separado.

Resend: enviar correo

Extra implementation exercise

El proveedor devolvió un ID, pero no has comprobado la bandeja. ¿Qué puedes afirmar honestamente?

Mostrar una solución desarrollada

El proveedor aceptó una solicitud con esa referencia. La entrega sigue sin verificarse hasta examinar las pruebas y la bandeja de prueba.

  • Afirma aceptación, no entrega confirmada en bandeja.
  • Conserva una referencia del mensaje para comprobar entrega.

Paso 2

Configura e inicia el proyecto listo

Deja al asistente conectar el servidor.

Sigue run-locally.txt con el asistente. Introduce valores privados con server-env.example.txt, inicia el proyecto completo y abre su URL local real.

Mantén clave y destinatario fijo en el servidor. El código de práctica es distinto de la clave; una vista de archivo no ejecuta el servicio de correo.

Un ejemplo concreto

Los valores del servidor eligen remitente, destinatario y acceso al proveedor. El código separado autoriza esta prueba exclusiva del propietario. Ni un campo oculto ni una vista de archivo configuran ese servidor privado.

Node.js: estado de soporte de versiones

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Configura un remitente de práctica restringido

Mantén credenciales y destinatario de prueba fuera de la carpeta pública.

Lista local: confirma Node y npm, instala o verifica la CLI Netlify y sigue run-locally.txt antes de enviar el formulario. Abrir primero la página estática ayuda con el diseño, pero no prueba la función de servidor.

Lee netlify/functions/mini-mail.mjs. Configura las variables de correo y un LAB_TOKEN impredecible de al menos 24 caracteres en tu alojamiento. MAIL_FROM debe estar autorizado; TEST_RECIPIENT es tu bandeja. No pongas la clave API en public/app.js.

El usuario introduce el código separado del laboratorio; nunca se incluye en la página ni es la clave Resend. La función ignora deliberadamente los destinos aportados por el cliente. Valida un nombre pequeño y crea texto plano. Antes de publicar, añade límites persistentes y revisa cuotas; este laboratorio exclusivo no es un sistema completo contra abusos.

El servidor controla deliberadamente el destino. Una solicitud manipulada puede añadir to='somewhere-else', pero la función construye sus datos y utiliza TEST_RECIPIENT. Así no puede convertirse en un remitente a direcciones arbitrarias; el acceso público aún necesitaría controles persistentes contra abusos.

Para la secuencia local completa, abre run-locally.txt: prepara el entorno privado de la raíz, vincula solo el proyecto de práctica e inicia el proxy de funciones de Netlify. server-env.example.txt enumera variables sin secretos reales. Abrir solo el HTML no ejecuta el servidor.

Ejemplo resuelto

Cambiar la solicitud del navegador no redirige el correo porque el destinatario viene del servidor. Ocultar la dirección en JavaScript no daría esa protección.

const {RESEND_API_KEY, MAIL_FROM, TEST_RECIPIENT} = process.env;
// Send only to TEST_RECIPIENT in this lab.

Node.js: estado de soporte de versiones

Extra implementation exercise

¿Mover la clave a un campo oculto la mantendría privada?

Mostrar una solución desarrollada

No. Los campos ocultos también se entregan al navegador. Mantén la credencial y la llamada al proveedor en el servidor.

  • Reconoce que los valores entregados al navegador se pueden examinar.
  • Traslada el uso privilegiado al entorno del servidor.

Paso 3

Envía una prueba reconocible

Usa la interfaz y relaciona las evidencias.

Activa la confirmación desde la página realmente ejecutada. Guarda su referencia y examina el evento del proveedor y la copia recibida correspondientes.

Si falla, conserva el fallo visible y contexto para reintentar. No arregles un servicio no disponible inventando éxito.

Un ejemplo concreto

Para el nombre ficticio Alex, el texto inicial es «Hello Alex. Your practice request was received.» Compara la copia recibida con esa tentativa, no con otro correo antiguo.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sigue la solicitud y respuesta proporcionadas

El botón envía JSON; el servidor valida y devuelve un estado veraz.

Despliega el proyecto separado o ejecútalo con las herramientas locales del alojamiento. Abrir index.html como archivo no ejecuta el backend. Envía un nombre sintético y examina la respuesta de red.

El servidor devuelve 400 para entrada mal formada, 503 para configuración ausente, 502 para fallo del proveedor y 202 cuando acepta el mensaje. El navegador gestiona el fallo sin fingir que llegó el correo.

Ejemplo resuelto

La interfaz dice “Accepted by the mail provider. Check your test inbox.” (aceptado por el proveedor; comprueba tu bandeja). Coincide con lo que sabe el servidor en ese momento.

Extra implementation exercise

El endpoint devuelve 503. ¿Debes empezar cambiando el color del botón o comprobando el entorno del servidor?

Mostrar una solución desarrollada

Comprueba las variables y el remitente. La apariencia de la interfaz no puede aportar credenciales ausentes.

  • Comprueba primero la configuración de servidor ausente.
  • No trata la solicitud fallida como correo completado.

Paso 4

Investiga un mensaje ausente

Busca el estado de entrega antes de enviar repetidamente.

Usa delivery-record.txt para relacionar referencia, estado, destino y revisión de buzón/spam. Pide ayuda con la etapa fallida.

Un rebote o destino rechazado requiere investigación. Repetir a ciegas puede crear ruido sin arreglar la entrega.

Un ejemplo concreto

Aceptado → rebote → sin copia apunta a entrega. Código rechazado → sin evento proveedor apunta a configuración de acceso. Son observaciones que requieren controles diferentes.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Verifica entrega y fallo

Relaciona un clic, su referencia del proveedor y el mensaje realmente recibido.

Encuentra el mensaje aceptado en la actividad del proveedor y examina su estado. Comprueba después la bandeja configurada, incluido spam. Registra aceptación y copia recibida por separado.

Prueba un nombre vacío con el formulario y JSON mal formado con una solicitud de desarrollo. En una configuración separada y desechable, verifica fallos claros sin credenciales. Nunca compartas cuerpos de respuesta del proveedor que puedan contener datos de cuenta.

Ejemplo resuelto

Un evento de entrega y su mensaje recibido son pruebas más sólidas que un botón verde. Aceptación sin copia recibida es una investigación de entrega pendiente.

Extra implementation exercise

El proveedor registra un rebote para la referencia de prueba. ¿Es mejor repetir inmediatamente el mismo envío?

Mostrar una solución desarrollada

Examina primero el fallo y la configuración del destinatario. Reintenta solo tras identificar qué cambió; repetir envíos idénticos no repara un destino inválido.

  • Investiga el motivo del rebote y el destino.
  • Evita solicitudes repetidas sin cambiar el diagnóstico.

Paso 5

Añade un tema útil al mensaje

Describe el comportamiento y deja implementarlo al asistente.

Pide dos temas: Project y Question, con valores project y question. Incluye el elegido en el cuerpo conservando destinatario fijo y clave privada. Pide ayuda para probar other como valor no admitido sin añadirlo a las opciones autorizadas.

Envía una prueba controlada por opción y revisa el texto recibido. Un tema no admitido y un código incorrecto deben rechazarse sin envío proveedor; comprueba por separado esos casos negativos.

Un ejemplo concreto

La tarea permite Project y Question, guardados como project y question. La selección debe llegar al cuerpo. Other es un valor de rechazo deliberado, no una tercera opción que debas añadir.

Archivos de este paso

Start hereArchivos del taller

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Tu tarea: añadir un detalle significativo de confirmación

Incluye un tema breve sin permitir destinatarios ni HTML arbitrarios.

Añade un campo topic con dos valores permitidos. Valida la lista en el servidor e incluye la elección en el texto plano. Mantén fijo el destinatario en el entorno.

Envía una prueba por valor y otra no admitida. Registra la referencia del proveedor y pruebas reales de entrega.

Edita primero tus archivos iniciales. Después compara select, JSON y lista del servidor línea por línea con la referencia. Es una alternativa completa para comprobar tu trabajo, no otra carpeta que pegar a ciegas en public/.

Ejemplo resuelto

Aceptar solo “project” y “question” permite una revisión más clara que copiar contenido arbitrario a todos los campos del correo.

Encontrarás el desarrollo completo de referencia en reference/assignment-walkthrough.txt. Compara sus pasos con tu resultado; rellena el registro de pruebas con observaciones de tu propio proyecto.

Extra implementation exercise

Amplía la confirmación con tema validado y demuestra solicitudes correctas y rechazadas.

Mostrar una solución desarrollada

La ampliación usa exactamente 'project' y 'question'. Añade select al formulario, incluye topic en JSON y valida esa lista en el servidor antes de llamar al proveedor. La interfaz y función de referencia muestran todos los cambios.

Conserva TEST_RECIPIENT controlado por el servidor aunque una solicitud manipulada aporte otra dirección. Un tema permitido y código válido pueden llegar a aceptación; uno no admitido debe devolver 400 sin llamar al proveedor. Aceptación no es recepción en bandeja.

Envía cada tema desde tu cuenta de prueba, relaciona su referencia con el mensaje recibido y registra honestamente rebotes o estados pendientes. La referencia amplía un laboratorio restringido, no un retransmisor público de correo.

  • El servidor rechaza temas no admitidos y conserva el destinatario fijo.
  • Ambos temas permitidos aparecen en los mensajes recibidos correspondientes.

¿Te resultó útil esta lección?

Deja un me gusta o compártela con alguien a quien pueda servirle.

Sigue aprendiendo

Explora las otras lecciones