Node.js: Enviando E-mails com Amazon SES
Como enviar e-mails em Node.js usando o Amazon SES, desde às configurações no AWS até o código para disparar os envios.
O SES (Simple Email Service) é um serviço de e-mails da AWS que pode ser usado tanto para envio de e-mails transacionais em aplicações (confirmação de cadastro, esqueci minha senha, formulário de contato, etc.) quanto para envio de e-mails em massa, como newsletters e afins.
OBS.: Este tutorial considera o uso para e-mails transacionais, enviados a um único destinatário por vez. Envio de e-mails em massa estão fora do escopo, e diferentes configurações podem ser necessárias.
Validar domínio e e-mails
Antes de começar a enviar e-mails pelo SES é preciso adicionar um domínio e um ou mais de endereços de e-mails como remetentes.
Adicionar e validar domínio
Para adicionar um domínio, vá ao SES Management Console, em Domains > Verify a New Domain:
Insira o domínio (sem www). Você pode marcar a opção Generate DKIM Settings para gerar os registros DKIM. Clique em Verify This Domain:
DKIM - DomainKeys Identified Mail - é um padrão que adiciona uma assinatura aos e-mails enviados a partir de um domínio, e garante que a mensagem foi mesmo enviada a partir daquele domínio e não foi alterada no caminho. Habilitar o DKIM é recomendado, pois melhora a taxa de entrega dos seus e-mails.
Na próxima tela serão exibidos os registros que você deve adicionar nas configurações de DNS do seu domínio (isso deve ser feito onde seu domínio está registrado):
A última entrada, Email Receiving Record, é necessária apenas para usar o SES no recebimento de e-mail. Não vai ser necessária no nosso caso.
Após adicionar as entradas no DNS do seu domínio, podem levar de poucos minutos a algumas horas para propagar e o domínio aparecer como verificado no SES.
Adicionar e validar e-mail
Vá em Email Addresses > Verify a New Email Address:
Adicione um e-mail que será usado como remetente e clique em Verify This Email Address.
A Amazon vai enviar uma confirmação. Basta clicar no link da mensagem para confirmar.
Criar chave de acesso
Para acessar os serviços da AWS via código, precisamos de uma chave de acesso. Vamos criar uma chave permissão ao serviço SES.
Para gerenciar usuários e chaves de acessos, vamos ao IAM Management Console, em Usuários > Adicionar usuário:
Digite um nome de usuário e escolha Acesso programático em Tipo de acesso:
Na tela seguinte, de permissões, escolha Anexar políticas existentes de forma direta, e Criar política.
Vamos criar uma política que permite apenas o envio de e-mails no SES.
Escolha o Serviço: SES, Ações: Gravação (SendEmail, SendRawEmail) e Recursos: Todos os recursos.
Clique em Revisar política, de um nome e clique em Criar política:
De volta à criação do usuário, procure e selecione a política recém-criada (pode ser necessário clicar no botão de Atualizar do lado direito para ver a política):
Clique em Próximo: Tags. Aqui você adicionar tags ao usuário para organização.
Clique em Próximo: Revisar. Verifique os dados e clique em Criar usuário.
Você vai ver o ID e chave de acesso do novo usuário. Guarde estas informações em um local seguro, pois você não irá ver esta tela novamente!
NOTA: Em uma aplicação, o ideal é que estas informações sensíveis sejam salvas como variáveis de ambiente, usando uma lib como a dotenv para gerenciar os valores em diferentes ambientes.
Usando AWS SDK para enviar e-mails
Feito todo esse setup, o código para de fato enviar e-mails é relativamente simples:
const AWS = require('aws-sdk')
const SES = new AWS.SES({
accessKeyId: process.env.AWS_ID,
secretAccessKey: process.env.AWS_KEY,
region: 'us-east-1',
})
async function sendTestEmail(to) {
const from = 'Name <from@example.com>'
const params = {
Destination: {
ToAddresses: [to],
},
Message: {
Body: {
Html: {
Charset: 'UTF-8',
Data: '<p>Node.js and <strong>Amazon SES</strong> test e-mail</p>',
},
},
Subject: {
Charset: 'UTF-8',
Data: 'This is a test!',
},
},
Source: from,
}
try {
await SES.sendEmail(params).promise()
console.log('E-mail sent successfully!')
} catch (error) {
console.log(error)
}
}
console.log('Starting...')
sendTestEmail('recipient@example.com')
Vamos precisar da dependência aws-sdk.
Criamos uma instância da classe SES, passando o ID e chave que registramos, e usamos o método assíncrono sendEmail para enviar o e-mail. Este método recebe um objeto de parâmetros, onde definimos o remetente, o destinatário, assunto e corpo da mensagem.
Para mais detalhes sobre o uso do SES com o SDK, veja a documentação oficial.
Executando este código, em poucos segundos chega o e-mail na caixa do destinatário:
Código final
O código deste tutorial está em: https://github.com/doug2k1/node-email-ses
Comentários? Dúvidas? Me mande uma mensagem ou comente aqui embaixo!