사용자 일괄 가져오기

사용 중인 플랜

빠른 보기: 관리 센터 > 사람 > 일괄 작업 > 사용자 가져오기

관리자는 사용자를 한 번에 한 명씩 수동으로 추가하는 것이 아니라 일괄 가져오기를 통해 많은 사용자를 추가할 수 있습니다. 이렇게 하려면 사용자 데이터를 포함하는 CSV(쉼표로 구분된 값) 파일을 만들어야 합니다. 이메일 주소, 전화번호와 같은 필수 사용자 데이터 외에도 사용자 역할을 설정하고, 상담사 권한을 정의하고, 사용자를 조직에 추가할 수도 있습니다. 일괄 가져오기를 사용하여 신규 사용자를 추가하거나 기존 사용자를 업데이트할 수 있습니다. CSV 파일을 통한 일괄 가져오기는 Support 사용자 및 역할에 대해서만 작동합니다.

관리자만 사용자 및 조직 일괄 가져오기를 수행할 수 있습니다.

중요:

• Zendesk 계정의 데이터를 보호하기 위해 기본적으로 데이터 가져오기가 사용 설정되지 않습니다. 데이터 내보내기를 사용 설정하고 가져오기 페이지에 액세스하려면 계정 소유자나 관리자가 Zendesk 고객 지원팀에 연락해야 합니다.
• 사용자와 조직 둘 다 일괄 가져오기를 하려면 먼저 조직을 가져오기 해야 합니다.

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

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

사용자 일괄 가져오기를 위한 고려 사항

사용자를 일괄 가져오기 전에 검토해야 하는 다양한 제한 사항 및 고려 사항이 있습니다.

• 사용자 및 조직 일괄 가져오기의 한계
• 기존 사용자 프로필 데이터 업데이트하기
• 일괄 가져오기 한 사용자들에게 이메일을 보낼지 여부 결정하기

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

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

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

• 최대 행 수는 가져오기 방법에 따라 다릅니다.
  • 일괄 작업 페이지를 사용하여 기존 및 신규 사용자와 조직 데이터를 가져올 때에는 가져오기 CSV 데이터 파일에는 최대 2,000개의 행이 포함될 수 있습니다. 즉, 한 개의 헤더 행과 최대 1,999개의 데이터 행이 포함될 수 있습니다.
  • 데이터 가져오기를 사용하여 기존 및 신규 사용자 및 조직 데이터를 가져올 때에는 가져오기 CSV 파일 크기가 1GB를 초과할 수 없습니다. 최대 500,000개의 행 즉, 한 개의 헤더 행과 최대 499,999개의 데이터 행을 권장합니다. 또한 각 행의 크기는 128KB를 초과할 수 없습니다.
• 데이터 가져오기를 사용할 때 다음 제한 사항도 적용됩니다.
  • 가져오기 CSV 파일에는 최대 200개의 열이 포함될 수 있습니다.
  • 가져오기 CSV 파일은 행의 가져오기 순서를 보장할 수 없습니다.
• CSV 파일 내에 동일한 사용자나 조직을 두 번 이상 포함하지 마세요. 그렇게 하면 가져오기에 실패할 수 있습니다.
• CSV 파일에 나타나는 순서대로 레코드가 작성되거나 업데이트된다는 보장은 없습니다.
• 한 번에 하나의 CSV 파일만 가져올 수 있습니다. 따라서 CSV 파일에 지원되는 최대 행 수보다 많은 데이터가 있는 경우에는 각 배치에 대해 별도의 파일을 만들어 하나씩 가져와야 합니다. 데이터 가져오기를 사용하고 있지 않은 경우에는 대기열에 최대 두 개의 배치 파일이 쌓이고 백그라운드에서 실행됩니다. 두 개 이상의 배치 파일을 가져오려면, 첫번째 배치 파일의 가져오기가 완료될 때까지 기다렸다가 다음 파일을 추가해야 합니다.
• 최종 사용자의 Facebook 또는 X(구 트위터) 계정에서 연락처 정보를 가져올 때에는 일괄 가져오기를 사용할 수 없습니다. 대신에 Zendesk REST API를 사용합니다. Zendesk API를 통해 사용자 가져오기를 참조하세요.

