¿Cómo enviar correos desde una app Node.js con Nodemailer y SMTP?

Receta en Node.js para enviar correos con Nodemailer por SMTP desde el servidor: código, puertos 587 y 465, buenas prácticas contra el spam, errores típicos y cuándo usar el buzón incluido en Dongee Live o MailChannels.

Para enviar correos desde una app Node.js, instala Nodemailer, crea un transporte SMTP con host, puerto, usuario y contraseña leídos de variables de entorno, y llama a sendMail desde el servidor. Usa el puerto 587 con secure: false (STARTTLS) o el 465 con secure: true (TLS). Además, el remitente debe ser una dirección de tu dominio con SPF, DKIM y DMARC bien configurados.

Qué necesitas antes de empezar

Necesitas un proyecto Node.js con módulos ES ("type": "module" en tu package.json) y los datos de una cuenta SMTP: servidor, puerto, usuario y contraseña. Si quieres repasar cómo viaja un correo entre servidores, lee qué es SMTP y cómo funciona. Para entender por qué SMTP sirve para enviar y no para leer el buzón, consulta la diferencia entre SMTP, POP e IMAP.

Receta paso a paso con Nodemailer

1. Instala la librería

npm install nodemailer express

2. Define las variables de entorno

Los nombres siguientes son solo de ejemplo; puedes usar otros siempre que coincidan con tu código:

SMTP_HOST=mail.tudominio.com
SMTP_PORT=587
SMTP_USER=contacto@tudominio.com
SMTP_PASS=tu-contraseña
MAIL_FROM=contacto@tudominio.com

Este archivo no se sube al repositorio. En producción, estos valores se configuran como variables de entorno del servidor.

3. Crea el transporte y verifica la conexión

// mailer.js
import nodemailer from 'nodemailer';

const port = Number(process.env.SMTP_PORT);

export const transporter = nodemailer.createTransport({
  host: process.env.SMTP_HOST,
  port,
  secure: port === 465, // 465 = TLS directo; 587 = STARTTLS
  auth: {
    user: process.env.SMTP_USER,
    pass: process.env.SMTP_PASS,
  },
});

export async function probarSmtp() {
  try {
    await transporter.verify();
    console.log('Conexión SMTP correcta');
  } catch (err) {
    console.error('Error SMTP:', err.message);
  }
}

transporter.verify() se conecta al servidor e intenta autenticarse sin enviar ningún correo. Úsalo al arrancar la app o en una prueba para detectar errores de configuración pronto.

4. Envía el correo desde una ruta Express

// server.js
import express from 'express';
import { transporter, probarSmtp } from './mailer.js';

const app = express();
app.use(express.json());

app.post('/contacto', async (req, res) => {
  const { nombre, email, mensaje } = req.body;
  if (!email || !mensaje) {
    return res.status(400).json({ ok: false, error: 'Faltan datos' });
  }

  try {
    await transporter.sendMail({
      from: process.env.MAIL_FROM,
      to: process.env.MAIL_FROM,
      replyTo: email,
      subject: `Nuevo mensaje de ${nombre || 'contacto web'}`,
      text: `De: ${email}\n\n${mensaje}`,
      html: '<p>Tienes un nuevo mensaje desde el formulario de contacto.</p>',
    });
    res.json({ ok: true });
  } catch (err) {
    console.error('No se pudo enviar:', err.message);
    res.status(500).json({ ok: false, error: 'No se pudo enviar el mensaje' });
  }
});

app.listen(process.env.PORT || 3000, probarSmtp);

El formulario del navegador solo hace un fetch a POST /contacto. La conexión SMTP y la contraseña se quedan siempre en el servidor y nunca llegan al frontend.

Buenas prácticas

  • Remitente de tu dominio: el campo from debe ser una dirección de tu dominio. Si quieres responder a quien escribió, pon su dirección en replyTo y no en from.
  • SPF, DKIM y DMARC: SPF indica qué servidores pueden enviar en nombre de tu dominio, DKIM firma cada mensaje y DMARC les dice a los receptores qué hacer si algo no cuadra. Sin estos registros, tus correos pueden ir a spam.
  • Credenciales fuera del código: nunca escribas la contraseña SMTP en el código, en el repositorio ni en variables que acaben en el frontend.
  • Errores controlados: envuelve el envío en try/catch, registra el error y responde al usuario. No reintentes en bucle, porque un fallo de autenticación repetido puede bloquear la cuenta.
  • Valida la entrada: revisa los campos del formulario antes de enviar y no metas texto del usuario sin escapar dentro del HTML del correo.

