Solução de problemas de configuração de DNS e SPF na Klaviyo

Quais registros DNS a Klaviyo usa

A Klaviyo usa registros DNS padrão para provar que você tem permissão para enviar e-mails do seu domínio. como:

• SPF (registro TXT) para listar quais serviços podem enviar e-mails para seu domínio.
• DKIM (registros CNAME, apontando para registros DKIM hospedados na Klaviyo) para permitir que os provedores de caixa de entrada verifiquem se as mensagens não foram alteradas.
• Outros registros TXT que algumas ferramentas usam para verificar a propriedade do domínio.

Você adiciona e edita esses registros no seu provedor de DNS (por exemplo, GoDaddy, Cloudflare, Shopify, OVH, IONOS ou seu painel de hospedagem). Se o seu domínio de envio da marca usar roteamento dinâmico, adicione os registros NS dele e o registro de verificação TXT do domínio raiz mostrado no Klaviyo no seu provedor de DNS. A Klaviyo hospeda o restante dos registros desse subdomínio, e você adiciona no Klaviyo quaisquer registros próprios para ele. Veja Como gerenciar registros DNS de um domínio de envio da marca dinâmico.

Os registros que você adiciona dependem do recurso da Klaviyo que você está configurando:

• domínio de envio da marca (marketing, transacional ou de serviço): registros NS (roteamento dinâmico) ou registros CNAME (roteamento estático), além de um registro de verificação TXT no domínio raiz para qualquer tipo de roteamento.
• Domínio dedicado de rastreamento de cliques: com a configuração manual, um CNAME no host que a Klaviyo fornece (por exemplo, trk.yourbrand.com), além do registro de verificação TXT do domínio raiz mostrado na Klaviyo. Com a configuração automática, a Klaviyo gerencia o registro de rastreamento de cliques no seu domínio de envio da marca dinâmico.
• DMARC: um registro TXT no domínio raiz (por exemplo, _dmarc.example.com), que você configura fora do Klaviyo.

Você não precisa adicionar um registro TXT de SPF separado para enviar e-mails pelo Klaviyo. O SPF já está configurado para os domínios de envio compartilhados do Klaviyo. Para um domínio de envio da marca, os registros NS ou CNAME que você adiciona durante a configuração o conectam aos registros SPF que o Klaviyo gerencia. A seção de SPF abaixo explica como atualizar um registro se outro serviço exigir uma alteração.

Onde encontrar seus valores DNS da Klaviyo

O processo de configuração do domínio mostra os registros exatos que você precisa adicionar. Para revisar os registros de um domínio depois de concluir a configuração:

1. Acesse Configurações > Domínios.
2. Abra o menu de três pontos do domínio e selecione Ver registros.

Para cada registro, você verá:

• Nome/host: a parte do domínio em que o registro deve ficar (por exemplo, send ou send.yourbrand.com).
• Tipo: como TXT.
• Valor: a string longa que você deve copiar e colar no seu provedor DNS.

Copie cada valor exatamente no seu host DNS, correspondendo ao Nome/Host e ao Tipo exibidos na Klaviyo.

Seletores DKIM por tipo de envio

Para o roteamento estático, os nomes dos registros CNAME DKIM dependem do tipo de envio para o domínio de envio da marca que você está configurando:

• Domínios de marketing usam os seletores km1 e km2.
• Os domínios transacionais usam os seletores kt1 e kt2.
• Os domínios de serviço usam os seletores ks1 e ks2.

Um segundo domínio de envio da marca do mesmo tipo de envio usa o próximo par de seletores. Por exemplo, um segundo domínio de marketing usa km3 e km4.

Os domínios de envio da marca estáticos existentes que foram configurados antes de os tipos de envio estarem disponíveis continuam usando os seletores kl1 e kl2 legados. Nenhuma ação é necessária para mantê-los funcionando.

O roteamento dinâmico não usa CNAMEs nomeados pelo seletor. Você adiciona registros NS para delegar o subdomínio de envio à Klaviyo, e a Klaviyo serve os registros DKIM no seu nome.

Editando um registro SPF existente com segurança

Um hostname deve ter apenas 1 registro SPF. A Klaviyo não exige que você adicione um mecanismo a um registro SPF existente. Se outro serviço de e-mail exigir uma alteração de SPF, atualize o registro existente em vez de criar um segundo.

Dicas gerais:

• Procure um registro TXT existente no seu domínio que comece com v=spf1.
• Se você encontrar um, adicione o mecanismo fornecido pelo serviço a esse mesmo registro, em vez de criar um novo TXT v=spf1.
• Verifique se o registro ainda começa com v=spf1 e termina com um resultado como ~all ou -all.

Se outro serviço exigir SPF em um subdomínio (por exemplo, send.example.com), use o host desse subdomínio. Não adicione um registro TXT em um host que já tenha um CNAME para a Klaviyo; o CNAME conecta esse host a registros gerenciados pela Klaviyo. Para nomes de host sem um CNAME, os exemplos são:

• Hospede send ou send.example.com para send.example.com.
• Host @ ou deixe em branco para o domínio raiz example.com (dependendo da interface do seu provedor de DNS).

Adicionando registros TXT extras (auditorias, verificação etc.)

Geralmente, você pode adicionar registros TXT adicionais para coisas como auditorias de segurança ou verificações de terceiros sem afetar a Klaviyo, desde que:

