지식창고 문서 가져오기
마지막 업데이트 날짜: 2026년 1월 15일
명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.
-
Service Hub Professional, Enterprise
Freshdesk, 헬프 스카우트, Zendesk 또는 Intercom에 호스팅된 외부 지식창고에서 HubSpot으로 문서를 가져오세요. CSV 파일에서 지식창고를 가져올 수도 있습니다.
시작하기 전에
지식창고 문서를 가져오기 전에 미리 수행해야 할 단계와 기능의 제한 사항 및 사용 시 발생할 수 있는 결과를 완전히 이해해야 합니다.
지식창고 문서를 가져오려면 지정된 서비스 허브 시트가 필요합니다.
권한 필요 다음 권한이 필요합니다:
- 지식창고 문서를 가져오려면 지식창고설정 권한이 필요합니다.
- 지식창고 문서를 편집하고 게시하려면 편집 및 게시 권한이 있는서비스 액세스 권한이 필요합니다.
제한 사항 및 고려 사항 이해하기
-
지식창고로 테이블 가져오기는 지원되지 않습니다.
-
각 가져오기에는 400개 문서로 제한되어 있습니다.
- 스마트 복사를 사용하여 홈페이지 URL에서 지식창고를 가져오는 것은 새로 만들어지고 마이그레이션된 지식창고에만 사용할 수 있습니다.
- CSV 파일에서 지식창고를 가져오려면 다음 필드가 필요합니다:
- URL
- 제목
- 카테고리
- 문서 본문
홈페이지 URL에서 지식창고 가져오기
- HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 콘텐츠 > 지식창고로 이동합니다.
- 현재 보기 섹션에서 첫 번째 드롭다운 메뉴를 클릭하고 지식창고 가져오기를 선택합니다. 브랜드 추가 기능이 있는 계정에서는 두 번째 드롭다운 메뉴가 표시됩니다.
- 지식창고 가져오기 페이지의 왼쪽 아래에서 이전을 클릭합니다.
- 스마트 복사 옵션을 선택한 다음 다음을 클릭합니다.
- 외부 지식창고 홈페이지의 URL을 입력합니다.
- 문서를 가져오기 위한 옵션을 선택합니다:
- 가져오기 및 게시: 가져온 문서가 방문자들이 볼 수 있도록 실시간으로 게시됩니다.
- 초안으로 가져오기: 문서를 지식창고에서 초안으로 가져옵니다. 방문자들은 게시될 때까지 문서를 볼 수 없습니다.
- 가져오기를 클릭하여 가져오기 프로세스를 시작합니다.
가져오기 상태 확인하기
- HubSpot 계정에서 서비스 > 기술 자료로 이동합니다.
- 문서 탭을 클릭합니다.
- 페이지 상단에서 가져오기 진행 상황을 확인합니다.

