지식베이스 문서 가져오기
마지막 업데이트 날짜: 2026년 9월 14일
Freshdesk, Help Scout, Zendesk 또는 Intercom에 호스팅된 외부 지식베이스의 문서를 HubSpot으로 가져올 수 있습니다. 또한 CSV 파일을 통해 지식베이스를 가져올 수도 있습니다.
시작하기 전에
지식베이스 문서를 가져오기 전에 요구 사항과 고려 사항을 확인하십시오.
시트 필요 지식베이스 문서를 가져오려면 할당된 Service Hub 시트가 필요합니다.
권한 필요 다음 권한이 필요합니다.
- 지식베이스 문서를 가져오려면‘지식베이스 설정’ 권한이 필요합니다.
- 지식베이스 문서를 편집하고 게시하려면 '지식베이스 문서에 대한서비스 액세스' 권한이 필요합니다.
제한 사항 및 고려 사항 이해하기
-
지식베이스로 테이블을 가져오는 기능은 지원되지 않습니다.
- 가져온 모든 문서는 지식베이스의 기본 언어로 추가됩니다. 가져오기 후, 여러 언어로 지식베이스 문서를 작성하는 방법을 알아보세요.
-
한 번의 가져오기당 문서 수 제한은 400개입니다.
- '스마트 복사'를 사용하여 홈페이지 URL에서 지식 기반을 가져오는 기능은 새로 생성되거나 마이그레이션된 지식 기반에서만 사용할 수 있습니다.
- CSV 파일에서 지식 기반을 가져오려면 다음 필드가 필요합니다:
- URL
- 제목
- 카테고리
- 기사 본문
스마트 복사 기능을 사용하여 지식 기반 가져오기
스마트 복사 기능을 사용하여 Freshdesk, Help Scout, Zendesk 또는 Intercom에서 지식베이스 문서를 가져오세요.
- HubSpot 계정의 상단 탐색 모음에서
설정 아이콘을 클릭합니다. - 왼쪽 사이드바 메뉴에서 ‘콘텐츠 > 지식베이스’로 이동합니다.
- '현재 보기' 섹션에서 첫 번째 드롭다운 메뉴를 클릭하고 ‘지식베이스 가져오기’를 선택하세요. ‘Brands’ 애드온이 설치된 계정의 경우, 이 메뉴는 두 번째 드롭다운 메뉴에 있습니다.
- '지식베이스 가져오기' 페이지에서 왼쪽 하단의 '이전'을 클릭하십시오.
- '스마트 복사' 옵션을 선택한 다음 '다음'을 클릭합니다.
- 외부 지식베이스 홈페이지의 URL 을 입력합니다.
- 문서 가져오기 옵션을 선택하십시오:
- '가져오기 및 게시': 가져온 문서가 방문자가 볼 수 있도록 바로 게시됩니다.
- 초안으로 가져오기: 기사가 지식베이스의 초안으로 가져옵니다. 기사가 게시되기 전까지는 방문자가 볼 수 없습니다.
- '가져오기'를 클릭하여 가져오기 과정을 시작하십시오 .
가져오기 상태 확인
- HubSpot 계정에서 더 보기를 클릭한 다음 서비스 > 기술 자료로 이동하세요. 더 보기가 계정에 표시되지 않으면 바로 서비스 > 기술 자료로 이동하세요.
- '기사 ' 탭을 클릭하세요.
- 페이지 상단에서 가져오기 진행 상황을 확인하세요.

