- Kennisbank
- Service
- Klantenagent
- Fouten bij het synchroniseren van de inhoudsbronnen van klantenservicemedewerkers controleren en oplossen
Fouten bij het synchroniseren van de inhoudsbronnen van klantenservicemedewerkers controleren en oplossen
Laatst bijgewerkt: 18 augustus 2026
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
-
Marketing Hub Professional, Enterprise
-
Sales Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional, Enterprise
-
Content Hub Professional, Enterprise
-
Smart CRM Professional, Enterprise
-
Revenue Hub Professional, Enterprise
-
HubSpot-credits vereist
Bij het synchroniseren van inhoudsbronnen met de klantagent kunnen er fouten optreden. Hieronder leest u hoe u de synchronisatiestatus van inhoudsbronnen kunt controleren en veelvoorkomende fouten kunt oplossen, zodat uw klantagent altijd de meest actuele inhoud gebruikt.
Controleer de synchronisatiestatus van de inhoudsbronnen die aan de klantagent zijn toegevoegd
Controleer, voordat u een specifieke fout oplost, de synchronisatiestatus van de toegevoegde inhoudsbronnen:
- Klik in je HubSpot-account op Meer en navigeer vervolgens naar Service > Klantenagent. Als Meer niet in je account verschijnt, navigeer dan direct naar Service > Klantenagent.
- Klik in het menu aan de linkerkant op Train > Knowledge.
- Klik rechtsboven in de tabel op het tabblad Mislukt .
- Bekijk in de tabel welke specifieke inhoudsbronnen niet konden worden gesynchroniseerd en welke foutmelding daarbij hoort.

