Central de conhecimento HubSpot

Examinar e solucionar problemas de erros de sincronização da fonte de conteúdo do Breeze Agent para atendimento ao cliente

Written by HubSpot Support | 26/nov/2025 9:02:50

Ao sincronizar fontes de conteúdo com o Breeze Agent para atendimento ao cliente , você pode encontrar erros. Abaixo, saiba como revisar o status de sincronização das fontes de conteúdo e solucionar erros comuns para garantir que seu Breeze Agent para atendimento ao cliente esteja usando o conteúdo mais atualizado. 

Revisar o status de sincronização de fontes de conteúdo adicionadas ao Breeze Agent para atendimento ao cliente 

Antes de solucionar um erro específico, verifique o status de sincronização de todas as fontes de conteúdo adicionadas:

  1. Navegue até o Gerenciar guia.
  2. No menu da barra lateral esquerda, clique em Fontes de conteúdo.
  3. No canto superior direito da tabela, clique na guia Falha
  4. Na tabela, revise as fontes de conteúdo específicas que falharam na sincronização e a mensagem de erro associada a elas.

Compreender e solucionar problemas de erros da fonte de conteúdo

Oe) a fonte de conhecimento não existe mais ou não pode ser acessada

O que significa o erro

Não foi possível recuperar o conteúdo. Isso acontece se a URL retornou um erro 404 Não encontrado, o domínio não pôde ser localizado ou o conteúdo foi excluído.

Como resolver o erro

  • Confirme se a URL está correta e se a página está publicamente acessível.

  • Verifique as configurações de segurança do site, como um firewall, que podem bloquear o rastreador.

  • Se necessário, trabalhe com um desenvolvedor em sua equipe para lista de permissões a faixa de IP 54.174.58.224/27 na página.

Não foi possível carregar o conteúdo do site 

O que o erro significa

O rastreador não pôde carregar ou processar a página. Isso é normalmente causado por um JavaScript complexo na página.

Como resolver o erro

  • Simplifique o código na página .
  • Copie e cole o conteúdo em uma página da Web mais simples ou carregue-o como um documento (PDF, DOCX).

O site retornou uma resposta inesperada

O que significa o erro

O site respondeu de uma maneira que o rastreador não conseguiu entender. Por exemplo, havia muitos redirecionamentos ou códigos de status sem suporte. 

Como resolver o erro

  • Peça ao administrador ou desenvolvedor do site para verificar se há redirecionar loops ou códigos de status incomuns.

  • Se necessário, corrija qualquer configuração redirecionada e tente adicionar o conteúdo novamente

O rastreamento foi bloqueado pelo arquivo robots.txt do site

O quee erro significa

O arquivo robots.txt do site contém regras que não permitem que nosso rastreador acesse a página. O crawler HubSpot segue o este protocolo padrão. 

Como resolver o erro

Entre em contato com o administrador ou desenvolvedor do site e solicite que eles adicionem o agente de usuário do nosso rastreador, "HubSpot Crawler", à lista de permissões como uma isenção. Saiba mais sobre como trabalhar com um arquivo robots.txt .

A página não pode ser lida por ferramentas automatizadas

O que erro significa

Uma marca meta "noindex" no HTML principal das suas páginas está impedindo que elas sejam indexadas ou rastreadas. 

Como resolver o erro

Remova a meta tag "noindex" da página. 

Não foi possível carregar a página porque ela é particular ou está bloqueada

O que significa o erro

O rastreador recebeu um erro 401, 403 ou semelhante. A página provavelmente está protegida, requer login ou está bloqueada por um firewall. 

Como resolver o erro

  • Tornar a página publicamente acessível.

  • Se o conteúdo for particular, carregue-o como PDF/DOCX.

  • Trabalhe com o administrador do site ou com um desenvolvedor da sua equipe para garantir que o intervalo de IP 54.174.58.224/27 não esteja sendo bloqueado ou filtrado na página que você tentou adicionar. 

Este conteúdo não pôde ser sincronizado porque sua URL está

ausenteO que o erro significa

As páginas HubSpot (site e landing pages, posts de blog etc.) precisam de um URL válido para que o sistema possa carregá-las. A URL vinculada está em branco ou é inválida. 

Como resolver o erro

Siga as etapas deste artigo para atualizar o URL do conteúdo do HubSpot. Em seguida, tente adicionar o conteúdo novamente.

O site tinha um problema com o servidor, possivelmente devido ao tempo de inatividade ou a uma política de segurança

O que o erro significa 

O servidor respondeu com um erro geral de falha (500 ou 503). Isso normalmente indica um tempo de inatividade temporário do site ou que o servidor está bloqueando ativamente o rastreador HubSpot.

Como resolver o erro 

  • Visite o URL para verificar se a página foi carregada corretamente. 
  • Se a página for carregada corretamente, talvez o site esteja bloqueando o crawler HubSpot. Trabalhe com o administrador do site ou com um desenvolvedor da sua equipe para garantir que o intervalo de IP 54.174.58.224/27 não esteja sendo bloqueado.

O conteúdo do HubSpot não está publicado e, portanto, não pode ser sincronizado 

O que significa o erro

O conteúdo hospedado do HubSpot que você tentou adicionar está no status de rascunho e ainda não foi publicado.

Como resolver o erro

Publique a página e tente adicionar o conteúdo novamente. Se você não quiser tornar o conteúdo publicamente acessível, saiba mais sobre como tornar o conteúdo privado

Não há suporte para este tipo de arquivo, portanto, o conteúdo não foi sincronizado

O que significa o erro

O arquivo que você tentou adicionar não está em um formato suportado. O Breeze Agent para atendimento ao cliente suporta os seguintes tipos de arquivo:
.docx, .htm, .xhtml, .cfg, .pptx, .mpg, .conf, .mpeg, .csv, .json, .html, .text, .txt, .mp4, .pdf, .rst, .avi, .mov, .xml, .md e .webm.

Como resolver o erro 

Converta o arquivo em um dos formatos com suporte listados acima e tente adicionar o conteúdo novamente

O documento excede os limites de tamanho e, portanto, não foi processado

O que significa o erro

O arquivo é muito grande. O Breeze Agent para atendimento ao cliente suporta:

  • Arquivos HTML/XHTML: até 25 MB
  • Todos os outros arquivos: até 500 MB

Como resolver o erro

Tente dividir o arquivo em dois ou mais arquivos menores e, em seguida, tente adicionar o conteúdo novamente

Não foi possível fazer uma conexão segura, portanto, a página não pôde ser rastreada

O que significa o erro

Erro ao tentar estabelecer uma conexão HTTPS segura. O certificado do servidor pode ter expirado ou ser inválido, ou o servidor usa uma configuração TLS desatualizada. 

Como resolver

  • Visite o URL para verificar se a página foi carregada corretamente.
  • Se o navegador mostrar um erro de certificado, trabalhe com o administrador ou desenvolvedor do site para atualizar ou configurar corretamente o certificado de segurança SSL/TLS e as configurações.