Entenda como o KlaviyoAIBot funciona

Saiba mais sobre o KlaviyoAIBot, incluindo:

• O que é e o que rastreia
• Como identificar solicitações autênticas
• Como o rastreamento respeita as regras do site e como você pode controlá-lo

Este artigo é para qualquer pessoa que veja tráfego do KlaviyoAIBot e queira confirmar se ele é legítimo ou ajustar como ele tem permissão para rastrear.

O que é o KlaviyoAIBot?

KlaviyoAIBot é um user-agent usado pelos recursos de IA da Klaviyo, incluindo o Customer Agent. Para o Customer Agent, o KlaviyoAIBot coleta páginas disponíveis publicamente de domínios e URLs conectados à sua conta. Ao indexar esse conteúdo, a Klaviyo pode personalizar experiências de IA tanto no seu site quanto dentro da Klaviyo. Isso é útil para geração de conteúdo, respostas de IA e recomendações de produtos.

Você pode adicionar fontes além da sua vitrine principal, incluindo Help Center (como o Zendesk), blogs e artigos de notícias. O KlaviyoAIBot não faz login para acessar páginas protegidas por autenticação ou paywalls.

Veja como funciona

• Consentimento e escopo
  O Customer Agent faz a varredura da sua loja conectada e de fontes adicionais que você adicionar. Por exemplo, ele pode rastrear páginas públicas da Shopify conectadas à sua conta da Klaviyo, mas não vai pesquisar na Wikipédia por conteúdo relacionado.
• Respeito às regras do site
  O Customer Agent verifica o robots.txt ao escolher páginas do sitemap do seu site. O Protocolo de Exclusão de Robôs (REP) é definido na RFC 9309.
• Polidez
  Quando uma solicitação de página recebe HTTP 429, o Customer Agent espera antes de tentar novamente, com intervalos de espera maiores entre as tentativas. Essas tentativas não usam o cabeçalho Retry-After para definir o tempo de espera.
• Revisitas
  O Customer Agent rastreia novamente as fontes periodicamente com a sincronização automática ativada. A frequência varia com base em sinais de mudança e na sua configuração.

Como identificar o KlaviyoAIBot

O user-agent identifica o tráfego de crawler, enquanto as assinaturas de mensagens HTTP ajudam a verificar a origem dele.

Trate as solicitações como não verificadas, a menos que você consiga validar as assinaturas delas ou confirmar a identidade por meio do Cloudflare. Uma string de agente do usuário, por si só, não comprova que uma solicitação veio da Klaviyo.

Agente do usuário

