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

Minilección 9 de 30 · Hacer útil tu sitio web

Elige una acción de correo

¿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.

Empieza con una confirmación fija y controlada.

Propósito de esta lección

  • Configura remitente y destinatario controlados.
  • Activa un correo real de prueba y examina la entrega.
  • Gestiona peticiones fallidas sin fingir que llegó un mensaje.
Explicación, ejemplo resuelto y práctica

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.

Comprueba tus habilidades iniciales

Son habilidades útiles, no cursos obligatorios bloqueados. Si ya las tienes, empieza aquí; si no, abre la preparación. Los archivos incluidos evitan necesitar un sitio personal previo.

  1. Cómo publicar tu sitio web desde GitHub

    Conecta un repositorio de práctica al alojamiento.

  2. Cómo configurar correo en tu propio dominio

    Elige y configura un buzón bidireccional real.

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.

Comprende la idea

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.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Qué activará el test y dónde verificarás aceptación y llegada?

Mostrar una solución desarrollada

Ejemplo de plan: Introduciré el código de práctica y el nombre ficticio Alex, y activaré Request test email. TEST_RECIPIENT del servidor es mi buzón controlado. Relacionaré la referencia devuelta con su evento y el correo que llegue.

Qué incluye una respuesta adecuada

  • Identifica la acción concreta controlada y el destino configurado en el servidor.
  • Distingue aceptación del proveedor y llegada real al buzón como puntos de comprobación.
Cómo funciona (opcional)

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

Ejercicio técnico adicional

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 1 · Cómo enviar correos automáticos desde tu sitio web

Configura e inicia el proyecto listo

Deja al asistente conectar el servidor.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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.

Archivos de este paso

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Se inició el proyecto y qué paso está completo o bloqueado?

Mostrar una solución desarrollada

Ejemplo de preparación: El proxy local arrancó y mostró la URL. El entorno privado contiene remitente verificado, destinatario controlado, clave y código generado por separado. Solo ese código entra en el formulario. Mail not configured indica que la configuración privada de remitente/clave/destinatario sigue incompleta.

Qué incluye una respuesta adecuada

  • Describe si el proyecto completo con servidor arrancó en la URL indicada.
  • Distingue la clave privada y el destinatario fijo del código de práctica independiente.
Cómo funciona (opcional)

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

Ejercicio técnico adicional

¿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 2 · Cómo enviar correos automáticos desde tu sitio web

Envía una prueba reconocible

Usa la interfaz y relaciona las evidencias.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Qué mostraron página, proveedor y buzón en tu intento?

Mostrar una solución desarrollada

Ejemplo de intento: La página anunció aceptación con referencia. Existe el evento correspondiente. Mi buzón contiene Workshop confirmation con «Hello Alex. Your practice request was received.» Si faltara, anotaría aceptado, pero entrega sin resolver.

Qué incluye una respuesta adecuada

  • Relaciona página, evento proveedor y buzón real para la misma tentativa.
  • Identifica el fallo sin convertir un error o ID aceptado en prueba de entrega.
Cómo funciona (opcional)

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.

Ejercicio técnico adicional

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 3 · Cómo enviar correos automáticos desde tu sitio web

Investiga un mensaje ausente

Busca el estado de entrega antes de enviar repetidamente.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

¿Qué estado observado explica la siguiente acción de tu prueba?

Mostrar una solución desarrollada

Ejemplo de diagnóstico: El proveedor aceptó el intento, pero ahora registra rebote y el buzón no tiene copia. Revisaré destino y evento antes de otro envío. Es distinto de un código rechazado, que nunca debería llegar al proveedor de correo.

Qué incluye una respuesta adecuada

  • Usa el estado proveedor correspondiente y las comprobaciones de destino/buzón para diagnosticar la entrega.
  • Elige la siguiente acción en la etapa fallida observada, en lugar de reenviar a ciegas.
Cómo funciona (opcional)

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.

Ejercicio técnico adicional

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 4 · Cómo enviar correos automáticos desde tu sitio web

Añade un tema útil al mensaje

Describe el comportamiento y deja implementarlo al asistente.

Explicación, ejemplo resuelto y práctica

Comprende la idea

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

Empieza aquíArchivos del taller

Abre o descarga los archivos de abajo. Al guardar el proyecto, conserva las rutas que aparecen en sus nombres.

Pruébalo

Entrega el cambio de tema y resultados reales de éxito y rechazo.

Qué debes entregar: La acción de prueba funcional y un registro de proveedor/buzón/errores sin datos sensibles.

Mostrar una solución desarrollada

Ejemplo de ampliación: Project produjo «Hello Alex. Your project request was received.» Question produjo su texto correspondiente en otro correo controlado. other y el código incorrecto se rechazaron sin envío proveedor. Ambas opciones válidas siguen usando el destinatario fijo.

Qué incluye una respuesta adecuada

  • Añade exactamente Project/Question y verifica el valor elegido en el contenido recibido.
  • Comprueba que tema no admitido y código incorrecto no envíen mensajes.
Cómo funciona (opcional)

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.

Ejercicio técnico adicional

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.