Node.js: Configurando Email Com Mailcatcher E Nodemailer

Aug 16, 2025 by Lucas 57 views

Configurando Serviço de Email para Aplicações Node.js com Mailcatcher e Nodemailer

Introdução

E aí, pessoal! 👋 Em algum momento no desenvolvimento das nossas aplicações Node.js, vamos nos deparar com a necessidade de enviar emails para os nossos usuários. Seja para confirmar o endereço de email durante a criação da conta, para enviar notificações sobre novos comentários em suas publicações, ou para qualquer outra interação que precise de um email, essa é uma funcionalidade essencial. Neste artigo, vamos explorar como configurar um serviço de email para nossas aplicações Node.js utilizando duas ferramentas incríveis: Mailcatcher e Nodemailer. Vamos juntos nessa?

Por que Mailcatcher e Nodemailer?

Mailcatcher é uma ferramenta super útil para desenvolvimento e testes. Ele cria um servidor SMTP local que captura todos os emails enviados pela sua aplicação, permitindo que você os visualize em uma interface web sem realmente enviá-los para destinatários reais. Isso é ótimo para evitar spam e testar seus templates de email com segurança. Imagine a tranquilidade de poder testar seus envios de email sem correr o risco de incomodar seus usuários com emails de teste! 😉

Já o Nodemailer é um módulo poderoso do Node.js para envio de emails. Ele oferece uma API simples e flexível para configurar diferentes transportadores (como SMTP, Sendmail, etc.) e enviar emails com facilidade. Com Nodemailer, você pode enviar emails simples, emails com HTML, anexos e muito mais. É como ter um canivete suíço para envio de emails nas suas aplicações Node.js.

Pré-requisitos

Antes de começarmos, vamos garantir que você tenha tudo o que precisa para seguir este tutorial:

Node.js e npm: Tenha o Node.js instalado na sua máquina. O npm (Node Package Manager) geralmente vem junto com o Node.js.
Docker: Vamos usar o Docker para rodar o Mailcatcher, então certifique-se de tê-lo instalado.
Um editor de código: Use seu editor de código favorito para editar os arquivos da sua aplicação.

Com tudo isso em mãos, estamos prontos para começar! 🚀

Passo 1: Levantando o Mailcatcher com Docker

O primeiro passo é levantar um container Docker com o Mailcatcher. Isso é super simples! Abra seu terminal e execute o seguinte comando:

docker run -d -p 1080:1080 -p 1025:1025 --name mailcatcher sj26/mailcatcher

Vamos entender o que esse comando faz:

docker run -d: Inicia um novo container em modo detached (em segundo plano).
-p 1080:1080: Mapeia a porta 1080 do container para a porta 1080 da sua máquina (interface web do Mailcatcher).
-p 1025:1025: Mapeia a porta 1025 do container para a porta 1025 da sua máquina (porta SMTP).
--name mailcatcher: Define o nome do container como "mailcatcher".
sj26/mailcatcher: Especifica a imagem do Docker a ser utilizada (Mailcatcher).

Depois de executar o comando, você pode verificar se o container está rodando com o seguinte comando:

docker ps

Você deverá ver o container do Mailcatcher na lista. Agora, abra seu navegador e acesse http://localhost:1080. Você deverá ver a interface web do Mailcatcher, que estará vazia por enquanto. 😉

Passo 2: Configurando o Nodemailer na sua aplicação Node.js

Agora que temos o Mailcatcher rodando, vamos configurar o Nodemailer na nossa aplicação Node.js. Se você já tem uma aplicação, pode usar ela. Caso contrário, vamos criar uma aplicação simples para este tutorial.

Criando uma aplicação Node.js (opcional)

Se você não tem uma aplicação Node.js, crie uma pasta para o projeto e navegue até ela no seu terminal:

mkdir nodemailer-example
cd nodemailer-example

Inicialize um novo projeto Node.js com o seguinte comando:

npm init -y

Isso criará um arquivo package.json com as configurações padrão.

Instalando o Nodemailer

Agora, vamos instalar o Nodemailer como uma dependência do nosso projeto:

npm install nodemailer

Configurando o transporte SMTP

Crie um arquivo chamado app.js (ou qualquer outro nome que preferir) e adicione o seguinte código:

const nodemailer = require('nodemailer');

// Configuração do transporte SMTP
const transporter = nodemailer.createTransport({
  host: 'localhost',
  port: 1025, // Porta do Mailcatcher
  secure: false, // Use TLS
  ignoreTLS: true // Ignora erros de certificado (para desenvolvimento)
});

// Exemplo de email
const mailOptions = {
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Assunto do email',
  text: 'Olá! Este é um email de teste enviado com Nodemailer e Mailcatcher.'
};