기존 사용자 프로필 데이터 업데이트하기

일괄 가져오기 수행 시 기존 사용자를 업데이트할 수 있습니다. 일부 데이터는 대체되고 일부 데이터는 기존 데이터에 첨부되니 주의하세요.

참고: 기존 사용자를 업데이트하려면 Zendesk가 사용자를 식별할 수 있도록 CSV 파일이 사용자의 external_id나 이메일 주소를 포함해야 합니다.

다음 사용자 데이터가 대체됩니다.

• name
• external_id
• role
• restriction
• organization
• 사용자 지정 필드

다음 사용자 데이터가 첨부됩니다(기존 데이터에 추가됨).

• details
• notes
• tags
• phone (보조 전화번호로 추가됨)
• email (보조 이메일 주소로 추가됨)

일괄 가져오기 한 사용자들에게 이메일을 보낼지 여부 결정하기

사용자 일괄 가져오기를 수행하기 전에 반드시 환영 이메일 설정을 확인하세요. Guide가 사용 설정되어 있는 동안 일괄 가져오기로 신규 사용자를 추가하면 각각의 사용자가 환영 이메일 메시지를 받게 됩니다. 환영 이메일에는 이메일 주소를 확인하는 링크가 포함되어 있으며 비밀번호를 선택한 다음 로그인하라는 메시지가 표시됩니다. 이러한 사용자들에게 환영 이메일을 보내지 않도록 할 수 있습니다.

환영 이메일 메시지를 사용자에게 보내지 않으려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 사람을 클릭한 다음 구성 > 최종 사용자를 선택합니다.
2. 사용자 환영 이메일 섹션에서 또한 상담사나 관리자가 신규 사용자를 만들 때 확인 이메일이 발송됩니다를 선택 취소합니다.

   

3. 저장을 클릭합니다.

CSV 사용자 데이터 파일 만들기

가져올 사용자 목록을 만들 때에는 아마도 직원 데이터베이스와 같은 다른 사용자 관리 시스템에서 이 목록을 만드실 겁니다. 이같은 시스템의 대부분은 CSV 내보내기 파일을 만들 수 있는 기능이 있습니다. 목록을 처음부터 새로 만들어야 한다면 Microsoft Excel이나 OpenOffice.org Calc와 같은 프로그램을 사용할 수도 있습니다.

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

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

참고: MSV Excel로는 파일을 즉시 저장할 수 없습니다. 파일을 저장하려면, Google Sheets로 업로드해서 다시 다운로드 한 후, Zendesk에 업로드 합니다. 또한 Open Office를 사용해서 파일을 저장할 수 있습니다.

다음 표는 파일에 포함할 수 있는 필드를 나열하고 있습니다. 신규 사용자를 가져오는 경우 이름, 이메일, 제한 필드는 모두 필수 사항입니다. 일괄 가져오기를 통해 기존 사용자를 업데이트하는 경우에는 고유 ID 하나만 필요합니다(이메일 또는 외부 ID 등).

표 1. 사용자 가져오기 데이터