KlaviyoAIBot/1.0 (+https://help.klaviyo.com/hc/pt-br/articles/40496146232219)

Após uma resposta HTTP 400 ou 403, o Customer Agent pode tentar novamente uma solicitação de página sem esse user-agent quando o robots.txt permitir o acesso. Use a verificação de assinatura para identificar essas solicitações.

Assinaturas de mensagens HTTP (autenticação do bot da web)

O Customer Agent assina suas solicitações de página, sitemap e robots.txt usando HTTP Message Signatures RFC 9421 e o Web Bot Auth da Cloudflare. Você pode usar isso para verificar se a solicitação realmente veio do KlaviyoAIBot sem depender de listas de permissão de IP.

As solicitações assinadas incluem os cabeçalhos Signature-Agent, Signature-Input e Signature. Valide a assinatura com o diretório de chaves públicas da Klaviyo; a presença desses cabeçalhos por si só não é prova de autenticidade.

Dica: se o seu site estiver atrás do Cloudflare e a verificação do Web Bot Auth estiver ativada, o Cloudflare pode validar as assinaturas do Klaviyo e marcar o tráfego verificado com cf.bot_management.verified_bot = true. Esse campo identifica bots verificados de modo geral; ele não é específico do Klaviyo. Considere esse escopo ao usar isso em regras de WAF.

Vejo tráfego que diz ser KlaviyoAIBot. Como posso saber se é real?
Se você usa Cloudflare, verifique o status verificado e a identidade do bot da solicitação. Se você não usa Cloudflare, valide os cabeçalhos de Assinatura de Mensagem HTTP em relação ao diretório de chaves públicas da Klaviyo, de acordo com a RFC 9421 e o Web Bot Auth.

O que o KlaviyoAIBot rastreia

• Sua loja e-commerce
  O domínio de e-commerce conectado à Klaviyo.
• Fontes adicionais
  Outras fontes que você adiciona ao Customer Agent, como Help Center (por exemplo, Zendesk), portais de documentação, bases de conhecimento, blogs e artigos de notícias.
• Conteúdo público
  Use páginas acessíveis publicamente como fontes. As regras de robots orientam as varreduras do site; elas não protegem conteúdo privado. Use autenticação ou outros controles de acesso para páginas privadas.

Como controlar ou limitar o rastreamento

• Robots.txt
  Adicione ou atualize regras do robots para o user-agent KlaviyoAIBot para controlar quais páginas do sitemap são incluídas nas verificações do site. Saiba mais sobre robots.txt e REP.
• Lentidões temporárias
  Retorne HTTP 429 para fazer o Customer Agent esperar antes de tentar novamente as solicitações de página. Não dependa de respostas 503 ou de Retry-After para definir esse atraso de nova tentativa.
• Escolha o que está conectado
  Você pode adicionar ou remover os domínios e URLs conectados ao Customer Agent no Knowledge.

Para remover uma fonte, você precisa de permissão para editar o Customer Agent. Excluir uma fonte de site também remove as subpáginas indexadas dela.

1. Abra Customer Agent > Conhecimento e selecione a fonte que você quer remover.
2. Abra Mais ações e selecione Excluir. A fonte é removida, e você retorna à página Conhecimento.

Posso bloquear uma seção específica do meu site?
Sim. Use regras de robots para o KlaviyoAIBot no robots.txt para desautorizar esses caminhos nas varreduras do site. Se você precisar de ajuda para editar o arquivo, entre em contato com o administrador do seu site. Para remover conteúdo já indexado no Customer Agent, exclua a fonte do Conhecimento.

O bot obedece a sinais temporários de desaceleração?
Customer Agent espera antes de tentar novamente solicitações de página que retornam HTTP 429. O tempo de espera aumenta entre as novas tentativas. Ele não usa Retry-After para definir esse atraso, e uma resposta 503 não aciona o mesmo comportamento de nova tentativa de solicitação de página.

Uso de dados e privacidade

O KlaviyoAIBot recupera conteúdo para alimentar recursos de IA, como geração de conteúdo, respostas de IA e recomendações de produtos. O conteúdo rastreado é vinculado à sua conta e segue suas configurações.

A sincronização automática permite que o Customer Agent atualize periodicamente o conteúdo indexado a partir de páginas de origem disponíveis publicamente. Fontes sem a sincronização automática ativada precisam de uma ressincronização manual para atualizar o conteúdo. Para atualizar uma fonte, abra-a em Conhecimento e selecione Ressincronizar.

Durante uma ressincronização concluída do site, o Customer Agent remove subpáginas indexadas que não estão mais no sitemap do site ou que são bloqueadas pelo robots.txt. A remoção depende de quando o site é ressincronizado com sucesso, então uma alteração no seu site não remove imediatamente o conteúdo indexado. Para remover o conteúdo diretamente, exclua a origem dele do Knowledge.

Quando você exclui uma fonte do Customer Agent, a Klaviyo remove essa fonte e suas subpáginas indexadas da base de conhecimento da sua conta.

Vocês publicam intervalos de IP?

Não. A verificação se baseia em assinaturas criptográficas e no programa de bots verificados da Cloudflare, em vez de listas de permissões de IP estáticas.

Recursos adicionais