Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Esaminare e risolvere gli errori di sincronizzazione dell'origine dei contenuti degli agenti dei clienti

Ultimo aggiornamento: 26 novembre 2025

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Quando si sincronizzano le fonti di contenuto con l'agente clienti, è possibile che si verifichino degli errori. Di seguito, scoprirete come controllare lo stato di sincronizzazione delle fonti di contenuto e come risolvere gli errori più comuni per garantire che l'agente clienti utilizzi i contenuti più aggiornati.

Controllare lo stato di sincronizzazione delle fonti di contenuto aggiunte all'agente cliente

Prima di risolvere un errore specifico, controllare lo stato di sincronizzazione di tutte le fonti di contenuto aggiunte:

  1. Nel tuo account HubSpot, passa a Servizio clienti > Agente per i clienti.
  2. Passare alla schedaGestione .
  3. Nel menu della barra laterale sinistra, fare clic su Sorgenti di contenuto.
  4. Nella tabella in alto a destra, fare clic sulla scheda Non riuscito .
  5. Nella tabella, esaminare le fonti di contenuto specifiche che non sono riuscite a sincronizzarsi e il messaggio di errore ad esse associato.

customer-agent-error-messages

Comprendere e risolvere gli errori dell'origine dei contenuti

La fonte di conoscenza non esiste più o non può essere raggiunta

Cosa significa l'errore

Non è stato possibile recuperare il contenuto. Questo accade se l'URL ha restituito un errore404 Not Found , se non è stato possibile trovare il nome del dominio o se il contenuto è stato cancellato.

Come risolvere l'errore

  • Verificare che l'URL sia corretto e che la pagina sia accessibile pubblicamente.

  • Controllare le impostazioni di sicurezza del sito web, ad esempio un firewall, che potrebbe bloccare il crawler.

  • Se necessario,collaborare con uno sviluppatore del proprio team per consentire l'inserimento dell'elenco dell'intervallo IP 54.174.58.224/27 nella pagina.

Non è stato possibile caricare il contenuto del sito web

Cosa significa l'errore

Il crawler non è stato in grado di caricare o renderizzare la pagina. Questo errore è in genere causato da un JavaScript complesso nella pagina.

Come risolvere l'errore

  • Semplificare il codice della pagina.
  • Copiare e incollare il contenuto in una pagina web più semplice o caricarlo come documento (PDF, DOCX).

Il sito web ha restituito una risposta inattesa

Cosa significa l'errore

Il sito ha risposto in un modo che il crawler non è riuscito a capire. Ad esempio, c'erano troppi reindirizzamenti o codici di stato non supportati.

Come risolvere l'errore

  • Chiedere all'amministratore o allo sviluppatore del sito di verificare la presenza di cicli di reindirizzamento o di codici di stato insoliti.

  • Se necessario, correggere la configurazione dei reindirizzamenti e riprovare ad aggiungere il contenuto.

Il crawling è bloccato dal file robots.txt del sito

Cosasignifica l'errore

Il file robots.txt del sito contiene regole che non consentono al nostro crawler di accedere alla pagina. Il crawler di HubSpot segue il protocollo standard.

Come risolvere l'errore

Contattare l'amministratore o lo sviluppatore del sito e chiedere di aggiungere l'agente utente del nostro crawler, "HubSpot Crawler", all'elenco dei permessi come esenzione. Per saperne di più su comelavorare con un file robots.txt.

La pagina è bloccata per la lettura da parte di strumenti automatizzati

Cosa significaquesto errore

Un meta tag "noindex" nella testa HTML delle pagine impedisce l'indicizzazione o il crawling delle stesse.

Come risolvere l'errore

Rimuovere il meta tag "noindex" dalla pagina.

La pagina non può essere caricata perché è privata o bloccata

Cosa significa l'errore

Il crawler ha ricevuto un errore 401, 403 o simile. La pagina è probabilmente protetta, richiede un login o è bloccata da un firewall.

Come risolvere l'errore

  • Rendere la pagina pubblicamente accessibile.

  • Se il contenuto è privato, caricatelo come PDF/DOCX.

  • Collaborare con l'amministratore del sito o con uno sviluppatore del team per assicurarsi che l'intervallo IP 54.174.58.224/27 non sia bloccato o filtrato nella pagina che si è tentato di aggiungere.

Non è stato possibile sincronizzare questo contenuto perché l'URL è mancante.

Cosa significa l'errore

Le pagine di HubSpot (siti web e landing page, post di blog ecc.) hanno bisogno di un URL valido per essere caricate dal sistema. L'URL collegato è vuoto o non valido.

Come risolvere l'errore

Seguite i passaggi di questo articolo per aggiornare l'URL del contenuto di HubSpot. Quindi, tentare di aggiungere nuovamente il contenuto.

Il sito web ha avuto un problema con il server, forse a causa di un'interruzione dell'attività o di una politica di sicurezza.

Cosa significa l'errore

Il server ha risposto con un errore generale di errore(500 o 503). Ciò indica in genere un fermo temporaneo del sito o che il server sta bloccando attivamente il crawler di HubSpot.

Come risolvere l'errore

  • Visitate l'URL per verificare che la pagina venga caricata correttamente.
  • Se la pagina viene caricata correttamente, è possibile che il sito stia bloccando il crawler di HubSpot. Collaborate con l'amministratore del sito o con uno sviluppatore del vostro team per assicurarvi che l'intervallo IP 54.174.58.224/27 non sia bloccato.

Il contenuto di HubSpot non è pubblicato, quindi non può essere sincronizzato.

Cosa significa l'errore

Il contenuto ospitato da HubSpot che si è cercato di aggiungere è attualmente in stato di bozza e non è ancora stato pubblicato.

Come risolvere l'errore

Pubblicare la pagina, quindi tentare di aggiungere di nuovo il contenuto. Se non si desidera rendere il contenuto accessibile pubblicamente, saperne di più su come rendere il contenuto privato.

Questo tipo di file non è supportato, quindi il contenuto non è stato sincronizzato.

Cosa significa l'errore

Il file che si è cercato di aggiungere non è in un formato supportato. L'agente clienti supporta i seguenti tipi di file:
.docx, .htm, .xhtml, .cfg, .pptx, .mpg, .conf, .mpeg, .csv, .json, .html, .text, .txt, .mp4, .pdf, .rst, .avi, .mov, .xml, .md e .webm.

Come risolvere l'errore

Convertire il file in uno dei formati supportati elencati sopra, quindi tentare di aggiungere nuovamente il contenuto.

Il documento supera i limiti di dimensione, quindi non è stato elaborato.

Cosa significa questo errore

Il file è troppo grande. L'agente cliente supporta:

  • File HTML/XHTML: fino a 25 MB
  • Tutti gli altri file: fino a 500 MB

Come risolvere l'errore

Provare a dividere il file in due o più file più piccoli, quindi tentare di aggiungere nuovamente il contenuto.

Non è stato possibile stabilire una connessione sicura, pertanto la pagina non è stata sottoposta a crawling.

Cosa significa l'errore

Si è verificato un errore durante il tentativo di stabilire una connessione sicura HTTPS. Il certificato del server potrebbe essere scaduto o non valido, oppure il server utilizza una configurazione TLS non aggiornata.

Come risolvere

  • Visitare l'URL per verificare che la pagina venga caricata correttamente.
  • Se il browser mostra un errore di certificato, collaborate con l'amministratore del sito o con lo sviluppatore per aggiornare o configurare correttamente il certificato e le impostazioni di sicurezza SSL/TLS del sito.
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.