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 express2. 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.brEste 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
fromdeve ser um endereço do seu domínio. Se quiser responder a quem escreveu, coloque o endereço da pessoa emreplyTo, e não emfrom. - 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
| Sintoma | Causa provável | Solução |
|---|---|---|
| Timeout ou erro de TLS ao conectar | Porta e secure combinados de forma errada | 587 com secure: false; 465 com secure: true |
| Erro de autenticação | Usuário ou senha incorretos | Use o endereço completo como usuário e revise a variável da senha |
| O e-mail cai no spam | Faltam SPF, DKIM ou DMARC, ou o from não é do seu domínio | Configure 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ério | Caixa de e-mail incluída no Live | Serviço transacional (MailChannels) |
|---|---|---|
| Custo | Incluída no plano | Contratado à parte |
| Volume | Baixo, com os limites normais de uma conta | Pensado para envios frequentes do app |
| Casos de uso | Formulário de contato, avisos pontuais | Confirmações, redefinição de senha, notificações para muitos usuários |
| Campanhas em massa | Não | Nã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