HubSpot Baza wiedzy

Przeglądanie i rozwiązywanie błędów synchronizacji źródła treści agenta klienta.

Autor: HubSpot Support | Nov 26, 2025 9:03:22 AM

Podczas synchronizacji źródeł zawartości z agentem klienta mogą wystąpić błędy. Poniżej dowiesz się, jak sprawdzić stan synchronizacji źródeł zawartości i rozwiązać typowe błędy, aby upewnić się, że agent klienta korzysta z najbardziej aktualnej zawartości.

Sprawdzanie stanu synchronizacji źródeł zawartości dodanych do agenta klienta

Przed rozwiązaniem konkretnego błędu należy sprawdzić stan synchronizacji wszystkich dodanych źródeł zawartości:

  1. .
  2. Przejdź do kartyZarządzaj .
  3. W menu na lewym pasku bocznym kliknij opcję Źródła zawartości.
  4. W prawym górnym rogu tabeli kliknij kartę Nieudane .
  5. W tabeli przejrzyj określone źródła zawartości, których synchronizacja nie powiodła się, oraz powiązane z nimi komunikaty o błędach.

Zrozumienie i rozwiązywanie błędów źródła zawartości

Źródło wiedzy już nie istnieje lub nie można do niego dotrzeć

Co oznacza ten błąd

Nie można pobrać zawartości. Dzieje się tak, jeśli adres URL zwrócił błąd404 Not Found , nie można było zlokalizować nazwy domeny lub zawartość została usunięta.

Jak rozwiązać ten błąd

  • Upewnij się, że adres URL jest poprawny, a strona jest publicznie dostępna.

  • Sprawdź ustawienia zabezpieczeń witryny, takie jak zapora sieciowa, które mogą blokować indeksowanie.

  • W razie potrzeby współpracujz programistą w swoim zespole, aby zezwolić na wyświetlanie zakresu IP 54.174.58.224/27 na stronie.

Nie można załadować zawartości witryny

Co oznacza ten błąd

Crawler nie mógł załadować lub wyrenderować strony. Zazwyczaj jest to spowodowane złożonym skryptem JavaScript na stronie.

Jak rozwiązać ten błąd

  • Uprość kod na stronie.
  • Skopiuj i wklej zawartość na prostszą stronę internetową lub prześlij ją jako dokument (PDF, DOCX).

Witryna zwróciła nieoczekiwaną odpowiedź

Co oznacza błąd

Witryna odpowiedziała w sposób niezrozumiały dla robota indeksującego. Na przykład było zbyt wiele przekierowań lub nieobsługiwanych kodów stanu.

Jak rozwiązać błąd

  • Poproś administratora lub programistę witryny o sprawdzenie pętli przekierowań lub nietypowych kodów stanu.

  • W razie potrzeby popraw konfigurację przekierowań i spróbuj ponownie dodać zawartość.

Indeksowanie jest blokowane przez plik robots.txt witryny

Cooznacza ten błąd

Plik robots.txt witryny zawiera reguły, które nie pozwalają naszemu robotowi indeksującemu na dostęp do strony. Robot indeksujący HubSpot postępuje zgodnie z tym standardowym protokołem.

Jak rozwiązać ten błąd

Skontaktuj się z administratorem lub programistą witryny i poproś o dodanie agenta użytkownika naszego crawlera, "HubSpot Crawler", do listy dozwolonych jako wyjątek. Dowiedz się więcej opracy z plikiem robots.txt.

Strona jest zablokowana przed odczytem przez zautomatyzowane narzędzia

Co oznaczaten błąd

Metatag "noindex" w nagłówku HTML stron uniemożliwia ich indeksowanie lub indeksowanie.

Jak rozwiązać ten błąd

Usuń metatag "noindex" ze strony.

Nie można załadować strony, ponieważ jest ona prywatna lub zablokowana.

Co oznacza błąd

Crawler otrzymał błąd 401, 403 lub podobny. Strona jest prawdopodobnie chroniona, wymaga logowania lub jest zablokowana przez zaporę sieciową.