Errores típicos y cómo resolverlos

SíntomaCausa probableSolución
Timeout o error de TLS al conectarPuerto y secure mal combinados587 con secure: false; 465 con secure: true
Error de autenticaciónUsuario o contraseña incorrectosUsa la dirección completa como usuario y revisa la variable de la contraseña
El correo llega a spamFaltan SPF, DKIM o DMARC, o el from no es de tu dominioConfigura los registros del dominio y envía desde una dirección propia

Desde Dongee Live

Dongee Live publica apps Node.js (Express, Fastify, Koa, Hono, Next.js y otros) hechas con Claude Code, Cursor, Codex, Lovable, Bolt o v0. Desde Live, el SMTP de salida funciona por los puertos 587 y 465, así que esta receta sirve tal cual. Defines las variables de entorno de tu app, también en Live Gratis, y Live mantiene la app en ejecución con HTTPS.

El buzón que incluye tu plan de Live es una cuenta de correo normal con los límites de envío habituales. Sirve para bajo volumen, como un formulario de contacto o avisos puntuales. Si tu app envía correo transaccional a muchos usuarios (confirmaciones de registro, restablecimiento de contraseña), conviene usar MailChannels, que se contrata aparte y funciona desde Live. Si quieres saber cómo funciona este tipo de envío, lee qué es un SMTP relay.

Comparación honesta: buzón incluido o servicio transaccional

CriterioBuzón incluido en LiveServicio transaccional (MailChannels)
CostoIncluido en el planSe contrata aparte
VolumenBajo, con límites normales de una cuentaPensado para envíos frecuentes de la app
Casos de usoFormulario de contacto, avisos puntualesConfirmaciones, restablecer contraseña, notificaciones a muchos usuarios
Campañas masivasNoNo: Live no está pensado para campañas masivas

Cuándo no te conviene Dongee Live: si tu objetivo es enviar campañas de email marketing masivas, Live no está pensado para eso. Tampoco sirve si tu backend está en Python, PHP o Docker. PHP y WordPress van en el hosting cPanel de Dongee, y Python y Docker en Dongee Cloud.

Preguntas frecuentes

¿Uso el puerto 587 o el 465?

Ambos cifran la conexión. El 587 empieza en texto plano y pasa a cifrado con STARTTLS, por eso usa secure: false. El 465 cifra desde el inicio y usa secure: true. Elige el que indique tu proveedor de correo.

¿Puedo usar Gmail como servidor SMTP?

Depende de las condiciones y requisitos de autenticación de ese proveedor. En cualquier caso, para una app con tu dominio es mejor enviar desde una dirección de ese dominio.

¿Sirve este código en Next.js?

Sí, siempre que se ejecute en código de servidor, como una ruta de API o una server action, y nunca en un componente del cliente. Tienes el paso a paso en la guía para publicar una app Next.js de Bolt o v0 con correos SMTP.

¿Por qué no envío el correo directamente desde el navegador?

Porque tendrías que exponer la contraseña SMTP en el frontend y cualquiera podría usarla para enviar correo en tu nombre. El navegador solo debe llamar a tu ruta del servidor.

¿Puedo enviar boletines a toda mi lista desde Live?

No. El buzón incluido es para correo de bajo volumen y Live no está pensado para campañas masivas. Para correo transaccional a muchos usuarios, usa MailChannels.

En resumen

Con Nodemailer, las variables de entorno y una ruta del servidor tienes el envío resuelto en pocas líneas. Combina bien el puerto con secure, envía desde tu dominio con SPF, DKIM y DMARC configurados, y elige el buzón incluido o un servicio transaccional según el volumen real de tu app.

Comenta lo que quieras

Unete a la charla
Solo ingresa tu email