필드	설명
name	신규 사용자를 가져오는 데 필요합니다. 사용자의 전체 이름(이름과 성)입니다.
email	신규 사용자를 가져오는 데 필요합니다. 사용자의 전체 이메일 주소([e-mail])입니다. 한 사용자에 대해 두 개 이상의 이메일 주소를 포함하는 경우에는 파이프(|)로 구분하세요. 예: [e-mail]|[e-mail]
external_id	사용자 이메일 주소 외의 ID(직원 ID 또는 고객 참조 번호)가 있다면 여기에 포함시켜도 됩니다. 외부 ID는 사용자마다 달라야 하며, 그렇지 않은 경우 데이터가 덮어쓰기됩니다. 단일 사용자에 대한 여러 이메일 주소나 전화번호를 구성해야 하는 경우에는 CSV 파일에서 해당 사용자에 대해 여러 입력 항목을 만들고 단일 사용자와 연결하려는 모든 행에 대해 동일한 external_id 열을 사용하면 됩니다. 추가적인 이메일이나 전화번호를 제외한 다른 모든 열의 값은 각 행에 대해 동일하게 유지됩니다. 외부 ID, 이메일 주소 또는 전화번호가 두 명 이상의 기존 사용자와 일치하는 경우에는 일괄 가져오기에서 해당 행이 거부됩니다. 참고: external_id 필드를 유일한 식별자로 하여 사용자를 가져오는 경우(즉, 이메일 주소를 포함하지 않음), 데이터가 들어 있지 않더라도 CSV 파일에 이메일 필드를 포함해야 합니다. 예:
details	이 사용자에 관한 세부 정보(예: 주소)로 최종 사용자를 제외한 팀원만 이 정보를 볼 수 있습니다.
notes	이 사용자에 관한 메모로 최종 사용자를 제외한 팀원만 메모를 볼 수 있습니다.
phone (데이터 가져오기 아님)	사용자의 전화번호로 고유한 전화 번호가 직통 라인으로 추가됩니다. 이미 존재하는 전화번호는 보조 라인으로 추가됩니다. Talk에서 작동하려면 전화번호 형식이 국제 표준인 E.164 형식이어야 합니다.
shared_phone_number (데이터 가져오기 아님)	공유 전화번호인 경우 “true”로 설정합니다. 공유 전화번호는 사용자 ID로 사용할 수 없습니다.
전화 (데이터 가져오기만)	사용자의 공유되지 않은 전화번호로 고유한 전화 번호가 직통 라인으로 추가됩니다. 이미 존재하는 전화번호는 보조 라인으로 추가됩니다. Talk에서 작동하려면 전화번호 형식이 국제 표준인 E.164 형식이어야 합니다.
shared_phone (데이터 가져오기만)	사용자의 공유 전화번호로 Talk에서 작동하려면 전화번호 형식이 국제 표준인 E.164 형식이어야 합니다.
role	대소문자 구분: "End-user", "Agent" 또는 "Admin". 역할을 설정하지 않으면 사용자는 최종 사용자로 설정됩니다.
restriction (데이터 가져오기 아님)	제한을 통해 팀원이나 최종 사용자의 권한, 액세스할 수 있는 티켓 등을 설정합니다. 사용자의 역할이 상담사로 설정되어 있을 때 신규 사용자를 가져오기 위해 필요합니다. Enterprise 외 플랜에서는 다음과 같은 제한 값이 지원됩니다. assigned는 티켓이 이 팀원에게만 배정되었음을 의미합니다. groups는 이 팀원 그룹 내의 티켓을 의미합니다. 참고: 그룹에 팀원을 추가하려면 그룹에 팀원 추가 및 제거하기를 참조하거나 Support API를 사용하세요. none은 아무 제한 없이 모든 티켓에 액세스할 수 있음을 의미합니다. organization은 최종 사용자나 팀원 조직의 사용자가 요청한 티켓을 의미합니다. requested는 본인의 티켓을 의미합니다(최종 사용자나 팀원이 요청자임). Light Agent는 사용자에게 라이트 상담사와 똑같은 제한이 적용됨을 의미합니다. 이 값은 데이터 가져오기에서 지원되지 않습니다. 사용자의 역할이 “최종 사용자”로 설정되어 있을 때 “조직” 및 “요청됨”의 제한 값이 할당될 수 있습니다. 참고: Enterprise 플랜에서는 상담사의 역할이 기본 상담사 제한을 무시합니다. 즉 상담사를 가져오거나 업데이트하는 경우에는 위의 표에 나열된 표준 제한을 사용할 수 없다는 뜻입니다. 상담사 역할을 지정해야 합니다. 실수로 Support에 존재하지 않는 역할 이름을 사용할 경우에는 해당 사용자의 역할은 기본적으로 라이트 상담사가 됩니다.
ticket_restriction (데이터 가져오기만)
organization (데이터 가져오기 아님)	사용자가 추가될 조직의 이름으로 단 이 조직은 이미 존재해야 하며, 그렇지 않으면 가져올 수 없습니다. Professional 및 Enterprise 플랜에서는 사용자를 여러 조직에 추가할 수 있으며, 이때 조직 이름들 사이를 세로줄로 구분하면 됩니다. 예: Organization1|Organization2|Organization3 사용자의 기본 조직이 사전순 기준으로 첫 번째 조직으로 설정됩니다. 일괄 가져오기 중에는 다른 기본 조직을 설정할 수 없습니다. 단, 수동으로 또는 Support API - 구성원을 기본으로 설정 엔드포인트로 사용자의 기본 조직을 조정할 수 있습니다.
organizations (데이터 가져오기만)
tags	Zendesk Support에서 사용자 및 조직 태그 지정이 사용 설정되어 있는 경우 (조직에 태그 및 사용자 추가하기 참조), 사용자 태그를 추가할 수 있습니다. 태그는 쉼표로 구분합니다.
brand (데이터 가져오기 아님)	계정에 여러 브랜드가 있는 경우 브랜드 하위 도메인을 지정할 수 있습니다. 브랜드가 활성 상태이고 헬프 센터가 사용 설정되어 있는 경우, 지정된 브랜드 하위 도메인이 사용자에게 보내는 환영 이메일의 브랜드를 결정합니다. 지정한 브랜드 하위 도메인이 비활성 상태이고 헬프 센터가 사용 설정되어 있지 않거나 존재하지 않는 경우에는 해당 열이 무시되고 기본 브랜드를 사용하여 환영 이메일을 보냅니다. 브랜드 하위 도메인의 이름만 지정합니다. 예를 들어 mydomain을 사용하고 mydomain.zendesk.com은 사용하지 않습니다.
custom_fields.<field key>	사용자 일괄 가져오기를 수행할 때 custom_fields. 접두어와 필드 키를 지정하여 사용자 지정 사용자 필드를 가져올 수 있습니다.  예를 들어 subscription_date 필드 키에서는 다음을 이용하여 이 필드에 가져온 값을 설정합니다. custom_fields.subscription_date 사용자 지정 필드 키는 대소문자를 구분하며 소문자로 입력해야 합니다. 확인란에 정보를 가져오는 경우 체크 표시를 하려면 ‘true’를, 체크 표시를 안 하려면 ‘false’를 입력합니다. 드롭다운 목록 옵션의 값을 설정하려면, 드롭다운 목록을 만들 때 추가한 태그를 사용합니다. 사용자 지정 날짜 필드는 YY/MM/DD 또는 YYYY-MM-DD 형식을 사용하세요. 사용자 지정 사용자 필드의 키를 찾으려면 다음과 같이 하세요. 관리 센터의 사이드바에서 사람을 클릭한 다음 구성 > 사용자 필드를 선택합니다. 그런 다음 사용자 지정 필드의 이름을 클릭합니다. 오른쪽 특성 창에 필드 키가 나타납니다. 필드 값의 형식이 올바르지 않으면 가져오기는 실패하고 저장하지 못한 레코드를 명시한 오류 보고서를 받게 됩니다. 참고: 가져오고 있는 사용자 지정 사용자 필드가 조회 관계 필드인 경우에는 관련 개체의 ID를 이 필드의 값으로 입력하세요. 예를 들어 조직에는 조직 ID를 입력하고 사용자에는 사용자의 ID를 입력하고, 사용자 지정 개체 레코드에는 레코드의 ID를 입력합니다. 조직, 사용자 또는 사용자 지정 개체 레코드 ID를 찾으려면 계정에서 데이터를 내보내거나 조직 API, 사용자 API 또는 사용자 지정 개체 레코드 API를 사용할 수 있습니다.

