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

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

고객 에이전트에 추가된 콘텐츠 소스의 동기화 상태 확인 

특정 오류를 해결하기 전에, 추가된 콘텐츠 소스의 동기화 상태를 확인하십시오:

1. HubSpot 계정에서 더 보기를 클릭한 다음 서비스 > 고객 에이전트로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 서비스 > 고객 에이전트로 이동하세요.
2. 왼쪽 사이드바 메뉴에서 ‘훈련’ > ‘지식’을 클릭합니다. 
3. 표의 오른쪽 상단에서 ‘실패(Failed)’ 탭 을 클릭합니다. 
4. 표에서 동기화에 실패한 특정 콘텐츠 소스와 해당 오류 메시지를 확인하십시오.

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

이이 지식 소스가 더 이상 존재하지 않거나 연결할 수 없습니다

오류 의미

콘텐츠를 가져올 수 없습니다. 이 오류는 URL에서 404 Not Found 오류가 반환되었거나, 도메인 이름을 찾을 수 없거나, 콘텐츠가 삭제된 경우에 발생합니다.

오류 해결 방법

• URL이 올바른지, 그리고 해당 페이지에 누구나 접근할 수 있는지 확인하십시오.

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

• 필요한 경우,팀 내 개발자와 협력하여 해당 페이지에서 IP 범위 54.174.58.224/27을 허용 목록에 추가하십시오.또한 IP 범위 API를 사용하여 HubSpot에서 사용하는 최신 IP 주소 목록을 확인할수도 있습니다 .

웹사이트 콘텐츠를 불러올 수 없습니다 

오류 의미

크롤러가 페이지를 불러오거나 렌더링할 수 없었습니다. 이는 일반적으로 페이지에 포함된 복잡한 JavaScript로 인해 발생합니다.

오류 해결 방법

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

웹사이트에서 예기치 않은 응답이 반환되었습니다

오류 의미

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

오류 해결 방법

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

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

사이트의 robots.txt 파일로 인해 크롤링이 차단되었습니다

이오류 의미

이 오류의의미: 사이트의 robots.txt 파일에 크롤러가 해당 페이지에 액세스하는 것을 허용하지 않는 규칙이 포함되어 있습니다. HubSpot 크롤러는 이 표준 프로토콜을따릅니다 .

오류 해결 방법:

자동화된 도구가 해당 페이지를 읽을 수 없도록 차단되었습니다

이 오류 의미

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

오류 해결 방법

페이지에서 "noindex" 메타 태그를 제거하십시오.

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

오류 의미

크롤러가 401, 403 또는 이와 유사한 오류를 받았습니다. 해당 페이지는 보호되어 있거나, 로그인이 필요하거나, 방화벽에 의해 차단된 것으로 보입니다.

오류 해결 방법

• 페이지를 누구나 접근할 수 있도록 설정하세요.

• 콘텐츠가 비공개인 경우, 대신 PDF/DOCX 형식으로 업로드하세요.

• 사이트 관리자나 팀의 개발자와 협력하여 추가하려는 페이지에서 IP 범위 54.174.58.224/27이 차단되거나 필터링되지 않도록 확인하십시오. 또한IP 범위 API를 사용하여 HubSpot에서 사용하는 최신 IP 주소 목록을 조회할 수도 있습니다.

이 콘텐츠는 URL에

이 누락되어 동기화할 수 없습니다. 오류 설명

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

오류 해결 방법

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

웹사이트에 서버 문제가 발생했습니다. 이는 서비스 중단이나 보안 정책 때문일 수 있습니다.

오류 의미 

서버에서 일반 오류(500 또는 503)를 반환했습니다. 이는 일반적으로 사이트가 일시적으로 다운되었거나, 서버가 HubSpot 크롤러를 적극적으로 차단하고 있음을 나타냅니다.

오류 해결 방법 

• 해당 URL에 접속하여 페이지가 정상적으로 로드되는지 확인하십시오. 
• 페이지가 정상적으로 로드된다면, 사이트에서 HubSpot 크롤러를 차단하고 있을 수 있습니다. 사이트 관리자나 팀의 개발자와 협력하여 IP 범위 54.174.58.224/27이 차단되지 않았는지 확인하십시오. 또한IP 범위 API를 사용하여 HubSpot에서 사용하는 최신 IP 주소 목록을 조회할 수도 있습니다.

HubSpot 콘텐츠가 게시되지 않아 동기화할 수 없습니다

오류 의미

추가하려고 한 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 파일: 최대 25 MB
• 기타 모든 파일: 최대 500 MB

오류 해결 방법

파일을 두 개 이상의 작은 파일로 분할한 후, 콘텐츠를 다시 추가해 보십시오.

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

오류 의미

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

해결 방법

• 해당 URL에 접속하여 페이지가 정상적으로 로드되는지 확인하세요.
• 브라우저에 인증서 오류가 표시되면, 사이트 관리자나 개발자와 협력하여 웹사이트의 SSL/TLS 보안 인증서 및 설정을 업데이트하거나 올바르게 구성하십시오.