Você precisará de uma conta SendGrid (Twilio SendGrid) e de acesso ao DNS do seu domínio.
Documentação do próprio SendGrid: Autenticação do remetente · Chaves de API · Cadastre-se
1. Autentique seu domínio
Configurações → Autenticação do Remetente → Autenticar Seu Domínio.
Escolha o seu provedor de DNS na lista e responda Sim para "Gostaria também de personalizar os links para este domínio?" — a personalização de links reescreve links rastreados para o seu próprio domínio em vez de sendgrid.net, e um cliente que passar o mouse sobre um link na sua fatura deverá ver o seu nome.
Insira um subdomínio como mail.seudominio.com quando solicitado o domínio a partir do qual você envia.
2. Publique os registros CNAME
O SendGrid fornece três ou cinco registros CNAME. Adicione todos eles.
| Tipo | Host | Finalidade |
|---|
CNAME | em1234.seudominio.com | Domínio de return-path (bounce) |
CNAME | s1._domainkey.seudominio.com | Chave DKIM 1 |
CNAME | s2._domainkey.seudominio.com | Chave DKIM 2 |
⭐ O SendGrid usa CNAMEs em vez de registros TXT de propósito, e isso é genuinamente melhor: os valores reais das chaves ficam no SendGrid, para que eles possam alternar as chaves de assinatura sem que você precise alterar seu DNS novamente.
⚠️ Se o seu provedor de DNS for a Cloudflare, defina esses registros como Somente DNS (nuvem cinza), não com proxy. Um CNAME com proxy é resolvido para os endereços da Cloudflare e a verificação do SendGrid falha.
Pressione Verificar no SendGrid. Aguarde até uma hora.
3. Crie uma chave de API
Configurações → Chaves de API → Criar Chave de API.
Escolha Acesso Restrito e conceda apenas Envio de E-mail → Acesso Total. Nada mais.
⛔ Não use uma chave de Acesso Total. Uma chave de Acesso Total pode ler seus contatos, alterar as configurações da sua conta e criar mais chaves; a única coisa que precisamos fazer é enviar uma mensagem. Se a nossa cópia da sua chave for exposta algum dia, a diferença entre essas duas chaves é a diferença entre alguns e-mails indesejados e uma conta comprometida.
⚠️ A chave é exibida uma única vez. Copie-a antes de sair da página — o SendGrid não pode exibi-la novamente, apenas substituí-la.
4. Conecte-a no Zinn®
Abra Envio de e-mail no seu painel:
- Provedor — SendGrid
- Enviar deste domínio —
mail.seudominio.com (um domínio, não um endereço)
- Chave de API do SendGrid — a chave da etapa 3
O SendGrid não precisa de nenhuma outra configuração da sua parte.
5. Envie o teste e insira o código
Pressione Enviar mensagem de teste para uma caixa de entrada em um domínio diferente, leia o código nela e insira-o.
Quando não funcionar
403 Forbidden — sua chave de API não possui a permissão de Envio de E-mail. Esta é, de longe, a falha mais comum: uma chave de Acesso Restrito criada sem nenhum escopo marcado é autenticada com sucesso e não tem permissão para fazer nada.
"O endereço do remetente não corresponde a uma Identidade de Remetente verificada" — a autenticação do seu domínio ainda não foi concluída com sucesso ou o domínio em Enviar deste domínio não é o que você autenticou. O SendGrid verifica o domínio exato: autenticar mail.seudominio.com não autoriza o envio a partir de seudominio.com.
Aceito, mas nunca entregue — consulte a seção Atividade no SendGrid. Uma conta totalmente nova às vezes é retida para análise durante o primeiro dia aproximadamente, e as mensagens ficam paradas lá em vez de retornarem com falha.
Sua conta foi suspensa após alguns envios — o SendGrid é rigoroso em relação a contas novas que enviam para endereços inexistentes. Certifique-se de que a sua lista de clientes esteja limpa antes de fazer a transição.