Como enviar e-mails de um app Node.js com Nodemailer e SMTP?

Instale o Nodemailer, crie um transporte SMTP com variáveis de ambiente e chame sendMail no servidor, usando a porta 587 com secure: false ou a 465 com secure: true. Envie do seu domínio com SPF, DKIM e DMARC configurados.

Para enviar e-mails com Nodemailer, SMTP e Node.js, instale a biblioteca, crie um transporte SMTP com host, porta, usuário e senha lidos de variáveis de ambiente e chame sendMail no servidor. Use a porta 587 com secure: false (STARTTLS) ou a 465 com secure: true (TLS). Envie de um endereço do seu domínio com SPF, DKIM e DMARC configurados.

O que você precisa antes de começar

Você precisa de um projeto Node.js com módulos ES ("type": "module" no seu package.json) e dos dados de uma conta SMTP: servidor, porta, usuário e senha. Se quiser revisar como um e-mail viaja entre servidores, leia o que é SMTP e como funciona. Para entender por que o SMTP serve para enviar e não para ler a caixa de entrada, consulte a diferença entre SMTP, POP e IMAP.

Receita passo a passo com Nodemailer

1. Instale a biblioteca

npm install nodemailer express

2. Defina as variáveis de ambiente

Os nomes a seguir são só exemplos; você pode usar outros, desde que coincidam com o seu código:

SMTP_HOST=mail.seudominio.com.br
SMTP_PORT=587
SMTP_USER=contato@seudominio.com.br
SMTP_PASS=sua-senha
MAIL_FROM=contato@seudominio.com.br

Este arquivo não vai para o repositório. Em produção, esses valores são configurados como variáveis de ambiente do servidor.

3. Crie o transporte e verifique a conexão

// 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 direto; 587 = STARTTLS
  auth: {
    user: process.env.SMTP_USER,
    pass: process.env.SMTP_PASS,
  },
});

export async function probarSmtp() {
  try {
    await transporter.verify();
    console.log('Conexão SMTP correta');
  } catch (err) {
    console.error('Erro SMTP:', err.message);
  }
}

transporter.verify() se conecta ao servidor e tenta se autenticar sem enviar nenhum e-mail. Use-o ao iniciar o app ou em um teste para detectar erros de configuração logo.

4. Envie o e-mail a partir de uma rota 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: 'Faltam dados' });
  }

  try {
    await transporter.sendMail({
      from: process.env.MAIL_FROM,
      to: process.env.MAIL_FROM,
      replyTo: email,
      subject: `Nova mensagem de ${nombre || 'contato pelo site'}`,
      text: `De: ${email}\n\n${mensaje}`,
      html: '<p>Você tem uma nova mensagem do formulário de contato.</p>',
    });
    res.json({ ok: true });
  } catch (err) {
    console.error('Não foi possível enviar:', err.message);
    res.status(500).json({ ok: false, error: 'Não foi possível enviar a mensagem' });
  }
});

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

O formulário do navegador só faz um fetch para POST /contacto. A conexão SMTP e a senha ficam sempre no servidor e nunca chegam ao frontend.

Boas práticas

  • Remetente do seu domínio: o campo from deve ser um endereço do seu domínio. Se quiser responder a quem escreveu, coloque o endereço da pessoa em replyTo, e não em from.
  • SPF, DKIM e DMARC: o SPF indica quais servidores podem enviar em nome do seu domínio, o DKIM assina cada mensagem e o DMARC diz aos destinatários o que fazer se algo não bater. Sem esses registros, seus e-mails podem cair no spam.
  • Credenciais fora do código: nunca escreva a senha SMTP no código, no repositório nem em variáveis que acabem no frontend.
  • Erros controlados: envolva o envio em try/catch, registre o erro e responda ao usuário. Não tente de novo em loop, porque uma falha de autenticação repetida pode bloquear a conta.
  • Valide a entrada: revise os campos do formulário antes de enviar e não coloque texto do usuário sem escapar dentro do HTML do e-mail.

