- Kennisbank
- Service
- Klantenagent
- Inhoudsbronsynchronisatiefouten van klantagenten controleren en oplossen
Inhoudsbronsynchronisatiefouten van klantagenten controleren en oplossen
Laatst bijgewerkt: 26 november 2025
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
-
Commerce Hub Professional, Enterprise
-
HubSpot-credits vereist
Bij het synchroniseren van inhoudsbronnen met de customer agent kun je fouten tegenkomen. Lees hieronder hoe u de synchronisatiestatus van inhoudsbronnen kunt controleren en veelvoorkomende fouten kunt oplossen om ervoor te zorgen dat uw klantagent de meest actuele inhoud gebruikt.
De synchronisatiestatus controleren van inhoudsbronnen die aan de klantenagent zijn toegevoegd
Controleer de synchronisatiestatus van alle toegevoegde inhoudsbronnen voordat u een specifieke fout oplost:
- Ga in je HubSpot-account naar Service > Klantenagent.
- Navigeer naar het tabbladBeheren .
- Klik in het linker zijbalkmenu op Inhoudsbronnen.
- Klik rechtsboven in de tabel op het tabblad Mislukt .
- Bekijk in de tabel de specifieke inhoudsbronnen die niet gesynchroniseerd zijn en de bijbehorende foutmelding.

Fouten in inhoudsbronnen begrijpen en oplossen
De kennisbron bestaat niet meer of kan niet worden bereikt
Wat de fout betekent
De inhoud kon niet worden opgehaald. Dit gebeurt als de URL een 404 Not Found-foutmelding geeft, de domeinnaam niet kon worden gevonden of de inhoud is verwijderd.
De fout oplossen
-
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 blokkeert.
-
Werk zo nodigsamen met een ontwikkelaar in je team om het IP-bereik 54.174.58.224/27 toe te staan op de pagina.
De inhoud van de website kon niet worden geladen
Wat de fout betekent
De crawler kon de pagina niet laden of renderen. Dit wordt meestal veroorzaakt door complexe JavaScript op de pagina.
De fout oplossen
- Vereenvoudig de code op de pagina.
- Kopieer en plak de inhoud in een eenvoudigere webpagina of upload het als een document (PDF, DOCX).
De website heeft een onverwacht antwoord teruggestuurd
Wat betekent de foutmelding?
De site reageerde op een manier die de crawler niet kon begrijpen. Er waren bijvoorbeeld te veel redirects of niet ondersteunde statuscodes.
De fout oplossen
-
Vraag de beheerder of ontwikkelaar van uw site om te controleren op redirect-lussen of ongebruikelijke statuscodes.
-
Corrigeer indien nodig de omleidingsconfiguratie en probeer de inhoud opnieuw toe te voegen.
Crawlen wordt geblokkeerd door het robots.txt-bestand van de site
Watde fout betekent
Het robots.txt-bestand van de site bevat regels die onze crawler geen toegang geven tot de pagina. De HubSpot crawler volgt dit standaard protocol.
Hoe de fout op te lossen
Neem contact op met de beheerder of ontwikkelaar van je site en vraag hen om de user agent van onze crawler, "HubSpot Crawler", als uitzondering toe te voegen aan de toestaanlijst. Meer informatie overhet werken met een robots.txt-bestand.De pagina kan niet worden gelezen door geautomatiseerde tools
Wat de fout betekent
Een "noindex" meta-tag in de head HTML van je pagina's voorkomt dat ze worden geïndexeerd of gecrawld.
De fout oplossen
Verwijder de metatag "noindex" van de pagina.
De pagina kon niet worden geladen omdat deze privé is of wordt geblokkeerd
Wat de fout betekent
De crawler kreeg een 401, 403 of vergelijkbare foutmelding. De pagina is waarschijnlijk beveiligd, vereist een login of wordt geblokkeerd door een firewall.
De fout oplossen
-
Maak de pagina openbaar toegankelijk.
-
Als de inhoud privé is, upload deze dan als PDF/DOCX.
-
Werk samen met de beheerder van uw site of een ontwikkelaar in uw team om ervoor te zorgen dat het IP-bereik 54.174.58.224/27 niet wordt geblokkeerd of gefilterd op de pagina die u probeerde toe te voegen.
Deze inhoud kon niet worden gesynchroniseerd omdat de URL ontbreekt
Wat de fout betekent
HubSpot pagina's (website en landingspagina's, blog posts etc.) hebben een geldige URL nodig zodat het systeem ze kan laden. De gekoppelde URL is leeg of ongeldig.
De fout oplossen
Volg de stappen in dit artikel om de URL van de HubSpot-inhoud bij te werken. Probeer de content vervolgens opnieuw toe te voegen.
De website had een serverprobleem, mogelijk door downtime of een beveiligingsbeleid
Wat de fout betekent
De server reageerde met een algemene foutmelding(500 of 503). Dit duidt meestal op tijdelijke downtime van de website of dat de server de HubSpot crawler actief blokkeert.
De fout oplossen
- Bezoek de URL om te controleren of de pagina goed laadt.
- Als de pagina goed laadt, blokkeert de site mogelijk de HubSpot crawler. Werk samen 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.
De HubSpot-inhoud is niet gepubliceerd, dus kan niet worden gesynchroniseerd
Wat de fout betekent
De HubSpot gehoste content die je probeerde toe te voegen heeft momenteel de conceptstatus en is nog niet gepubliceerd.
De fout oplossen
Publiceer de pagina en probeer de content opnieuw toe te voegen. Als je de content niet publiek toegankelijk wilt maken, lees dan meer over hoe je content privé kunt maken.
Dit bestandstype wordt niet ondersteund, dus de inhoud is niet gesynchroniseerd
Wat de fout betekent
Het bestand dat je probeerde toe te voegen heeft geen ondersteund formaat. De customer agent 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.
De fout oplossen
Converteer het bestand naar een van de ondersteunde formaten die hierboven staan vermeld en probeer de inhoud vervolgens opnieuw toe te voegen.
Het document is te groot, dus het is niet verwerkt
Wat betekent de foutmelding?
Het bestand is te groot. De klantagent ondersteunt:
- HTML/XHTML-bestanden: tot 25 MB
- Alle andere bestanden: tot 500 MB
De fout oplossen
Probeer het bestand op te splitsen in twee of meer kleinere bestanden en probeer de inhoud vervolgens opnieuw toe te voegen.
Er kon geen beveiligde verbinding worden gemaakt, dus de pagina kon niet worden gecrawld
Wat betekent de foutmelding?
Er is een fout opgetreden tijdens de poging om een beveiligde HTTPS-verbinding tot stand te brengen. Het servercertificaat kan verlopen of ongeldig zijn, of de server gebruikt een verouderde TLS-configuratie.
Hoe op te lossen
- Bezoek de URL om te controleren of de pagina goed laadt.
- Als de browser een certificaatfout weergeeft, werk dan samen 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.
