요약: ◀ ▼
이름, 외부 ID, 메모, 태그 등의 특정 필드가 있는 CSV 파일을 사용하여 조직 데이터를 일괄 가져올 수 있습니다. 가져오기는 파일당 최대 2,000개의 행을 지원하며 사용자보다 먼저 조직을 가져와야 합니다. 제한 사항에는 일부 데이터 유형에 대한 지원이 없으며 한 번에 하나의 파일 가져오기가 포함됩니다. 관리자가 데이터 가져오기를 사용 설정해야 하며, 필드를 비워두면 업데이트가 기존 데이터를 덮어씁니다.
Zendesk는 이 문서에서 설명된 레거시 일괄 작업 페이지 대신 데이터 가져오기 사용하여 조직 데이터를 가져올 것을 권장합니다. 하지만 원하는 경우 일괄 작업 페이지를 사용하여 새 조직이나 업데이트된 조직 정보를 가져올 수 있습니다.
- Zendesk 계정의 데이터를 보호하기 위해 기본적으로 데이터 가져오기가 사용 설정되지 않습니다. 데이터 내보내기를 사용 설정하고 가져오기 페이지에 액세스하려면 계정 소유자나 관리자가 Zendesk 고객 지원팀에 연락해야 합니다.
- 사용자와 조직 둘 다 일괄 가져오기를 하려면 먼저 조직을 일괄 가져오기해야 합니다.
이 문서에서 다루는 주제는 다음과 같습니다.
조직 일괄 가져오기에 대한 고려 사항(레거시)
조직을 일괄 가져오기 전에 검토해야 하는 몇 가지 제한 사항 및 고려 사항이 있습니다.
사용자 및 조직 일괄 가져오기의 한계(레거시)
사용자와 조직에 대한 핵심 데이터 집합을 가져올 수 있습니다. 예를 들어, 아래 표에서 설명된 데이터를 가져올 수 있습니다. 단, 시간대, 사진, 언어 기본 설정 및 기타 데이터는 가져올 수 없습니다. 아래 표에 나와 있지 않은 데이터를 가져오려면 대신 Zendesk REST API를 사용해야 합니다. Zendesk API를 통해 사용자 가져오기 또는 Zendesk API를 통해 조직 가져오기를 참조하세요.
- 일괄 작업 페이지를 사용할 때 가져오기 CSV 데이터 파일은 최대 2,000개의 행을 포함할 수 있습니다. 즉, 한 개의 헤더 행과 최대 1,999개의 데이터 행이 포함될 수 있습니다.
- CSV 파일 내에 동일한 사용자나 조직을 두 번 이상 포함하지 마세요. 그렇게 하면 가져오기에 실패할 수 있습니다.
- CSV 파일에 나타나는 순서대로 레코드가 작성되거나 업데이트된다는 보장은 없습니다.
- 한 번에 하나의 CSV 파일만 가져올 수 있습니다. 따라서 CSV 파일에 지원되는 최대 행 수보다 많은 데이터가 있는 경우에는 각 배치에 대해 별도의 파일을 만들어 하나씩 가져와야 합니다. 데이터 가져오기를 사용하고 있지 않은 경우에는 대기열에 최대 두 개의 배치 파일이 쌓이고 백그라운드에서 실행됩니다. 두 개 이상의 배치 파일을 가져오려면, 첫번째 배치 파일의 가져오기가 완료될 때까지 기다렸다가 다음 파일을 추가해야 합니다.
- 최종 사용자의 Facebook 또는 X(구 트위터) 계정에서 연락처 정보를 가져올 때에는 일괄 가져오기를 사용할 수 없습니다. 대신에 Zendesk REST API를 사용합니다. Zendesk API를 통해 사용자 가져오기를 참조하세요.
CSV 조직 데이터 파일 만들기(레거시)
조직을 일괄 가져오려면 CSV 조직 데이터 파일을 사용하세요. 이 섹션에서는 CSV 데이터 파일을 설정하는 방법에 대해 설명합니다.
- 파일은 적절한 형식을 준수하는 CSV 파일로 UTF-8 문자 인코딩을 사용해서 저장되어야 합니다.
- CSV 파일의 첫 번째 행은 헤더 행입니다.
- 헤더 행은 아래 표에 있는 모든 필수 필드를 포함해야 하며, 그 외에도 아래 표에 있는 필드 중 포함시키고자 하는 필드를 추가할 수 있습니다.
- 헤더 로우에서 가져오기 방법에 따라 domain_names 또는 default를 사용합니다. 둘을 함께 사용할 수는 없습니다.
- 특정 필드에 대한 데이터를 가져오지 않는 경우에는 헤더 행에 추가하지 않습니다.
- 파일 내에 데이터 열이 비어있으면 해당 조직의 모든 기존 데이터를 덮어쓰게 됩니다.
- Windows에서는 ALT+ENTER 키를, macOS에서는 CTRL+OPTION+RETURN 키를 눌러서 메모 또는 멀티라인 사용자 지정 필드에 줄 바꾸기를 추가합니다.
| 필드 | 설명 |
|---|---|
| name | 필수 사항으로 조직 이름입니다. |
| external_id | 선택 사항이며 권장 사항은 아니지만 나중에 데이터 가져오기를 사용하여 이러한 레코드를 업데이트하려는 경우 필수입니다. 외부 시스템의 직원 또는 고객 식별 번호와 같은 고유한 식별 값입니다. |
| notes | 조직에 대한 메모입니다. 최종 사용자를 제외한 상담사만 메모를 볼 수 있습니다. |
| 기본 | 사용자를 조직에 맵핑할 때에 사용하는 값으로, 예를 들어 organization1.com organization2.com과 같이 띄어쓰기로 구분하여 하나 이상의 이메일 도메인을 입력합니다. 이메일 도메인을 기준으로 사용자를 조직에 자동으로 추가하기를 참조하세요. |
| shared | True 또는 False로, 조직을 공유 조직으로 설정합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요. |
| shared_comments | True 또는 False로, 조직 내의 모든 사용자가 서로의 티켓에 댓글을 추가할 수 있도록 허용합니다. 공유 필드도 true로 설정되어 있어야 합니다. 최종 사용자를 위한 공유 조직 설정하기를 참조하세요. |
| group | 조직의 기본 그룹을 입력합니다. 그룹을 조직에 맵핑하기를 참조하세요. |
| tags | Zendesk Support에서 사용자 및 조직 태그 지정이 사용 설정되어 있는 경우(사용자 및 조직에 태그 추가하기 참조), 조직에 대한 태그를 설정할 수 있습니다. 각 태그는 띄어쓰기로 구분합니다. 조직 일괄 가져오기 시 CSV 파일의 태그가 기존 조직 태그를 대체합니다. 이런 일이 발생하지 않도록 하려면 대신 태그 API를 사용하여 태그를 업데이트하세요. |
| custom_fields.<필드 키> | 조직 일괄 가져오기를 수행할 때 custom_fields. 접두어와 필드 키를 지정하여 사용자 지정 조직 필드를 가져올 수 있습니다. 예를 들어 subscription_date 필드 키에서는 다음을 이용하여 이 필드에 가져온 값을 설정합니다. custom_fields.subscription_date 사용자 지정 조직 필드에 대한 필드 키를 찾으려면 사용자 지정 필드에 대한 필드 키나 필드 ID 찾기를 참조하세요. 필드 값의 형식이 올바르지 않으면 가져오기는 실패하고 저장하지 못한 레코드를 명시한 오류 보고서를 이메일로 받게 됩니다. 사용자 지정 날짜 필드는 YY/MM/DD 또는 YYYY-MM-DD 형식을 사용하세요. 확인란 필드에는 True 또는 False를 사용하세요. 드롭다운 목록 옵션의 값을 설정하려면 드롭다운 목록을 만들 때 추가한 태그를 사용합니다.
참고: 가져오고 있는 사용자 지정 조직 필드가 조회 관계 필드인 경우에는 관련 개체의 ID를 이 필드의 값으로 입력하세요. 예를 들어 조직에는 조직 ID를 입력하고 사용자에는 사용자의 ID를 입력하고, 사용자 지정 개체 레코드에는 레코드의 ID를 입력합니다. 조직, 사용자 또는 사용자 지정 개체 레코드 ID를 찾으려면 계정에서 데이터를 내보내거나 조직 API, 사용자 API 또는 사용자 지정 개체 레코드 API를 사용할 수 있습니다.
데이터 가져오기 페이지에서 조직을 가져올 때 조회 관계 필드는 지원되지 않습니다. 조직에 사용자 지정 필드 추가하기를 참조하세요. |
일괄 작업 가져오기를 사용하여 조직 데이터 가져오기(레거시)
데이터 가져오기 사용하는 것이 좋지만 일괄 작업 페이지를 사용하여 신규 및 업데이트된 조직 데이터를 가져올 수 있습니다. 가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 조직이 추가됩니다. 완료하는 데 파일당 대략 1시간이 소요되지만 실제 시간은 파일 크기와 대기열 크기에 따라 다릅니다.
이 페이지에서 가져오기가 완료되면 이메일을 받습니다.
- 관리 센터의 사이드바에서
사람을 클릭한 다음 일괄 작업 > 조직 가져오기를 선택합니다. - 수행하려는 가져오기 유형을 선택합니다.
-
새 조직 만들기
-
기존 조직 업데이트: CSV 파일에 나열된 조직의 기존 데이터를 바꾸려면 이 가져오기 유형을 사용합니다.
조직이 식별될 수 있도록 조직의 external_id나 이름이 CSV에 포함되어야 합니다. 조직 식별자 필드 외에 파일에는 업데이트할 필드만 포함하세요. 조직의 행에 공백 필드가 있으면 해당 조직의 기존 데이터를 덮어쓰게 됩니다.
-
- 파일 선택 또는 직접 데이터에 붙여넣기 링크를 클릭합니다.
-
가져오기를 클릭합니다.
가져오기가 시작된 후에는 가져온 변경 내용을 되돌릴 수 없습니다.
- (선택 사항) 관리 센터 > 개체 및 규칙 > 도구 > 데이터 가져오기 페이지에서 진행 중인 가져오기의 상태를 봅니다. 가져오기가 완료된 후에는 가져오기 기록 로그에 캡처됩니다.
번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.
번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.