조직 일괄 가져오기

한 번에 조직을 하나씩 추가하기보다 CSV(쉼표로 여러 값 구분) 파일을 가져와서 일괄로 여러 개의 조직을 추가할 수 있습니다. 일괄 가져오기를 사용하여 조직을 추가 또는 업데이트할 수 있습니다. 관리자만 조직 일괄 가져오기를 수행할 수 있습니다. 한 번에 여러 사용자를 추가 또는 업데이트할 수 있습니다(사용자 일괄 가져오기 참조).

참고: 조직과 사용자 둘 다 일괄 가져오기를 하려면, 먼저 조직을 일괄 가져오기해야 합니다. 사용자 일괄 가져오기에 대한 자세한 내용은 사용자 일괄 가져오기를 참조하세요.

조직 일괄 가져오기 작업은 실행 취소할 수 없습니다. 모든 조직의 정보가 포함된 CSV 파일을 가져오기 전에 단일 조직 레코드로 동일한 CSV 파일을 테스트하여 업로드가 의도한 작업을 수행하는지 확인하세요.

이 문서는 다음 섹션으로 구성되어 있습니다.

• 사용자 및 조직 일괄 가져오기의 한계
• CSV 조직 데이터 파일 만들기
• CSV 조직 데이터 파일 가져오기

사용자 및 조직 일괄 가져오기의 한계

사용자와 조직에 대한 핵심 데이터 집합을 가져올 수 있습니다. 예를 들어 일괄 가져오기를 사용하여 아래 표에 설명된 데이터를 가져올 수 있지만 시간대, 사진, 언어 기본 설정 등은 가져올 수 없습니다. 아래 표에 나와 있지 않은 데이터를 가져오려면 대신 Zendesk REST API를 사용해야 합니다. Zendesk API를 통해 사용자 가져오기 또는 Zendesk API를 통해 조직 가져오기를 참조하세요.

또한 일괄 가져오기에는 다음과 같은 한계가 있습니다.

• 가져오기 할 CSV 데이터 파일은 최대 2000행(1행은 헤더 나머지 행은 사용자 또는 조직 데이터)을 포함해야 합니다.
• 한 번에 2000 이하의 행을 가진 CSV 파일 한 개씩만 가져올 수 있습니다. 따라서 가져오려는 사용자 또는 조직이 1999개를 초과하는 경우에는 배치 파일을 여러 개 만들어서 한 번에 하나씩 가져와야 합니다. 대기열에는 최대 두 개의 배치 파일이 쌓이고 백그라운드에서 실행됩니다. 두 개 이상의 배치 파일을 가져오려면, 첫번째 배치 파일의 가져오기가 완료될 때까지 기다렸다가 다음 파일을 추가해야 합니다.
• 최종 사용자의 Facebook 또는 트위터 계정에서 연락처 정보를 가져올 때에는 일괄 가져오기를 사용할 수 없습니다. 대신에 Zendesk REST API를 사용합니다. Zendesk API를 통해 사용자 가져오기를 참조하세요.

CSV 조직 데이터 파일 만들기

조직을 일괄 가져오기하려면, CSV 조직 데이터 파일을 사용해야 합니다. 이 섹션에서는 CSV 데이터 파일을 설정하는 방법에 대해 설명합니다.

다음은 파일을 만들 때에 주의해야 할 몇 가지 중요 사항입니다.

• 파일은 적절한 형식을 준수하는 CSV 파일로 UTF-8 문자 인코딩을 사용해서 저장되어야 합니다.
• CSV 파일의 첫 행은 헤더 행이며, 반드시 파일에 포함되어야 합니다.
• 헤더 행은 아래 표에 있는 모든 필수 필드를 포함해야 하며, 그 외에도 아래 표에 있는 필드 중 포함시키고자 하는 필드를 추가할 수 있습니다.
• 포함된 필드는 아래 목록의 순서대로 헤더 행에 표시되어야 합니다.
• 특정 필드에 대한 데이터를 가져오지 않는 경우에는 헤더 행에 추가하지 않습니다.
• 파일 내에 데이터 열이 비어있으면 해당 조직의 모든 기존 데이터를 덮어쓰게 됩니다.
• Windows에서는 ALT+ENTER 키를, Mac에서는 CTRL+OPTION+RETURN 키를 눌러서 메모 또는 멀티라인 사용자 지정 필드에 줄 바꾸기를 추가합니다.

