
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.
¿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.
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.Archivos de este paso
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.
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.
Error habitual
Mostrar “Delivered” (entregado) justo tras una llamada API correcta.
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
Pruébalo
¿Se inició el proyecto y qué paso está completo o bloqueado?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
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.
Error habitual
Suponer secreto un valor porque la página no lo muestra.
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.
Pruébalo
¿Qué mostraron página, proveedor y buzón en tu intento?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
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.
Error habitual
Probar un backend abriendo solo su archivo HTML.
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.
Pruébalo
¿Qué estado observado explica la siguiente acción de tu prueba?
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
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.
Error habitual
Depurar HTML cuando la solicitud llegó al proveedor y falló después.
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.
Pruébalo
Materiales para empezar
Los archivos y contenidos de prueba están incluidos. La verificación real requiere tu propia cuenta, buzón o dominio, según los requisitos. Puedes inspeccionar localmente; registra los pasos reales como no probados hasta ejecutarlos.
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.
Comenta tu respuesta con el tutor
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.
- 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.
Archivos de este paso
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- netlify/functions/mini-mail.mjsDescargar este archivo
- delivery-record.txtDescargar este archivo
- worksheet.htmlDescargar este archivo
- reference/assignment-walkthrough.txtDescargar este archivo
- reference/START-HERE.txtDescargar este archivo
- reference/public/index.htmlDescargar este archivo
- reference/public/app.jsDescargar este archivo
- reference/netlify/functions/mini-mail.mjsDescargar este archivo
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.
Error habitual
Confiar en select como único límite de validación.
¿Te resultó útil esta lección?
Deja un me gusta o compártela con alguien a quien pueda servirle.
Sigue aprendiendo
- Cómo crear tu primer sitio web personal
- Cómo publicar tu sitio web desde GitHub
- Cómo conectar un dominio propio a tu sitio web
- Cómo configurar correo en tu propio dominio
- Cómo hacer que tu sitio web se pueda utilizar en teléfonos
- Cómo acelerar la carga de imágenes de tu sitio web
- Cómo recibir los comentarios de tu sitio web en tu bandeja de entrada
- Cómo añadir suscripciones por correo a tu sitio
- Cómo guardar envíos de formularios en una base de datos
- Cómo permitir que las personas inicien sesión en tu sitio web
- Cómo mantener privada una página
- Cómo permitir que los usuarios editen su perfil
- Cómo permitir que los usuarios suban imágenes
- Cómo mantener las claves de API fuera del frontend
- Cómo mostrar datos de una API externa en tu sitio web
- Cómo añadir un chatbot de IA a tu sitio web
- Cómo hacer que un chatbot responda desde tu contenido
- Cómo añadir un blog a tu sitio web
- Cómo añadir búsqueda a tu sitio web
- Cómo añadir otro idioma a tu sitio web
- Cómo ayudar a Google a encontrar tu sitio web
- Cómo corregir la vista previa de tu sitio al compartir un enlace
- Cómo medir visitas y acciones útiles en tu sitio web
- Cómo permitir que los visitantes reserven una cita
- Cómo aceptar un pago en tu sitio web
- Cómo previsualizar cambios de tu sitio antes de publicarlos
- Cómo revertir un despliegue defectuoso de tu sitio web
- Cómo hacer copias de seguridad y restaurar los datos de tu sitio
- Cómo encontrar y corregir errores en tu sitio publicado