콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

고객 상담원 콘텐츠 소스 동기화 오류 검토 및 문제 해결

마지막 업데이트 날짜: 2025년 11월 26일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

고객 상담원과 콘텐츠 소스를 동기화할 때 오류가 발생할 수 있습니다. 아래에서 콘텐츠 소스의 동기화 상태를 검토하고 일반적인 오류를 해결하여 고객 상담원이 최신 콘텐츠를 사용하고 있는지 확인하는 방법에 대해 알아보세요.

고객 상담원에게 추가된 콘텐츠 소스의 동기화 상태 검토하기

특정 오류를 해결하기 전에 추가된 모든 콘텐츠 소스의 동기화 상태를 확인하세요:

  1. HubSpot 계정에서 서비스 > 고객 상담원으로 이동합니다.
  2. 관리 탭으로이동합니다 .
  3. 왼쪽 사이드바 메뉴에서 콘텐츠 소스를클릭합니다 .
  4. 표의 오른쪽 상단에서 실패 탭을 클릭합니다.
  5. 표에서 동기화에 실패한 특정 콘텐츠 소스와 이와 관련된 오류 메시지를 검토합니다.

customer-agent-error-messages

콘텐츠 소스 오류 이해 및 문제 해결

지식창고가 더 이상 존재하지 않거나 연결할 수 없음

오류의 의미

콘텐츠를 검색할 수 없습니다. URL에서 404 찾을 수 없음 오류가반환되었거나 도메인 이름을 찾을 수 없거나 콘텐츠가 삭제된 경우에 발생합니다.

오류를 해결하는 방법

  • URL이 올바른지, 페이지가 공개적으로 액세스할 수 있는지 확인합니다.

  • 크롤러를 차단할 수 있는 방화벽 등 웹사이트의 보안 설정을 확인합니다.

  • 필요한 경우팀 내 개발자와 협력하여 페이지에 54.174.58.224/27 IP 범위를 허용하세요.

웹사이트 콘텐츠를 로드할 수 없습니다.

오류의 의미

크롤러가 페이지를 로드하거나 렌더링할 수 없습니다. 이 오류는 일반적으로 페이지의 복잡한 자바스크립트로 인해 발생합니다.

오류 해결 방법

  • 페이지의 코드를 단순화합니다.
  • 콘텐츠를 더 간단한 웹페이지에 복사하여 붙여넣거나 문서(PDF, DOCX)로 업로드합니다.

웹사이트에서 예기치 않은 응답이 반환됨

오류의 의미

사이트가 크롤러가 이해할 수 없는 방식으로 응답했습니다. 예를 들어 리디렉션이 너무 많거나 지원되지 않는 상태 코드가 있었습니다.

오류 해결 방법

  • 사이트 관리자나 개발자에게 리디렉션 루프 또는 비정상적인 상태 코드가 있는지 확인하도록 요청하세요.

  • 필요한 경우 리디렉션 구성을 수정하고 콘텐츠를 다시 추가해 보세요.

사이트의 robots.txt 파일에 의해 크롤링이 차단됨

오류의 의미

사이트의 robots.txt 파일에 크롤러가 페이지에 액세스할 수 없도록 하는 규칙이 포함되어 있습니다. HubSpot 크롤러는 이 표준 프로토콜을따릅니다 .

오류를 해결하는 방법

사이트 관리자 또는 개발자에게 연락하여 크롤러의 사용자 에이전트인 "HubSpot 크롤러"를 허용 목록에 예외로 추가해 달라고 요청하세요.robots.txt 파일 작업에 대해 자세히 알아보세요.

자동화된 도구에서 페이지를 읽지 못하도록 차단됨

오류의 의미

페이지의 헤드 HTML에 있는 "noindex" 메타태그로 인해 페이지가 색인되거나 크롤링되지 않습니다.

오류 해결 방법

페이지에서 "noindex" 메타 태그를 제거합니다.

비공개 페이지이거나 차단되어 페이지를 로드할 수 없습니다.

오류의 의미