Inhoudsbronfouten begrijpen en oplossen
De kennisbron bestaat niet meer of is niet bereikbaar
Wat de foutmelding betekent
De inhoud kon niet worden opgehaald. Dit gebeurt als de URL een 404 Not Found-foutmelding retourneerde, de domeinnaam niet kon worden gevonden of de inhoud is verwijderd.
Hoe de fout op te lossen
-
Controleer of de URL correct is en of de pagina openbaar toegankelijk is.
-
Controleer de beveiligingsinstellingen van de website, zoals een firewall, die de crawler mogelijk blokkeren.
-
Werk indien nodigsamen met een ontwikkelaar uit je team om het IP-bereik 54.174.58.224/27 op de pagina toe te voegen aan de lijst met toegestane adressen.Je kunt ook de IP-bereik-API gebruiken om de meest actuele lijst met IP-adressen op te halen die door HubSpot worden gebruikt.
De inhoud van de website kon niet worden geladen
Wat de fout betekent
De crawler kon de pagina niet laden of weergeven. Dit wordt meestal veroorzaakt door complexe JavaScript-code op de pagina.
Hoe u de fout kunt oplossen
- Vereenvoudig de code op de pagina.
- Kopieer en plak de inhoud in een eenvoudigere webpagina of upload deze als document (PDF, DOCX).
De website heeft een onverwacht antwoord teruggestuurd
Wat de fout betekent
De site reageerde op een manier die de crawler niet kon begrijpen. Er waren bijvoorbeeld te veel omleidingen of niet-ondersteunde statuscodes.
Hoe de fout op te lossen
-
Vraag de beheerder of ontwikkelaar van je site om te controleren op omleidingslussen of ongebruikelijke statuscodes.
-
Corrigeer indien nodig de configuratie van de omleidingen envoeg de inhoud opnieuw toe.
Het crawlen wordt geblokkeerd door het robots.txt-bestand van de site
Wat dede fout betekent
Het robots.txt-bestand van de site bevat regels die onze crawler de toegang tot de pagina ontzeggen. De HubSpot-crawler volgt dit standaardprotocol.
Hoe u de fout kunt oplossen
Neem contact op met uw sitebeheerder of ontwikkelaar en vraag hen om de user-agent van onze crawler, "HubSpot Crawler", als uitzondering toe te voegen aan de lijst met toegestane gebruikers. Lees meer over het werken met een robots.txt-bestand.De pagina is geblokkeerd voor automatische tools
Wat betekent deze fout betekent
Een "noindex"-metatag in deHTML-head vanje pagina's zorgt ervoor dat ze niet kunnen worden geïndexeerd of gecrawld.
Hoe u de fout kunt oplossen
Verwijder de "noindex"-metatag van de pagina.
De pagina kon niet worden geladen omdat deze privé is of geblokkeerd
Wat de fout betekent
De crawler kreeg een 401-, 403- of soortgelijke foutmelding. De pagina is waarschijnlijk beveiligd, vereist een aanmelding of wordt geblokkeerd door een firewall.
Hoe u de fout kunt oplossen
-
Maak de pagina openbaar toegankelijk.
-
Als de inhoud privé is, upload deze dan in plaats daarvan als PDF/DOCX.
-
Neem contact op met je sitebeheerder of een ontwikkelaar in je team om ervoor te zorgen dat het IP-bereik 54.174.58.224/27 niet wordt geblokkeerd of gefilterd op de pagina die je probeerde toe te voegen. Je kunt ookde IP-bereik-API gebruiken om de meest actuele lijst met IP-adressen op te halen die door HubSpot worden gebruikt.
Deze inhoud kon niet worden gesynchroniseerd omdat de URL ontbreekt:
Wat de foutmelding betekent
HubSpot-pagina’s (website- en landingspagina’s, blogberichten enz.) hebben een geldige URL nodig zodat het systeem ze kan laden. De gekoppelde URL is leeg of ongeldig.
Hoe de fout op te lossen
Volg de stappen in dit artikel om de URL van de HubSpot-inhoud bij te werken. Probeer vervolgens de inhoud opnieuw toe te voegen.
De website had een serverprobleem, mogelijk als gevolg van downtime of een beveiligingsbeleid
Wat de foutmelding betekent
De server reageerde met een algemene foutmelding (500 of 503). Dit duidt doorgaans op tijdelijke downtime van de site, of dat de server de HubSpot-crawler actief blokkeert.
Hoe de fout op te lossen
- Ga naar de URL om te controleren of de pagina correct wordt geladen.
- Als de pagina correct wordt geladen, blokkeert de website mogelijk de HubSpot-crawler. Neem contact op met je websitebeheerder of een ontwikkelaar in je team om ervoor te zorgen dat het IP-bereik 54.174.58.224/27 niet wordt geblokkeerd. Je kunt ookde IP-bereik-API gebruiken om de meest actuele lijst met IP-adressen op te vragen die door HubSpot worden gebruikt.
De HubSpot-inhoud is niet gepubliceerd en kan daarom niet worden gesynchroniseerd
Wat de foutmelding betekent
De door HubSpot gehoste inhoud die je hebt geprobeerd toe te voegen, heeft momenteel de status ‘concept’ en is nog niet gepubliceerd.
Hoe u de fout kunt oplossen
Publiceer de pagina en probeer vervolgens de inhoud opnieuw toe te voegen. Als je de inhoud niet openbaar toegankelijk wilt maken, lees dan meer over hoe je inhoud privé kunt maken.
De inhoud kon niet worden gesynchroniseerd vanwege een inhoudsbeleid
Wat de fout betekent
HubSpot kon de inhoud niet indexeren omdat deze mogelijk in strijd is met de Algemene voorwaarden of beleid voor aanvaardbaar gebruik.
Hoe u de fout kunt oplossen
-
Controleer de inhoud en verwijder of werk alles bij dat mogelijk in strijd is met het inhoudsbeleid van HubSpot.
-
Als u denkt dat de inhoud ten onrechte is gemarkeerd, neem dan contact op met HubSpot Support en vermeld de URL van de betreffende inhoudsbron.
De inhoudsverwijzing is ongeldig
Wat de foutmelding betekent
HubSpot kon de inhoud niet synchroniseren omdat de gekoppelde HubSpot-inhoudsbron niet kan worden gevonden of niet langer geldig is. Dit kan gebeuren als de inhoud is verwijderd of als de bron niet langer verwijst naar een bestaande HubSpot-pagina of blogbericht.
Hoe u de fout kunt oplossen
-
Controleer of de HubSpot-inhoud nog steeds bestaat en gepubliceerd is.
-
Verwijder de betreffende inhoudsbron en voeg deze vervolgens opnieuw toe met de juiste HubSpot-inhoud, zoals een webpagina of blogbericht.
-
Als het opnieuw toevoegen van de inhoudsbron het probleem niet oplost, neem dan contact op met HubSpot Support.
Dit bestandstype wordt niet ondersteund, dus de inhoud is
niet
gesynchroniseerd
Wat de foutmelding betekent
Het bestand dat u probeerde toe te voegen, heeft geen ondersteunde indeling. De klantagent ondersteunt de volgende bestandstypen:
.docx, .htm, .xhtml, .cfg, .pptx, .mpg, .conf, .mpeg, .csv, .json, .html, .text, .txt, .mp4, .pdf, .rst, .avi, .mov, .xml, .md en .webm.
Hoe de fout op te lossen
Converteer het bestand naar een van de hierboven genoemde ondersteunde formaten en probeer de inhoud vervolgens opnieuw toe te voegen.
Het document overschrijdt de maximale grootte en is daarom niet verwerkt
Wat de fout betekent
Het bestand is te groot. De klantenservice ondersteunt:
- HTML/XHTML-bestanden: maximaal 25 MB
- Alle andere bestanden: maximaal 500 MB
Hoe de fout op te lossen
Probeer het bestand op te splitsen in twee of meer kleinere bestanden en probeer vervolgens de inhoud opnieuw toe te voegen.
Er kon geen beveiligde verbinding tot
stand
worden gebracht, waardoor de pagina niet kon worden gecrawld
Wat de fout betekent
Er is een fout opgetreden bij het tot stand brengen van een beveiligde HTTPS-verbinding. Het servercertificaat is mogelijk verlopen of ongeldig, of de server gebruikt mogelijk een verouderde TLS-configuratie.
Hoe op te lossen
- Ga naar de URL om te controleren of de pagina correct wordt geladen.
- Als de browser een certificaatfout weergeeft, neem dan contact op met de beheerder of ontwikkelaar van uw site om het SSL/TLS-beveiligingscertificaat en de instellingen van de website bij te werken of correct te configureren.
