Email · validação de remetente e registro de domínio
Antes que Bird possa entregar e-mails a partir do seu domínio, registre-o no seu espaço de trabalho e verifique os registros DNS. Para o passo a passo de configuração e detalhes sobre API, consulte o guia de desenvolvedor de domínios de envio.
O que acontece quando você adiciona um domínio
Adicionar um domínio de envio (no dashboard ou via API) registra-o na infraestrutura de envio de Bird e atribui à sua organização sua própria chave DKIM. O domínio começa no status pending, e você recebe os registros DNS exatos para publicar:
- Um registro TXT DKIM: comprova a propriedade e assina seus e-mails.
- Um CNAME return-path: encaminha devoluções de volta para Bird e cobre SPF.
- Uma política DMARC: qualquer registro v=DMARC1 válido; uma política p=none mínima é suficiente.
- Um CNAME opcional de tracking para rastreamento de abertura/clique com sua marca (não é necessário para envio).
A verificação DNS é automática. O status rejected significa que Bird recusou o domínio por motivos de política. Selecione Feedback > Contact us se você o encontrar.
Como a verificação funciona
Bird verifica os registros quando você registra o domínio e depois usa um cronograma de backoff nas primeiras 72 horas. Após isso, uma varredura diária continua verificando os domínios ativos. O envio fica disponível quando DKIM, o CNAME return-path e DMARC forem todos verificados.
Após corrigir um registro DNS, selecione Refresh na página de detalhes do domínio ou chame o endpoint de verificação para obter o resultado atual.
Quanto tempo leva
A verificação é concluída depois que Bird consegue resolver todos os registros obrigatórios. A propagação DNS pode levar de minutos a 48 horas, dependendo do provedor e do TTL.
Se o domínio permanecer pending, verifique se há um host incorreto, um sufixo de domínio duplicado, um valor truncado ou um CNAME com proxy. Use Por que meu domínio não está sendo verificado? para o checklist completo.
Verificado não é para sempre
Bird continua a verificação após a primeira checagem bem-sucedida. A varredura diária segue verificando domínios verificados. Se seu DNS quebrar depois, o domínio pode voltar para não verificado e interromper os envios até você restaurar os registros. Isso pode acontecer quando uma migração de provedor apaga um registro ou uma alteração de zona remove o registro TXT DKIM.
Para evitar o bloqueio de envios durante um problema de DNS transitório, Bird mantém um registro previamente verificado em estado de aviso por 24 horas após a primeira falha na checagem. Qualquer checagem bem-sucedida limpa o aviso. Se o registro ainda falhar após 24 horas, seu status muda para failed e o envio é interrompido até que o registro seja verificado novamente.
O conselho prático: trate os registros DNS do seu domínio de envio como infraestrutura de produção. Se você migrar de provedor DNS ou reestruturar sua zona, transfira os registros DKIM, return-path e DMARC primeiro.
Próximos passos
- Domínios de envio: o guia completo para desenvolvedores, cobrindo o API de registro, detalhes dos registros DNS e o ciclo de vida da verificação.
- Por que meu domínio não está sendo verificado?: diagnóstico de domínios pendentes e propagação DNS.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Entenda o conceitoSPF vs DKIM vs DMARC: what's the difference?Use a ferramentaDMARC policy builderExplore a funcionalidadeSending domainsGuia de implementaçãoDKIM, SPF & DMARC
Obtenha um resumo de implementação