Jak rozwiązać ten błąd

  • Udostępnij stronę publicznie.

  • Jeśli zawartość jest prywatna, prześlij ją zamiast tego jako plik PDF/DOCX.

  • Współpracuj z administratorem witryny lub programistą w swoim zespole, aby upewnić się, że zakres IP 54.174.58.224/27 nie jest blokowany ani filtrowany na stronie, którą próbowałeś dodać.

Nie można zsynchronizować tej zawartości, ponieważ brakuje jej adresu URL

Co oznacza ten błąd

Strony HubSpot (strona internetowa i strony docelowe, posty na blogu itp.) wymagają prawidłowego adresu URL, aby system mógł je załadować. Połączony adres URL jest pusty lub nieprawidłowy.

Jak rozwiązać ten błąd

Wykonaj kroki opisane w tym artykule, aby zaktualizować adres URL treści HubSpot. Następnie spróbuj ponownie dodać zawartość.

Witryna miała problem z serwerem, prawdopodobnie z powodu przestoju lub polityki bezpieczeństwa

Co oznacza ten błąd

Serwer odpowiedział ogólnym błędem niepowodzenia(500 lub 503). Zazwyczaj wskazuje to na tymczasowy przestój witryny lub na to, że serwer aktywnie blokuje crawlera HubSpot.

Jak rozwiązać ten błąd

  • Odwiedź adres URL, aby upewnić się, że strona ładuje się prawidłowo.
  • Jeśli strona ładuje się poprawnie, witryna może blokować robota HubSpot. Skontaktuj się z administratorem witryny lub programistą w swoim zespole, aby upewnić się, że zakres adresów IP 54.174.58.224/27 nie jest blokowany.

Zawartość HubSpot nie jest opublikowana, więc nie można jej zsynchronizować.

Co oznacza ten błąd

Treść hostowana przez HubSpot, którą próbujesz dodać, ma obecnie status wersji roboczej i nie została jeszcze opublikowana.

Jak rozwiązać ten błąd

Opublikuj stronę, a następnie spróbuj ponownie dodać zawartość. Jeśli nie chcesz, aby zawartość była publicznie dostępna, dowiedz się więcej o tym, jak ustawić zawartość jako prywatną.

Ten typ pliku nie jest obsługiwany, więc zawartość nie została zsynchronizowana.

Co oznacza ten błąd

Plik, który próbowano dodać, nie ma obsługiwanego formatu. Agent klienta obsługuje następujące typy plików:
.docx, .htm, .xhtml, .cfg, .pptx, .mpg, .conf, .mpeg, .csv, .json, .html, .text, .txt, .mp4, .pdf, .rst, .avi, .mov, .xml, .md i .webm.

Jak rozwiązać ten błąd

Przekonwertuj plik na jeden z obsługiwanych formatów wymienionych powyżej, a następnie spróbuj ponownie dodać zawartość.

Dokument przekracza limit rozmiaru, więc nie został przetworzony

Co oznacza ten błąd

Plik jest zbyt duży. Agent klienta obsługuje:

  • Pliki HTML/XHTML: do 25 MB
  • Wszystkie inne pliki: do 500 MB

Jak rozwiązać błąd

Spróbuj podzielić plik na dwa lub więcej mniejszych plików, a następnie spróbuj ponownie dodać zawartość.

Nie można nawiązać bezpiecznego połączenia, więc strona nie może zostać zaindeksowana.

Co oznacza ten błąd

Wystąpił błąd podczas próby nawiązania bezpiecznego połączenia HTTPS. Certyfikat serwera może być nieważny lub wygasły, lub serwer używa nieaktualnej konfiguracji TLS.

Jak rozwiązać problem

  • Odwiedź adres URL, aby upewnić się, że strona ładuje się poprawnie.
  • Jeśli przeglądarka pokazuje błąd certyfikatu, współpracuj z administratorem witryny lub programistą, aby zaktualizować lub poprawnie skonfigurować certyfikat bezpieczeństwa SSL / TLS i ustawienia witryny.