CSV 파일에서 지식 기반을 가져오기
CSV 파일에서 지식 기반을 가져오세요. 가져오기에 적합한 형식으로 지식 기반 콘텐츠를 구성하려면 샘플 CSV 파일을 참고하세요.
CSV 파일 업로드
- HubSpot 계정의 상단 탐색 모음에서
설정 아이콘을 클릭합니다. - 왼쪽 사이드바 메뉴에서 ‘콘텐츠 > 지식베이스’로 이동합니다.
- '현재 보기' 섹션에서 첫 번째 드롭다운 메뉴를 클릭하고 '지식 기반 가져오기'를 선택합니다. 'Brands' 애드온이 설치된 계정의 경우, 이 메뉴는 두 번째 드롭다운 메뉴에 있습니다.
- '현재 어떤 지식베이스 플랫폼을 사용하고 계십니까?' 드롭다운 메뉴를 클릭하고, 현재 지식베이스를 호스팅하고 있는 플랫폼을 선택하세요.
- 'HubSpot 지식베이스' 드롭다운 메뉴를 클릭하고 지식베이스를 선택하십시오.
- 'CSV 파일 업로드 ' 섹션에서 '파일 선택'을 클릭한 다음 CSV 파일을 업로드하십시오.
- 오른쪽 하단에서 ‘기사 복사’를 클릭하세요.
CSV 파일의 열을 매핑하세요.
CSV 파일의 열을 새로운 HubSpot 지식베이스의 해당 속성에 매핑하세요. CSV 파일 형식 지정 방법 및 가져올 문서 내용에 대한 예시를 보려면 샘플 CSV 가져오기 파일을 확인하세요.
CSV 파일의 문서 내용을 매핑하려면:
- 의 ‘열 선택’ 드롭다운 메뉴를 클릭하여 HubSpot 지식베이스 속성과 매핑할 파일 내의 열을 선택하세요.
- 완료되면 오른쪽 하단의 ‘다음’을 클릭하세요. 가져오기 과정이 완료되는 데 몇 분 정도 걸릴 수 있습니다.
- '대시보드로 돌아가기'를 클릭하여 가져오기 상태를 확인하세요.
다음은 HubSpot 지식베이스 속성(HubSpot KB 속성 열)입니다:
- URL(필수): 이 열에 포함된 각 기사의 URL입니다.
- 제목(필수): 이 열에 각 기사의 제목이 입력됩니다.
- 카테고리(필수): 이 열에 포함된 각 기사의 카테고리입니다. HubSpot에서 값을 ‘분류되지 않음’으로 설정하려면 파일에서 이 필드를 비워 두면 됩니다.
- 하위 카테고리: 이 열에 포함된 각 기사의 하위 카테고리입니다.
- 키워드: 이 칼럼에 포함된 각 기사의 검색 키워드로, 쉼표로 구분합니다.
- 메타 설명(필수): 이 열에 포함된 각 기사의 메타 설명입니다.
- 기사 본문(필수): 이 칼럼에 포함된 기사 콘텐츠의 소스 코드로, 이미지 URL이 포함됩니다. 기사 본문의 서식 지정 방법에 대한 예시는 CSV 가져오기 샘플 파일을 참조하십시오.
- 부제: 이 열에 포함된 각 기사의 부제입니다.
주의 사항: 키워드 사이에 쉼표로 구분된 후 다음 키워드와 연결되는 공백이 있는 경우, 해당 태그를 가져올 수 없다는 오류 메시지가 표시됩니다.
가져오기 완료
매핑이 완료되면 지식베이스 문서 가져오기를 검토하고 완료할 수 있습니다.
- 가져오기 도구로 돌아가려면:
- HubSpot 계정에서 상단 탐색 모음의 ‘ settingsIcon ’ 설정 아이콘을 클릭합니다.
- 왼쪽 사이드바 메뉴에서 ‘콘텐츠(Content)’ > ‘지식베이스(Knowledge base)’로 이동합니다.
- '현재 보기(Current view )' 드롭다운 메뉴를 클릭하고 '지식베이스 가져오기(Import knowledge base)'를 선택합니다.
- '결과 검토'를 클릭합니다.
- 특정 문서를 미리 보려면 ‘미리 보기’를 클릭하세요. 오른쪽 패널에서 문서를 확인하고, 도구가 해당 문서에 대해 식별한 모든 값의 목록을 확인하세요.
- 문서의 속성에 기본값이 적용된 경우, '매핑을 완료하기 위해 기본값이 사용되었습니다'라는 메모가 표시됩니다.
- 기본값을 검토하려면 '기본값 변경'을 클릭하십시오.
- 오른쪽 패널에서 모든 문서에 대해 매핑할 수 없었던 문서 기능에 대한 기본값을 검토하십시오.
- 텍스트 필드에 원하는 값을 입력하십시오.
- '저장'을 클릭하여 이 값들을 모든 기사에 적용하십시오.
- 기본적으로 가져오기에 선택된 기사는 없습니다. 가져오기에 포함할 기사의 왼쪽에 있는 확인란을 선택하십시오.
- 완료되면 ‘가져오기’를 클릭하십시오.
- 대화 상자에서 다음 옵션 중 하나를 선택하십시오.
- 모든 콘텐츠를 "초안"으로 가져오기: 가져온 기사는 지식베이스에 초안으로 저장되며, 수동으로 게시된 후에만 방문자가 볼 수 있습니다.
- 모든 콘텐츠를 “게시됨” 상태로 가져오기: 가져온 문서는 즉시 게시 되어 방문자가 볼 수 있게 됩니다.
- 기존 콘텐츠를 덮어쓰려면 ‘기존 콘텐츠를 가져온 콘텐츠로 덮어쓰기’ 확인란을 선택하십시오.
- 완료되면 ‘저장’을 클릭하십시오.
지식 기반이 여러 언어를 지원하는 경우, 가져오기가 완료된 후 여러 언어로 지식 기반 문서를 작성하는 방법을 알아보세요.