다음 표는 파일에 포함할 수 있는 필드를 나열하고 있습니다.

표 1. 조직 가져오기 데이터

필드	설명
name	필수 사항으로, 조직 이름입니다.
external_id	조직 이름 이외에 고유 식별 ID가 있는 경우 여기에 포함시킬 수 있습니다.
notes	조직에 대한 메모입니다. 최종 사용자를 제외한 상담원만 메모를 볼 수 있습니다.
details	주소 등 조직에 대한 자세한 정보로, 최종 사용자를 제외한 상담원만 이 정보를 볼 수 있습니다.
default	사용자를 조직에 맵핑할 때에 사용하는 값으로, 하나 이상의 이메일 도메인을 띄어쓰기로 구분해서 입력합니다. 이메일 도메인을 기준으로 사용자를 조직에 자동으로 추가하기를 참조하세요.
shared	True 또는 False로, 조직을 공유 조직으로 설정합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요.
shared_comments	True 또는 False로, 조직 내의 모든 사용자가 서로의 티켓에 댓글을 추가할 수 있도록 허용합니다. 공유 필드도 true로 설정되어 있어야 합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요.
group	조직의 기본 그룹을 입력합니다. 그룹을 조직에 맵핑하기를 참조하세요.
tags	Zendesk Support에서 사용자 및 조직 태그 지정이 사용 설정되어 있는 경우 (사용자 및 조직에 태그 추가하기 참조), 조직에 태그를 추가할 수 있습니다. 각 태그는 띄어쓰기로 구분합니다.
custom_fields.<field key>	조직 일괄 가져오기를 수행할 때  custom_fields. 접두어와 필드 키를 지정하여 사용자 지정 조직 필드를 가져올 수 있습니다.  예를 들어  subscription_date 필드 키에서는 다음을 이용하여 이 필드에 가져온 값을 설정합니다. custom_fields.subscription_date 참고: 사용자 지정 조직 필드의 키를 찾으려면, 관리자 아이콘()을 클릭하고 조직 필드를 선택한 다음 사용자 지정 필드의 이름을 클릭합니다. 오른쪽 특성 창에 필드 키가 나타납니다. 필드 값의 형식이 올바르지 않으면 가져오기는 실패하고 저장하지 못한 레코드를 명시한 오류 보고서를 받게 됩니다. 사용자 지정 날짜 필드는 YY/MM/DD 또는 YYYY-MM-DD 형식을 사용하세요. 중요: 드롭다운 목록 옵션의 값을 설정하려면, 드롭다운 목록을 만들 때 추가한 태그를 사용합니다. 조직에 사용자 지정 필드 추가하기를 참조하세요.

CSV 조직 데이터 파일 가져오기

새 조직을 가져오거나 기존 조직의 정보를 업데이트할 수 있습니다.

CSV 조직 데이터를 가져오려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 사람 아이콘()을 클릭한 다음 일괄 작업 > 조직 가져오기를 선택합니다.
2. 원하는 가져오기 유형을 선택합니다.

   • 새 조직 만들기

   • 기존 조직 업데이트: CSV 파일에 나열된 조직의 기존 데이터를 바꾸려면 이 가져오기 유형을 사용합니다. 파일에는 업데이트할 필드만 포함시키세요. 공백인 데이터 열이 있다면 해당 조직의 기존 데이터를 공백으로 덮어쓰게 됩니다.

3. 파일 선택 또는 직접 데이터에 붙여넣기 링크를 클릭합니다.
4. 가져오기를 클릭합니다.

가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 조직이 추가됩니다. 완료하는 데 파일당 대략 1시간이 소요되지만 실제 시간은 파일 크기와 대기열 크기에 따라 다릅니다. 사용자 및 조직 일괄 가져오기의 한계를 참조하세요. 가져오기가 완료되면 이메일을 받게 됩니다.