CSV 사용자 데이터 파일 가져오기

일괄 가져오기를 사용하여 신규 사용자를 만들거나 기존 사용자를 업데이트할 수 있습니다.

가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 사용자가 추가됩니다. 각 가져오기를 완료하는 데 걸리는 시간은 CSV 파일의 크기와 대기열 크기에 달려 있습니다.

다음과 같은 방법으로 사용자 일괄 가져오기를 할 수 있습니다.

• 데이터 가져오기를 사용하여 사용자 데이터 가져오기
• 일괄 작업 가져오기를 사용하여 사용자 데이터 가져오기

데이터 가져오기를 사용하여 사용자 데이터 가져오기

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

데이터 가져오기로 사용자를 추가하거나 업데이트하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 도구 > 데이터 가져오기를 선택합니다.
2. 가져오기를 클릭합니다.
3. 대상에서 사용자를 선택합니다.
4. 가져오기 유형에서 다음 중 하나를 선택합니다.
   • 만들기만: 신규 사용자만 추가됩니다. 기존 사용자와 관련된 CSV 파일의 모든 데이터는 무시됩니다.
   • 업데이트만: CSV 파일에 나열된 기존 사용자에 대한 데이터를 업데이트합니다. 사용자를 업데이트하려면 external_id가 필요합니다. 신규 사용자와 관련된 모든 데이터는 무시됩니다.
   • 만들기 및 업데이트: 신규 사용자를 추가하고 CSV 파일에 나열된 기존 사용자에 대한 데이터를 업데이트합니다.
   참고: 외부 ID, 이메일 주소 또는 전화번호가 두 명 이상의 기존 사용자와 일치하는 경우에는 일괄 가져오기에서 해당 행이 거부됩니다. 가져오기 기록를 확인하세요.
