한 번에 하나씩 조직을 추가하는 대신 CSV(쉼표로 구분된 값) 파일을 가져와서 한 번에 여러 조직을 일괄 추가할 수 있습니다. 일괄 가져오기를 사용하여 조직을 추가 또는 업데이트할 수 있습니다. 관리자만 조직 일괄 가져오기를 수행할 수 있습니다. 한 번에 여러 사용자 및 여러 사용자 사용자 지정 개체 레코드를 추가하거나 업데이트할 수도 있습니다.

사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise

요약: ◀ ▼

CSV 파일을 사용하여 여러 조직을 일괄 가져오거나 업데이트할 수 있어 개별적으로 추가하는 것보다 시간을 절약할 수 있습니다. CSV는 특정 서식 규칙 및 크기 제한을 따라야 하며 관리자만 가져오기를 수행할 수 있습니다. 이 프로세스는 핵심 조직 데이터 및 사용자 지정 필드를 지원하지만 가져오기 순서가 보장되지 않고 한 파일에 중복 항목이 없어야 한다는 제한 사항이 있습니다. 가져오기 기록 로그는 진행 상황을 추적합니다.

한 번에 하나씩 조직을 추가하는 대신 CSV(쉼표로 구분된 값) 파일을 가져와서 한 번에 여러 조직을 일괄 추가할 수 있습니다. 일괄 가져오기를 사용하여 조직을 추가 또는 업데이트할 수 있습니다. 관리자만 조직 일괄 가져오기를 수행할 수 있습니다. 여러 사용자와 여러 사용자 지정 개체 레코드를 한 번에 추가하거나 업데이트할 수도 있습니다.

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

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

이 문서에서 다루는 주제는 다음과 같습니다.
  • 데이터 가져오기로 일괄 가져오기에 대한 제한 사항
  • CSV 조직 데이터 파일 만들기
  • 데이터 가져오기 로 조직 가져오기

데이터 가져오기로 일괄 가져오기에 대한 제한 사항

사용자와 조직에 대한 핵심 데이터 집합을 가져올 수 있습니다. 아래 표에 나와 있지 않은 데이터를 가져오려면 대신 Zendesk REST API를 사용해야 합니다. Zendesk API를 통해 사용자 가져오기를 참조하세요.

  • 데이터 가져오기를 사용할 때 가져오기 CSV 파일 크기는 1GB를 초과할 수 없습니다. 최대 500,000개의 행 즉, 한 개의 헤더 행과 최대 499,999개의 데이터 행을 권장합니다. 또한 각 행의 크기는 128KB를 초과할 수 없습니다.
  • 가져오기 CSV 파일에는 최대 200개의 열이 포함될 수 있습니다.
  • 가져오기 CSV 파일은 행의 가져오기 순서를 보장할 수 없습니다.
  • 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 키를 눌러서 메모 또는 멀티라인 사용자 지정 필드에 줄 바꾸기를 추가합니다.
다음 표는 파일에 포함할 수 있는 필드를 나열하고 있습니다.
표 1. 조직 가져오기 데이터
필드 설명
name 필수 사항으로 조직 이름입니다.
external_id 선택 사항이며 권장 사항은 아니지만 나중에 데이터 가져오기를 사용하여 이러한 레코드를 업데이트하려는 경우 필수입니다. 외부 시스템의 직원 또는 고객 식별 번호와 같은 고유한 식별 값입니다.
notes 조직에 대한 메모입니다. 최종 사용자를 제외한 상담사만 메모를 볼 수 있습니다.
details 주소 등 조직에 대한 자세한 정보로, 이 정보는 최종 사용자가 아닌 상담사만 볼 수 있습니다. 데이터 가져오기 사용할 때 기본 헤더 대신 이 필드를 사용하세요.
domain_names 사용자 맵핑을 위한 조직의 도메인 이름입니다. 조직에 두 개 이상의 도메인 이름을 포함하는 경우에는 파이프 문자(|)로 구분합니다.
group_id 조직의 기본 그룹을 입력합니다. 그룹을 조직에 맵핑하기를 참조하세요.
tags Zendesk Support 에 사용자 및 조직 태그 지정이 사용 설정되어 있으면 조직에 대한 태그를 설정할 수 있습니다. 각 태그는 파이프 문자( | )로 구분합니다.

