O senhor precisará de uma conta da AWS e de acesso ao DNS do seu domínio. O SES é a opção mais econômica desta lista por uma ampla margem, e a que possui mais etapas.
Documentação da própria Amazon: Verificar um domínio · Obter credenciais SMTP · Sair do sandbox
⭐ Conectamos ao SES por meio de sua interface SMTP, e não por sua API REST. É por isso que solicitamos um nome de usuário e uma senha SMTP, em vez de uma chave de acesso da AWS. Ambos os caminhos entregam exatamente a mesma mensagem; o método SMTP evita toda uma categoria de problemas de assinatura de solicitações da AWS que são terríveis de diagnosticar externamente, e é a interface para a qual a Amazon publica credenciais especificamente para que ferramentas como a nossa possam utilizá-la.
1. Escolha uma região e permaneça nela
O SES é regional. Tudo o que está listado abaixo — seu domínio verificado, suas credenciais, sua cota de envio — pertence a uma região da AWS e não existe em nenhuma outra.
Escolha a mais próxima de seus clientes (eu-west-1 para a Europa, us-east-1 para a América do Norte) e anote-a. Verificar seu domínio na Irlanda e depois criar credenciais em Frankfurt é a maneira mais comum de perder uma tarde inteira por aqui, e o erro gerado não informa nada sobre regiões.
2. Verifique o seu domínio
Console do Amazon SES → Identities → Create identity → Domain. Insira um subdomínio como mail.yourdomain.com.
Ative o Easy DKIM e selecione RSA_2048_BIT. O SES fornecerá três registros CNAME:
| Tipo | Host |
|---|
CNAME | <token1>._domainkey.mail.yourdomain.com |
CNAME | <token2>._domainkey.mail.yourdomain.com |
CNAME | <token3>._domainkey.mail.yourdomain.com |
Adicione todos os três. A verificação geralmente é concluída em até uma hora.
⭐ Além disso, ative um domínio personalizado MAIL FROM (bounce.mail.yourdomain.com) e adicione os registros MX e TXT de SPF que ele solicita. Sem isso, o remetente do envelope permanece como amazonses.com, fazendo com que o SPF alinhe com a Amazon e não com o seu domínio, deixando a conformidade dependente exclusivamente do DKIM.
3. Saia do sandbox — esta é a etapa que costuma ser esquecida
⛔⛔ Uma nova conta do SES é inserida em um sandbox e só pode enviar mensagens para endereços que o senhor já tenha verificado individualmente. Ela aceitará todo o restante, mas não entregará absolutamente nada.
Essa é exatamente a falha que nossa etapa de verificação busca evitar: dentro do sandbox, o SES aceita sua mensagem respondendo com um status de sucesso padrão e depois a descarta. Se o senhor validar nossa configuração enviando o teste para um endereço previamente verificado na AWS, a operação terá êxito — e, em seguida, todas as mensagens direcionadas a clientes reais desaparecerão.
Account dashboard → Request production access. A Amazon perguntará o tipo de conteúdo que o senhor envia e de que forma administra as devoluções (bounces); um resumo breve e fidedigno informando sobre notificações transacionais enviadas aos seus próprios clientes normalmente é aprovado em até 24 horas.
⭐ Realize este procedimento antes de conectar o SES aqui. Não haverá como realizar diagnósticos posteriormente, pois nada reporta falha.
4. Crie credenciais SMTP
SES console → SMTP settings → Create SMTP credentials.
Esse processo gera um usuário no IAM com permissão apenas para envio e fornece um nome de usuário SMTP e uma senha SMTP.
⛔ Estas não são a sua chave de acesso e chave secreta da AWS. Elas são calculadas com base em um segredo do IAM por meio de um algoritmo específico e não são intercambiáveis. Colar uma chave de acesso secreta da AWS neste local causará falha na autenticação todas as vezes, e a mensagem de erro apenas informará que as credenciais foram rejeitadas.
⚠️ A senha é exibida apenas uma vez. Faça o download do arquivo CSV antes de sair da página.
5. Conecte-o no Zinn®
Abra Email sending no seu painel:
- Provider — Amazon SES
- Send from this domain —
mail.yourdomain.com
- AWS region — a região selecionada na etapa 1, ex.:
eu-west-1
- SMTP username — obtido na etapa 4
- Port — mantenha em 587
- SES SMTP password — obtida na etapa 4
Nós montamos o host automaticamente (email-smtp.<region>.amazonaws.com), portanto não há perigo de digitar o hostname incorretamente.
6. Envie o teste e insira o código
Clique em Send test message direcionando-a a uma caixa postal situada em um domínio diferente daquele que o senhor verificou na AWS — um endereço pessoal do Gmail é o ideal, pois confirmará de fato que a conta saiu do sandbox. Obtenha o código e informe-o no campo indicado.
Em caso de problemas
"Email address is not verified" ao realizar envios para um cliente real — a conta ainda está em modo sandbox. Consulte a Etapa 3.
535 Authentication Credentials Invalid — o senhor informou a chave de acesso da AWS em vez das credenciais SMTP (etapa 4), ou as credenciais utilizadas pertencem a uma região distinta da informada.
"Maximum sending rate exceeded" — uma nova conta em produção inicia limitada a 14 mensagens por segundo e 50.000 por dia. Essa capacidade cobre um volume substancial de notificações, contudo, caso vá migrar uma base de clientes volumosa, solicite um aumento previamente.
Funcionou durante os testes, mas parou de enviar em produção — consulte o painel de Reputation do SES. A Amazon suspende os envios automaticamente caso as taxas de devolução (bounce) ou de reclamações ultrapassem os limites permitidos, algo que pode acontecer facilmente ao utilizar uma base de contatos antiga.