CSV 파일에서 지식창고 가져오기
CSV 파일에서 지식창고를 가져옵니다. 샘플 CSV 파일을 검토하여 가져올 지식창고 콘텐츠의 형식을 정하세요.
CSV 파일 업로드하기
- HubSpot 계정의 상단 탐색 모음에서 settings 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 콘텐츠 > 지식창고로 이동합니다.
- 현재 보기 섹션에서 첫 번째 드롭다운 메뉴를 클릭하고 지식창고 가져오기를 선택합니다. 브랜드 추가 기능이 있는 계정에서는 두 번째 드롭다운 메뉴가 표시됩니다.
- 현재 사용 중인 지식창고 플랫폼 드롭다운 메뉴를 클릭하고 현재 지식창고를 호스팅하고 있는 플랫폼을 선택합니다.
- HubSpot 지식창고 드롭다운 메뉴를 클릭하고 지식창고를 선택합니다.
- CSV 파일 업로드 섹션에서 파일 선택을 클릭한 다음 CSV 파일을 업로드합니다.
- 오른쪽 하단에서 문서 복사를 클릭합니다.
CSV 파일에서 열을 매핑합니다.
CSV 파일의 열을 새 HubSpot 지식창고의 해당 속성에 매핑합니다. CSV 파일 및 가져오려는 문서 콘텐츠의 형식을 지정하는 방법에 대한 예시를 보려면 샘플 CSV 가져오기 파일을 검토하세요.
CSV 파일에서 문서 콘텐츠를 매핑하려면 다음과 같이 하세요:
- 열 선택 드롭다운 메뉴( )를 클릭하여 파일에서 HubSpot KB 속성을 매핑할 열을 선택합니다.
- 완료했으면 오른쪽 아래에서 다음을 클릭합니다. 가져오기 프로세스를 완료하는 데 몇 분 정도 걸릴 수 있습니다.
- 대시보드로 돌아가기를 클릭하여 가져오기 상태를 확인합니다.
다음은 HubSpot 지식창고 속성입니다(HubSpot KB 속성 열):
- URL(필수): 이 열에 있는 각 문서의 URL입니다.
- 제목(필수): 이 열에 있는 각 문서의 제목입니다.
- 카테고리(필수): 이 열에 있는 각 문서의 카테고리입니다. HubSpot에서 이 값을 분류되지 않음으로 설정하려면 파일에서 이 필드를 비워두면 됩니다.
- 하위 카테고리: 이 열에 있는 각 문서의 하위 카테고리입니다.
- 키워드: 이 열에 있는 각 문서의 검색 키워드로, 쉼표로 구분됩니다.
- 메타 설명(필수): 이 열의 각 문서에 대한 메타 설명입니다.
- 문서 본문(필수): 이 열에 있는 이미지 URL을 포함한 문서 콘텐츠의 소스 코드입니다. 문서 본문 서식 지정 방법의 예는 샘플 CSV 가져오기 파일을 참조하세요.
- 자막: 이 열의 각 문서에 대한 자막입니다.
참고: 키워드 뒤에 다음 키워드와 구분하는 쉼표가 있는 키워드가 있으면 해당 태그를 가져올 수 없다는 오류가 표시됩니다.
가져오기 완료
매핑이 완료되면 지식창고 문서 가져오기를 검토하고 완료할 수 있습니다.
- 가져오기 툴로 다시 이동합니다:
- HubSpot 계정의 상단 탐색 모음에서 settingsIcon 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 콘텐츠 > 지식창고로 이동합니다.
- 현재 보기 드롭다운 메뉴를 클릭하고 지식창고 가져오기를 선택합니다.
- 결과 검토를 클릭합니다.
- 특정 문서를 미리 보려면 미리 보기를 클릭합니다. 오른쪽 패널에서 문서를 보고 툴이 해당 문서에 대해 식별한 모든 값의 목록을 확인합니다.
- 문서의 기능에 기본값이 적용된 경우에는 다음과 같은 메모가 표시됩니다: 매핑을 완료하는 데 사용된 기본값입니다.
- 기본값을 검토하려면 기본값 변경을 클릭합니다.
- 오른쪽 패널에서 모든 문서에 매핑할 수 없는 문서 기능의 기본값을 검토합니다.
- 텍스트 필드에 원하는 값으로 값을 입력합니다.
- 저장을 클릭하여 모든 문서에 이 값을 적용합니다.
- 기본적으로 가져오기를 위해 선택된 문서가 없습니다. 가져오기에 포함하려는 문서의 왼쪽에 있는 확인란을 선택합니다.
- 완료했으면 가져오기를 클릭합니다.
- 대화 상자에서 옵션을 선택합니다:
- 모든 콘텐츠를 "초안"으로 가져오기: 가져온 문서는 지식창고에서 초안으로 가져오며 수동으로 게시된 후에만 방문자들이 볼 수 있습니다.
- 모든 콘텐츠를 "게시됨"으로 가져오기: 가져온 문서가 방문자들이 볼 수 있도록 즉시 실시간으로 게시됩니다.
- 기존 콘텐츠를 덮어쓰려면 가져온 콘텐츠로 기존 콘텐츠 덮어쓰기 확인란을 선택합니다.
- 완료되면 저장을 클릭합니다.