• Não crie um segundo registro SPF (v=spf1) para o mesmo host.
• Use o host ou nome especificado pelo terceiro (por exemplo, uma string exclusiva) para que não entre em conflito com registros SPF/DKIM existentes. Não adicione um registro TXT em um host que já tenha um CNAME.

Se você precisar comprovar a propriedade do seu domínio, geralmente é seguro adicionar um registro TXT no seu domínio raiz (por exemplo, example.com) usando exatamente o host e o valor fornecidos pelo serviço de auditoria.

Se o serviço solicitar o registro em um subdomínio de envio que usa roteamento dinâmico (por exemplo, send.example.com), adicione-o no Klaviyo em vez de no seu provedor de DNS. Além dos registros NS que delegam o subdomínio, os registros adicionados no seu provedor de DNS para ele não terão efeito. Consulte Como gerenciar registros de DNS para um domínio de envio da marca dinâmico.

Solução de problemas de domínio de rastreamento de cliques

Com a configuração manual, adicione o registro CNAME e o registro de verificação TXT do domínio raiz mostrados no Klaviyo ao seu provedor de DNS. Com a configuração automática, o Klaviyo gerencia o registro de rastreamento de cliques no seu domínio de envio da marca dinâmico. Se a verificação estiver falhando ou os links de clique não estiverem funcionando como esperado, verifique o seguinte:

• Registros CAA no domínio raiz: para configuração manual com um CNAME apontando para dct.klaviyodns.com, Quaisquer registros CAA no seu domínio raiz devem permitir que o Google emita certificados. Permitir 0 issue "pki.goog". Se você não tiver registros CAA, nenhuma alteração de CAA será necessária. Um registro CAA que bloqueia o Google impede a emissão do certificado.
• Tempo de verificação: quando a verificação começa, a Klaviyo verifica o DNS e o provisionamento do certificado SSL/TLS a cada 15 minutos por até 2 dias. Se o domínio mostrar Ação necessária ou Falhou, abra Ver registros e clique em Verificar para verificar novamente depois de corrigir os registros. Enquanto o domínio mostra Verificando, aguarde as verificações automáticas.
• Remoção do domínio de rastreamento de cliques: quando você remove um domínio exclusivo para rastreamento de cliques na Klaviyo, o registro DNS subjacente no seu provedor é preservado por padrão para que os links em e-mails enviados anteriormente continuem sendo resolvidos. Se você excluir o CNAME no seu provedor de DNS, esses links deixarão de funcionar.

Para ver detalhes da configuração e estados do ciclo de vida (Verificando, Ação necessária, Falhou, Verificado, Com atividade), consulte Como configurar o rastreamento de cliques dedicado.

Problemas comuns de SPF e DNS

Se você vir erros relacionados a DNS ou SPF na Klaviyo ao verificar seu domínio, verifique o seguinte:

• Registro não encontrado: confirme se o registro resolve no nome do host que o Klaviyo mostra. Se o seu provedor de DNS acrescentar automaticamente o domínio raiz, insira apenas o subdomínio no campo Nome/Host para que o domínio raiz não seja adicionado duas vezes.
• Não verificado: as alterações de DNS podem levar tempo para serem atualizadas. Aguarde e clique para verificar novamente na Klaviyo.
• SPF duplicado: mantenha 1 registro TXT v=spf1 para o host. Combine os mecanismos de envio autorizados nesse registro, com um único final, como ~all ou -all, e remova os registros SPF extras.
• Registros sendo proxy: alguns provedores DNS (Cloudflare em particular) oferecem um controle proxy que oculta registros atrás de uma CDN. O proxy impede que a Klaviyo verifique o registro. Desative o proxy para seus registros da Klaviyo e mantenha-o desativado.
• Domínio raiz anexado a um valor de CNAME: algumas interfaces de DNS anexam seu domínio raiz a qualquer coisa que você cole no campo Valor. Se uma consulta de CNAME retornar something.klaviyodns.com.example.com em vez de something.klaviyodns.com, adicione um ponto final ao Valor ou verifique a sintaxe do seu provedor para nomes totalmente qualificados.
• O provedor de DNS não oferece suporte a sublinhados: os registros DKIM exigem sublinhados no host (por exemplo, km1._domainkey.example.com). Se a UI do seu provedor rejeitar sublinhados, entre em contato com a equipe de suporte e, em geral, eles conseguem criar o registro para você. Se não conseguirem, considere mover o DNS para um provedor que aceite sublinhados.
• O provedor de DNS não oferece suporte ao símbolo @: o símbolo @ representa o domínio raiz. Se a IU do seu provedor não aceitar @, digite o domínio raiz diretamente (por exemplo, example.com) no campo Host.
• Atrasos de propagação de DNS: após salvar uma alteração de DNS, aguarde até 48 horas para que a alteração se propague em todo o mundo. A maioria das propagações termina em poucos minutos, mas o cache no lado do destinatário ou do seu provedor de DNS pode estender essa janela.

Recursos adicionais

• Como configurar o domínio de envio da marca
• Como configurar o rastreamento de cliques exclusivo
• Solução de problemas de domínio de envio da marca
• Como funciona a autenticação de e-mail
• Entenda os domínios que desempenham um papel na entregabilidade de e-mails