Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

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

Ultima atualização: 19 de Março de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Ao sincronizar fontes de conteúdo com o Customer Agent , 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 das fontes de conteúdo adicionadas ao Customer Agent 

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

  1. No seu portal da HubSpot, acesse Atendimento > Agente de atendimento ao cliente.
  2. No menu da barra lateral esquerda, clique em Treinar > conhecimento.
  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.

cliente-agente-mensagens-de-erro

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 retornar um erro 404 Não encontrado, o nome do domínio não puder ser localizado ou o conteúdo tiver sido 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, conversecom um desenvolvedor da sua equipe para permitir a lista de permissões do intervalo de IP 54.174.58.224/27 na página. YVocê também pode usar a API de intervalo de IP para recuperar a lista mais atualizada de endereços IP usados pelo HubSpot.

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 de redirecionar e adicione 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. Você também pode usara API de intervalo de IP para recuperar a lista mais atualizada de endereços IP usados pelo HubSpot.

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. Você também pode usara API de intervalo de IP para recuperar a lista mais atualizada de endereços IP usados pelo HubSpot.

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 Customer Agent 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 para um dos formatos suportados 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 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 pode estar usando 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.
Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.