크롤러에서 401, 403 또는 이와 유사한 오류가 발생했습니다. 페이지가 보호되어 있거나 로그인이 필요하거나 방화벽에 의해 차단된 페이지일 가능성이 높습니다.

오류를 해결하는 방법

  • 페이지를 공개적으로 액세스할 수 있도록 설정합니다.

  • 콘텐츠가 비공개인 경우 PDF/DOCX로 업로드하세요.

  • 사이트 관리자 또는 팀 내 개발자와 협력하여 추가하려는 페이지에서 54.174.58.224/27 IP 범위가 차단되거나 필터링되지 않았는지 확인하세요.

URL이 누락되어 콘텐츠를 동기화할 수 없습니다.

이 오류의 의미

HubSpot 페이지(웹사이트 및 랜딩 페이지, 블로그 게시물 등)는 시스템에서 로드할 수 있도록 유효한 URL이 필요합니다. 연결된 URL이 비어 있거나 유효하지 않습니다.

오류를 해결하는 방법

이 문서의 단계에 따라 HubSpot 콘텐츠의 URL을 업데이트합니다. 그런 다음 콘텐츠를 다시 추가해 보세요.

다운타임 또는 보안 정책으로 인해 웹사이트에 서버 문제가 발생했습니다.

오류의 의미

서버가 일반 오류 오류(500 또는 503)로 응답했습니다. 이는 일반적으로 일시적인 사이트 다운타임이 발생했거나 서버가 HubSpot 크롤러를 적극적으로 차단하고 있음을 나타냅니다.

오류를 해결하는 방법

  • URL을 방문하여 페이지가 제대로 로드되는지 확인합니다.
  • 페이지가 올바르게 로드되면 사이트가 HubSpot 크롤러를 차단하고 있을 수 있습니다. 사이트 관리자 또는 팀의 개발자와 협력하여 IP 범위 54.174.58.224/27이 차단되고 있지 않은지 확인하세요.

HubSpot 콘텐츠가 게시되지 않았으므로 동기화할 수 없습니다.

오류의 의미

추가하려는 HubSpot 호스팅 콘텐츠가 현재 초안 상태이며 아직 게시되지 않았습니다.

오류를 해결하는 방법

페이지를 게시한 다음 콘텐츠를 다시 추가합니다. 콘텐츠를 공개적으로 액세스하도록 설정하지 않으려면 콘텐츠를 비공개로 설정하는 방법에 대해 자세히 알아보세요.

이 파일 형식은 지원되지 않으므로 콘텐츠가 동기화되지 않았습니다.

오류의 의미

추가하려는 파일이 지원되는 형식이 아닙니다. 고객 상담원이 지원하는 파일 형식은 다음과 같습니다:
.docx, .htm, .xhtml, .cfg, .pptx, .mpg, .conf, .mpeg, .csv, .json, .html, .text, .txt, .mp4, .pdf, .rst, .avi, .mov, .xml, .md 및 .webm입니다.

오류 해결 방법

위에 나열된 지원되는 형식 중 하나로 파일을 변환한 다음 콘텐츠를 다시 추가해 보세요.

문서가 크기 제한을 초과하여 처리되지 않았습니다.

이 오류의 의미

파일이 너무 큽니다. 고객 상담원이 지원합니다:

  • HTML/XHTML 파일: 최대 25MB
  • 그 외 모든 파일: 최대 500MB

오류 해결 방법

파일을 두 개 이상의 작은 파일로 분할한 다음 콘텐츠를 다시 추가해 보세요.

보안 연결을 설정할 수 없어 페이지를 크롤링할 수 없습니다.

오류의 의미

보안 HTTPS 연결을 설정하는 동안 오류가 발생했습니다. 서버 인증서가 만료되었거나 유효하지 않거나 서버가 오래된 TLS 구성을 사용하고 있을 수 있습니다.

해결 방법

  • URL을 방문하여 페이지가 제대로 로드되는지 확인합니다.
  • 브라우저에 인증서 오류가 표시되면 사이트 관리자 또는 개발자와 협력하여 웹사이트의 SSL/TLS 보안 인증서 및 설정을 업데이트하거나 올바르게 구성하세요.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.