5. 파일 업로드 아래에서 파일을 드래그 앤 드롭하거나 클릭하여 업로드로 파일 브라우저에서 CSV 파일을 선택할 수 있습니다.

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

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

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

일괄 작업 가져오기를 사용하여 사용자 데이터 가져오기

데이터 가져오기를 사용할 것을 권장하지만 계속 일괄 작업 페이지를 사용하여 사용자에 대한 새 정보와 업데이트된 정보를 가져올 수 있습니다.

CSV 사용자 데이터를 가져오려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 사람을 클릭한 다음 일괄 작업 > 사용자 가져오기를 선택합니다.
2. 다음 가져오기 옵션 중에서 선택합니다.

   • 신규 사용자 만들기: 기본적으로 선택되며 선택 취소할 수 없습니다. 이는 Zendesk 계정에 없는 CSV 파일에 나열된 사용자가 항상 만들어지기 때문입니다.

   • 기존 사용자 업데이트: 기존 사용자의 데이터도 수정하려면 이 가져오기 옵션을 선택합니다.

     각 사용자의 CSV 파일에 external_id 또는 이메일 주소를 포함시켜야 사용자를 식별할 수 있습니다. 사용자 ID 필드 외에는 CSV 파일에 업데이트하려는 필드만 포함해야 합니다. CSV 파일에 필드 값을 입력하지 않으면 기존 사용자에 대해 그 값을 덮어씁니다. 기존 사용자 프로필 데이터 업데이트하기를 참조하세요.

     외부 ID, 이메일 주소 또는 전화번호가 두 명 이상의 기존 사용자와 일치하는 경우에는 일괄 가져오기에서 해당 행이 거부됩니다.

   참고: 신규 사용자를 추가하지 않으려면 데이터 가져오기를 사용해야 합니다. 일괄 작업 페이지를 사용할 때 CSV 파일에 신규 사용자에 대한 정보가 포함된 경우 선택한 가져오기 옵션에 관계없이 항상 추가됩니다.
3. (선택 사항) CSV 출력 파일에 외부 ID 포함을 선택합니다.

   가져오기 프로세스가 완료되면 별도의 CSV 가져오기 결과 파일의 링크가 포함된 이메일 알림을 받게 됩니다. 이 링크를 사용하여 파일을 다운로드하고 가져오기의 결과를 봅니다. 파일에는 가져오려고 시도한 사용자 데이터의 상태(만듦, 업데이트됨, 건너뜀)가 표시됩니다. 이 옵션을 선택하면 보고서에는 만들거나 업데이트되는 각 사용자의 이메일 주소 또는 외부 ID가 포함됩니다.

   이 옵션을 선택하지 않으면 CSV 내보내기 결과 파일에서 외부 ID가 제외됩니다. 대신 만들거나 업데이트되는 각 사용자에 대해 사용자의 이메일 주소만 나열됩니다.

4. 다음 중 하나를 클릭합니다. 파일 선택 또는 직접 데이터에 붙여넣기
5. 가져오기를 클릭합니다.

가져오기 파일이 대기열에 추가되고 가져오기 과정이 완료되면 Zendesk Support에 사용자가 추가됩니다. 가져오기가 완료되면 이메일을 받게 됩니다.