Erros comuns e como resolver

SintomaCausa provávelSolução
Timeout ou erro de TLS ao conectarPorta e secure combinados de forma errada587 com secure: false; 465 com secure: true
Erro de autenticaçãoUsuário ou senha incorretosUse o endereço completo como usuário e revise a variável da senha
O e-mail cai no spamFaltam SPF, DKIM ou DMARC, ou o from não é do seu domínioConfigure os registros do domínio e envie de um endereço próprio

A partir do Dongee Live

O Dongee Live, a hospedagem da Dongee para apps feitos com IA, publica apps Node.js (Express, Fastify, Koa, Hono, Next.js e outros) criados com Claude Code, Cursor, Codex, Lovable, Bolt ou v0. A partir do Live, o SMTP de saída funciona pelas portas 587 e 465, então esta receita serve do jeito que está. Você define as variáveis de ambiente do seu app, inclusive no Live Free, e o Live mantém o app em execução com HTTPS.

A caixa de e-mail incluída no seu plano do Live é uma conta de e-mail normal, com os limites de envio habituais. Ela serve para baixo volume, como um formulário de contato ou avisos pontuais. Se o seu app envia e-mail transacional para muitos usuários (confirmações de cadastro, redefinição de senha), é melhor usar o MailChannels, que é contratado à parte e funciona a partir do Live. Se quiser saber como esse tipo de envio funciona, leia o que é um SMTP relay.

Comparação honesta: caixa incluída ou serviço transacional

CritérioCaixa de e-mail incluída no LiveServiço transacional (MailChannels)
CustoIncluída no planoContratado à parte
VolumeBaixo, com os limites normais de uma contaPensado para envios frequentes do app
Casos de usoFormulário de contato, avisos pontuaisConfirmações, redefinição de senha, notificações para muitos usuários
Campanhas em massaNãoNão: o Live não foi pensado para campanhas em massa

Quando o Dongee Live não é a melhor opção: se o seu objetivo é enviar campanhas de e-mail marketing em massa, o Live não foi pensado para isso. Também não serve se o seu backend está em Python, PHP ou Docker. PHP e WordPress vão na hospedagem de sites cPanel da Dongee, e Python e Docker no Dongee Cloud.

Perguntas frequentes

Uso a porta 587 ou a 465?

As duas criptografam a conexão. A 587 começa em texto simples e passa a ser criptografada com STARTTLS, por isso usa secure: false. A 465 criptografa desde o início e usa secure: true. Escolha a que o seu provedor de e-mail indicar.

Posso usar o Gmail como servidor SMTP?

Depende das condições e dos requisitos de autenticação desse provedor. De qualquer forma, para um app com o seu domínio, é melhor enviar de um endereço desse domínio.

Este código serve no Next.js?

Sim, desde que seja executado em código de servidor, como uma rota de API ou uma server action, e nunca em um componente do cliente. O passo a passo está no guia para publicar um app Next.js do Bolt ou do v0 com e-mails SMTP.

Por que não envio o e-mail direto do navegador?

Porque você teria que expor a senha SMTP no frontend, e qualquer pessoa poderia usá-la para enviar e-mails em seu nome. O navegador só deve chamar a sua rota do servidor.

Posso enviar newsletters para toda a minha lista a partir do Live?

Não. A caixa incluída é para e-mail de baixo volume, e o Live não foi pensado para campanhas em massa. Para e-mail transacional para muitos usuários, use o MailChannels.

Em resumo

Com o Nodemailer, as variáveis de ambiente e uma rota do servidor, o envio fica resolvido em poucas linhas. Combine bem a porta com secure, envie do seu domínio com SPF, DKIM e DMARC configurados e escolha a caixa incluída ou um serviço transacional de acordo com o volume real do seu app.

Comenta lo que quieras

Unete a la charla
Solo ingresa tu email