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ê pode adicionar e editar esses registros no seu provedor de DNS (por exemplo, GoDaddy, Cloudflare, Shopify, OVH, IONOS ou no seu painel de hospedagem), e não na Klaviyo.

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

• Domínio de envio da marca (marketing, transacional ou serviço): registros NS (roteamento dinâmico) ou registros CNAME mais um registro de verificação TXT (roteamento estático).
• Domínio dedicado de rastreamento de cliques: um único CNAME no host fornecido pela Klaviyo (por exemplo, trk.yourbrand.com).
• DMARC: um registro TXT no domínio raiz (por exemplo, _dmarc.example.com), que você configura fora do Klaviyo.

Geralmente, não é preciso adicionar um registro SPF para enviar e-mails pela Klaviyo. A Klaviyo usa seu próprio domínio Return-Path em cada e-mail, portanto, o SPF é aprovado por padrão. A seção SPF abaixo abrange casos em que você não deseja adicionar ou editar um registro SPF no seu domínio de envio da marca.

Onde encontrar seus valores DNS da Klaviyo

Na sua conta Klaviyo, a área de configuração do domínio mostrará os registros exatos que você precisa adicionar. 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

A maioria dos domínios deve ter apenas um registro SPF por nome de host. Se seu domínio já tiver um registro SPF e você estiver adicionando a Klaviyo, geralmente será necessário atualizar o registro existente, não 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 exigido pela Klaviyo a esse mesmo registro em vez de criar um novo v=spf1 TXT.
• Verifique se o registro ainda começa com v=spf1 e termina com um resultado como ~all ou -all.

Se você estiver enviando de um subdomínio (por exemplo send.example.com), edite ou adicione o registro SPF no host desse subdomínio, e não no hostname errado. Por exemplo:

• 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 o nome especificado pelo terceiro (por exemplo, uma string exclusiva) para não entrar em conflito com os registros SPF/DKIM existentes.

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.

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

Um domínio exclusivo para rastreamento de cliques usa um único CNAME no seu provedor DNS. Se a verificação estiver com falha ou os links de cliques não estiverem funcionando conforme o esperado, verifique o seguinte:

• Registros CAA no domínio raiz: para que o provisionamento de SSL seja bem-sucedido, os registros CAA do seu domínio raiz precisam permitir que o Google emita certificados. O domínio raiz deve permitir 0 issue pki.goog. Se o seu registro CAA bloquear isso, a emissão do certificado falhará.
• Tempo de verificação: a Klaviyo verifica automaticamente o CNAME a cada 15 minutos por até 2 dias após a criação do domínio de rastreamento de cliques. Você também pode clicar em Verify na Klaviyo UI para disparar uma verificação imediata.
• 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 nome/host no seu provedor de DNS corresponde exatamente ao que a Klaviyo mostra (nenhum domínio extra adicionado pela UI).
• Não verificado: as alterações de DNS podem levar tempo para serem atualizadas. Aguarde e clique para verificar novamente na Klaviyo.
• SPF duplicado: Combine vários valores v=spf1 em um único registro SPF para esse host, em vez de ter mais de um.
• 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