Skip to main content
Crie uma identidade para cada domínio de envio em cada região. Verificar em uma região não verifica o domínio em outra. Uma identidade verificada permite endereços de remetente naquele domínio ou em seus subdomínios. Identidades pendentes, com falha ou suspensas não podem enviar.

Criar e verificar um domínio

Abra Email e Sender identities. Clique em Create identity, informe o domínio e abra a identidade criada. Publique os registros mostrados em DNS records e solicite a verificação na página da identidade.
Registros com required: true estabelecem a propriedade e a assinatura DKIM. Registros SPF e DMARC recomendados ajudam os provedores destinatários a autenticar e avaliar emails. Use os registros retornados em vez de montar nomes DNS regionais. Mantenha os registros de verificação e DKIM publicados após verificar. Alterações DNS podem levar algum tempo para ficar visíveis aos resolvedores.

Rotacionar DKIM

Comece com POST /v1/identities/{identity_id}/dkim/rotate. Publique os registros do novo seletor mantendo o seletor ativo no DNS. Chame POST /v1/identities/{identity_id}/dkim/rotate/finalize depois que os novos registros resolverem. Durante a sobreposição, a resposta expõe o seletor antigo e dkim_old_expires_at; mantenha os registros DNS antigos até esse horário. Cancele uma rotação pendente com DELETE /v1/identities/{identity_id}/dkim/rotate. O cancelamento descarta a chave pendente e mantém o seletor ativo.

MAIL FROM personalizado

Um domínio MAIL FROM personalizado controla o remetente do envelope usado para tratar retornos de falha. Ele deve ser igual ao domínio da identidade verificada ou um subdomínio dele. É separado do cabeçalho visível From. Defina domain com PATCH /v1/identities/{identity_id}/mail-from-domain, publique os registros DNS retornados e chame o endpoint /verify correspondente. Para voltar ao domínio de envelope da plataforma, envie {"domain":null}. A propriedade domain é opcional; a omissão preserva o valor e uma string vazia é inválida.

BIMI

Configure BIMI com PATCH /v1/identities/{identity_id}/bimi. logo_url deve apontar para um logo SVG Tiny PS acessível publicamente por HTTPS. vmc_url é uma URL HTTPS opcional de certificado. Publique o registro DNS BIMI e chame /bimi/verify para validar os arquivos referenciados. A verificação não garante que um provedor de email exibirá o logo. Envie {"logo_url":null} para limpar BIMI. Omitir vmc_url preserva o certificado; vmc_url: null remove somente o vínculo do certificado. Não é possível definir um certificado sem um logo.

Inspecionar a saúde do envio

A aba Metrics da identidade mostra tráfego, feedback, engajamento, mensagens pendentes, latência SMTP e reputação por meio de Telemetry. Os gráficos de reputação acompanham as contagens e taxas das últimas 24 horas usadas nas restrições de envio. Use Settings para gerenciar recebimento, rotação DKIM, MAIL FROM e BIMI em cards separados. DNS records separa registros de envio dos registros MX de recebimento. Use Recipient rules para criar regras de endereços recebidos e escolher tópicos de Notifications pelo nome. Os detalhes da identidade mostram a retenção de mensagens e o bucket de anexos selecionado. Consulte Recebimento de email para registros MX, roteamento e limites. Excluir uma identidade inicia sua remoção e apaga as mensagens associadas, a configuração de recebimento e as chaves de assinatura. Use a zona de perigo na aba Settings somente depois de interromper os envios que dependem dela.

Grupos e alternativas de registros DNS

dns_records inclui registros das duas funções, diferenciados por group: "sending" e group: "receiving". Os valores estão prontos para copiar, incluindo a prioridade MX. Os registros MX e SPF do MAIL FROM personalizado pertencem ao grupo de envio. Registros com o mesmo alternative_group são alternativas. Publique exatamente uma alternativa para um grupo obrigatório: um registro TXT DKIM ou sua delegação CNAME. Eles não podem coexistir no mesmo nome DNS. Durante a rotação, mantenha o seletor atual funcionando enquanto publica uma alternativa para o seletor pendente. Use PATCH /v1/identities/{identity_id} para substituir tags. A omissão preserva as tags; um objeto vazio as remove. MAIL FROM e BIMI também usam PATCH: a omissão preserva cada configuração, enquanto null a limpa. Limpar o logo BIMI também limpa seu certificado. Limpar apenas vmc_url mantém o logo.