// Envio do email
transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    console.log('Erro ao enviar email:', error);
  } else {
    console.log('Email enviado com sucesso:', info.response);
  }
});

Vamos entender o código:

const nodemailer = require('nodemailer');: Importa o módulo Nodemailer.
const transporter = nodemailer.createTransport({...});: Cria um objeto de transporte SMTP. Aqui, configuramos o Nodemailer para usar o Mailcatcher:
- host: 'localhost': Endereço do servidor SMTP (Mailcatcher).
- port: 1025: Porta SMTP do Mailcatcher.
- secure: false: Não usamos TLS em ambiente de desenvolvimento.
- ignoreTLS: true: Ignoramos erros de certificado TLS (útil em desenvolvimento).
const mailOptions = {...};: Define as opções do email:
- from: Endereço do remetente.
- to: Endereço do destinatário.
- subject: Assunto do email.
- text: Corpo do email (texto simples).
transporter.sendMail(mailOptions, (error, info) => {...});: Envia o email e trata os erros e o sucesso do envio.

Executando a aplicação

Agora, execute a aplicação no seu terminal:

node app.js

Se tudo estiver configurado corretamente, você deverá ver uma mensagem de sucesso no console. Abra a interface web do Mailcatcher (http://localhost:1080) e você verá o email que acabamos de enviar! 🎉

Passo 3: Adicionando funcionalidades ao Orchestrator (Opcional)

Agora, vamos adicionar algumas funcionalidades ao nosso "Orchestrator" (que, para simplificar, será apenas um conjunto de funções na nossa aplicação) para consultar o último email capturado pelo Mailcatcher e limpar a caixa de entrada. Isso é super útil para testes automatizados.

Instalando o módulo `node-fetch`

Vamos usar o módulo node-fetch para fazer requisições HTTP para a API do Mailcatcher. Instale-o com o seguinte comando:

npm install node-fetch

Adicionando as funções ao `app.js`

Adicione o seguinte código ao seu arquivo app.js:

const fetch = require('node-fetch');

// Função para obter o último email do Mailcatcher
async function getLastEmail() {
  const response = await fetch('http://localhost:1080/messages');
  const emails = await response.json();
  if (emails.length > 0) {
    const lastEmailId = emails[emails.length - 1].id;
    const emailResponse = await fetch(`http://localhost:1080/messages/${lastEmailId}.json`);
    const email = await emailResponse.json();
    return email;
  } else {
    return null;
  }
}

// Função para limpar a caixa de entrada do Mailcatcher
async function clearInbox() {
  await fetch('http://localhost:1080/messages', { method: 'DELETE' });
  console.log('Caixa de entrada do Mailcatcher limpa.');
}

// Testando as funções
async function testOrchestrator() {
  // Limpa a caixa de entrada
  await clearInbox();

  // Envia um email
  await transporter.sendMail(mailOptions);

  // Obtém o último email
  const lastEmail = await getLastEmail();
  console.log('Último email:', lastEmail);
}

testOrchestrator();

Vamos entender as novas funções:

async function getLastEmail() {...}: Obtém o último email da API do Mailcatcher.
- Faz uma requisição para http://localhost:1080/messages para obter a lista de emails.
- Se houver emails, obtém o ID do último email e faz uma requisição para http://localhost:1080/messages/${lastEmailId}.json para obter os detalhes do email.
- Retorna o email ou null se não houver emails.
async function clearInbox() {...}: Limpa a caixa de entrada do Mailcatcher.
- Faz uma requisição DELETE para http://localhost:1080/messages.
async function testOrchestrator() {...}: Função para testar as funcionalidades.
- Limpa a caixa de entrada.
- Envia um email.
- Obtém o último email e o imprime no console.

Executando a aplicação novamente

Execute a aplicação novamente:

node app.js

Você deverá ver a caixa de entrada do Mailcatcher sendo limpa, o email sendo enviado e os detalhes do último email sendo impressos no console. Isso demonstra como podemos automatizar a interação com o Mailcatcher para testes e outras funcionalidades.

Conclusão

E é isso, pessoal! 🎉 Neste artigo, exploramos como configurar um serviço de email para aplicações Node.js utilizando Mailcatcher e Nodemailer. Vimos como o Mailcatcher nos ajuda a testar nossos emails de forma segura e eficiente, e como o Nodemailer facilita o envio de emails nas nossas aplicações. Além disso, adicionamos funcionalidades ao nosso "Orchestrator" para interagir com a API do Mailcatcher, permitindo automatizar tarefas como limpar a caixa de entrada e obter o último email.

Espero que este tutorial tenha sido útil para você. Se tiver alguma dúvida ou sugestão, deixe um comentário abaixo. E não se esqueça de praticar e explorar as possibilidades dessas ferramentas incríveis! 😉

Até a próxima! 👋