조직 일괄 가져오기 시 CSV 파일의 태그가 기존 조직 태그를 대체합니다. 이런 일이 발생하지 않도록 하려면 대신 태그 API를 사용하여 태그를 업데이트하세요.
organization_fields.<필드 키> 조직 일괄 가져오기를 수행할 때 organization_fields. 접두어와 필드 키를 지정하여 사용자 지정 조직 필드를 가져올 수 있습니다. 

예를 들어, subscription_date 필드 키에서는 다음을 이용하여 이 필드에 가져온 값을 설정합니다.

organization_fields.subscription_date

조직 필드의 필드 키를 찾으려면 사용자 지정 필드의 필드 키 또는 필드 ID 찾기를 참조하세요.

필드 값이 올바르게 서식화되어 있지 않으면 가져오기가 실패하고 가져오기 기록 로그에 오류에 대한 자세한 내용이 표시됩니다. 사용자 지정 날짜 필드는 YY/MM/DD 또는 YYYY-MM-DD 형식을 사용하세요. 확인란 필드에는 True 또는 False를 사용하세요. 드롭다운 필드의 값을 설정하려면 드롭다운 목록을 만들 때 추가한 태그를 사용합니다.

참고: 데이터 가져오기 페이지에서 조직을 가져올 때 조회 관계 필드는 지원되지 않습니다.

조직에 사용자 지정 필드 추가하기를 참조하세요.

데이터 가져오기 로 조직 가져오기

데이터 가져오기를 사용하여 새 조직을 만들거나 기존 조직을 업데이트하는 CSV 파일을 가져오고 데이터 가져오기 페이지를 통해 시도된 모든 가져오기 로그를 캡처할 수 있습니다.

가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 조직이 추가됩니다. 완료하는 데 파일당 대략 1시간이 소요되지만 실제 시간은 파일 크기와 대기열 크기에 따라 다릅니다.

데이터 가져오기를 통해 조직을 만들거나 업데이트하려면 다음과 같이 하세요.
  1. 관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 도구 > 데이터 가져오기를 선택합니다.
  2. 가져오기를 클릭합니다.
  3. 대상 아래에서 조직을 선택합니다.
  4. 가져오기 옵션 아래에서 다음 중 하나를 선택합니다.
    • 레코드 만들기만 : 새 조직을 만들기만 합니다. 기존 조직과 관련된 CSV 파일의 모든 데이터는 무시됩니다.
    • 레코드만 업데이트 : CSV 파일에 나열된 기존 조직에 대한 데이터를 바꿉니다. 조직을 업데이트하려면 external_id가 필요합니다. 새 조직과 관련된 모든 데이터는 무시됩니다.
    • 레코드 만들기 및 업데이트 : 새 조직을 만들고 CSV 파일에 나열된 기존 조직에 대한 데이터를 업데이트합니다.
  5. 파일 업로드 아래에서 파일을 드래그 앤 드롭하거나 클릭하여 업로드로 파일 브라우저에서 CSV 파일을 선택할 수 있습니다.

    선택한 파일을 변경해야 하는 경우에는 파일 이름 옆의 삭제 아이콘()을 클릭합니다.

  6. 다음을 클릭합니다.
  7. 필드 맵핑 목록을 검토합니다.
    • 필드 맵핑이 올바르면 다음을 클릭합니다.
    • 필드 맵핑이 올바르지 않으면 뒤로를 클릭합니다. 서식 요건에 맞게 CSV 파일을 편집한 후 파일을 다시 업로드합니다.
  8. 확인 대화 상자에서 가져오기 세부 정보의 요약을 검토한 후 가져오기 시작을 클릭합니다.

    가져오기가 시작된 후에는 가져온 변경 내용을 되돌릴 수 없습니다. 가져오기의 상태를 확인하려면 가져오기 기록을 확인하세요.

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공