Base de conhecimento
Envie e-mails através da sua própria conta do SendGrid
Conecte sua própria conta do SendGrid: autenticação de domínio e seus registros CNAME, uma chave do Mail Send restrita em vez de acesso total, a armadilha da nuvem cinza do Cloudflare e o que um erro 403 em uma chave válida realmente significa.
Você precisará de uma conta do SendGrid (Twilio SendGrid) e acesso ao DNS do seu domínio.
Documentação própria do SendGrid: Autenticação de remetente · Chaves de API · Cadastre-se
1. Autentique o seu domínio
Configurações (Settings) → Autenticação de remetente (Sender Authentication) → Autenticar seu domínio (Authenticate Your Domain).
Escolha o seu host de DNS na lista e responda Sim (Yes) à pergunta "Deseja também marcar os links deste domínio com a sua marca?" (Would you like to also brand the links for this domain?) — a personalização de links reescreve os links rastreados para o seu próprio domínio em vez de sendgrid.net, e um cliente que passar o cursor sobre um link na sua fatura deverá ver o seu nome.
Insira um subdomínio como mail.seudominio.com quando for solicitado o domínio de envio.
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 caminho de retorno (bounce) | | CNAME | s1._domainkey.seudominio.com | Chave DKIM 1 | | CNAME | s2._domainkey.seudominio.com | Chave DKIM 2 |
⭐ O SendGrid usa registros CNAME em vez de registros TXT de propósito, e isso é genuinamente melhor: os valores reais das chaves ficam no SendGrid, permitindo que eles alternem as chaves de assinatura sem que você precise mexer no seu DNS novamente.
⚠️ Se o seu provedor de DNS for o Cloudflare, defina esses registros como Apenas DNS (nuvem cinza), não como proxy. Um CNAME com proxy é resolvido para os endereços do Cloudflare e a verificação do SendGrid falha.
Pressione Verificar (Verify) no SendGrid. Aguarde até uma hora.
3. Crie uma chave de API
Configurações (Settings) → Chaves de API (API Keys) → Criar chave de API (Create API Key).
Escolha Acesso restrito (Restricted Access) e conceda apenas Envio de e-mail → Acesso total (Mail Send → Full Access). Mais nada.
⛔ Não use uma chave de Acesso total (Full Access). Uma chave de Acesso total pode ler os seus contatos, alterar as configurações da sua conta e criar mais chaves; a única coisa de que precisamos é enviar uma mensagem. Se a nossa cópia da sua chave fosse exposta, a diferença entre essas duas chaves seria a diferença entre alguns e-mails indesejados e uma conta comprometida.
⚠️ A chave é exibida apenas uma vez. Copie-a antes de sair da página — o SendGrid não poderá exibi-la novamente, apenas substituí-la.
4. Conecte-a no Zinn®
Abra Envio de e-mail (Email sending) no seu painel:
- Provedor (Provider) — SendGrid
- Enviar a partir deste domínio (Send from this domain) —
mail.seudominio.com(um domínio, não um endereço) - Chave de API do SendGrid (SendGrid API key) — a chave da etapa 3
O SendGrid não precisa de nenhuma outra configuração sua.
5. Envie o teste e insira o código
Pressione Enviar mensagem de teste (Send test message) para uma caixa de entrada em um domínio diferente, leia o código nela e insira-o.
Quando não funcionar
403 Proibido (403 Forbidden) — a sua chave de API não tem permissão de Envio de e-mail (Mail Send). Esta é a falha mais comum de longe: uma chave de Acesso restrito (Restricted Access) criada sem nenhum escopo selecionado é autenticada perfeitamente e não tem permissão para fazer nada.
"O endereço do remetente não corresponde a uma identidade de remetente verificada" ("The from address does not match a verified Sender Identity") — a autenticação do seu domínio ainda não foi concluída (não ficou verde) ou o domínio em Enviar a partir deste domínio (Send from this domain) 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 (Accepted but never delivered) — verifique a Atividade (Activity) no SendGrid. Uma conta totalmente nova às vezes fica retida para análise no primeiro dia ou mais, e as mensagens ficam lá em vez de retornarem (bounce).
Sua conta foi suspensa após alguns envios (Your account was suspended after a few sends) — o SendGrid é rigoroso quanto a novas contas que enviam para endereços que geram devoluções (bounces). Certifique-se de que a sua lista de clientes esteja limpa antes de fazer a migração.
Ainda com problemas?
O suporte está incluído em todos os planos com respostas no seu próprio idioma.
Contatar o suporte → Todos os artigos →