사용자 일괄 관리

사용자 일괄 관리를 사용하면 CSV 파일의 콘텐츠를 사용하여 많은 수의 사용자를 동시에 만들거나 수정할 수 있습니다. 일괄 사용자 관리 기능은 CCAI Platform 포털에서 설정 > 사용자 및 팀으로 이동하여 확인할 수 있습니다.

이 기능의 이점은 다음과 같습니다.

  • 필수 사용자 데이터 (예: 이메일 주소 및 사용자 이름)를 유지합니다.

  • 각 개별 사용자 속성에 대한 수정 권한을 부여합니다. CSV 파일을 업로드할 때 사용자 레코드의 각 열을 업데이트할 수 있는 사용자 역할을 세부적으로 구성합니다. 자세한 내용은 사용자 관리 역할 및 권한 일괄 지정을 참고하세요.

  • 사용자 역할을 설정하고, 사용자를 활성화 또는 비활성화하고, 채팅 동시성 및 위치 설정과 같은 기타 속성을 유지합니다.

사용자 가져오기 디스플레이에서 제공된 템플릿을 사용하여 새 사용자의 정보를 입력하거나 기존 사용자를 수정하도록 업데이트할 수 있는 모든 현재 사용자의 CSV 파일을 다운로드할 수 있습니다. 자세한 내용은 대량 사용자 관리 템플릿을 참고하세요.

CSV 파일 업로드에 오류가 포함된 경우 오류가 포함된 레코드 수와 성공적으로 업로드된 레코드 수를 나타내는 메시지가 표시됩니다. 오류 로그 다운로드를 클릭하여 오류가 포함된 레코드와 오류가 있는 특정 필드를 보여주는 파일을 다운로드합니다. 자세한 내용은 대량 사용자 관리: 오류 해결을 참고하세요.

사용자를 추가하고 업데이트하려면 사용자 일괄 관리: 신규 또는 업데이트된 사용자 업로드를 참고하세요.

사용자를 개별적으로 추가하려면 사용자 추가 및 보기를 참고하세요.

사용자 일괄 관리 템플릿

제공된 템플릿을 작성하고 CSV 파일을 업로드하여 사용자 데이터를 가져와 새 사용자를 추가할 수 있습니다. 기존 사용자의 CSV 파일을 다운로드하고 파일을 수정하여 기존 사용자 계정을 변경할 수도 있습니다.

제공된 템플릿 중 하나를 사용하는 대신 자체 CSV 파일을 업로드할 수도 있지만 파일의 열은 템플릿의 열에 해당하고 동일한 순서로 표시되어야 합니다. 파일은 업로드할 수 있는 CSV 파일 형식이어야 합니다.

제공된 두 템플릿 파일 모두 지정된 순서로 다음 열을 포함합니다.

표 1. 사용자 일괄 관리 템플릿

주문

열 유형

열 개수

열 이름

유효한 값

필수 열

1

이메일

1

이메일

이메일

예

2

이메일

1

새 이메일

이메일

아니요

3

별칭

1

별칭

문자열

아니요

4

에이전트 ID

1

에이전트 ID

문자열

아니요

5

이름

1

이름

문자열

예

6

성

1

성

문자열

예

7

상태

1

상태

  • 활성

  • 비활성

  • 비어 있음

아니요

8

위치

1

위치

  • 위치 이름인 문자열

  • 비어 있음 (변경사항 없음)

  • Null (현재 위치 삭제)

아니요

9

채팅 동시성

1

채팅 동시성

  • 1~X (X는 구성된 값)

  • 비어 있음

아니요

10

채팅 동시 실행 상태

1

채팅 동시 실행 상태

  • 0

  • 1

  • 비어 있음

아니요

11

역할

다수

역할: 역할 이름 A

역할: 역할 이름 B

역할: 역할 이름 C

[기타]

  • 0

  • 1

  • 비어 있음

아니요

12

제한이 없는 국제 전화

1

제한이 없는 국제 전화

  • 0

  • 1

  • 비어 있음

아니요

13

외부 사용자

1

외부 사용자

  • 0

  • 1

  • 비어 있음

아니요

14

SIP URI

1

외부 SIP URI

문자열

아니요

15

Contact Center AI Platform 사용자 이름

1

Contact Center AI Platform 사용자 이름

문자열

아니요

16

팀

다수

팀: 팀 이름 A

팀: 팀 이름 B

팀: 팀 이름 C

[기타]

  • 0

  • 1

  • 비어 있음

아니요

17

전화번호

다수

Direct Inbound Number: 1

Direct Inbound Number: 2

Direct Inbound Number: 3

[기타]

전화번호가 164 형식

아니요

18

확장 프로그램

1

확장 프로그램

  • 비어 있음: 지정된 에이전트의 확장 프로그램 구성이 변경되지 않음

  • Null: 지정된 상담사의 확장 프로그램 값을 삭제합니다 (대소문자 구분 안 함).

  • Auto: 상담사에 대해 자동 생성된 내선 번호를 만듭니다 (대소문자 구분 안 함).

아니요

역할 및 팀 필드의 경우 사용자를 여러 역할 또는 팀에 할당하기 위해 추가 열을 포함해야 합니다. 각 역할 또는 팀은 이전 표에 표시된 형식으로 CSV 파일에 별도의 열로 입력해야 합니다 (예: 역할: 역할 이름 A, 역할: 역할 이름 B). 이러한 값은 CCAI Platform 포털에 이미 있는 역할 및 팀과도 일치해야 합니다.

대량 사용자 관리 역할 및 권한

역할 및 권한 디스플레이에서 관리자는 사용자 레코드의 각 필드에 대한 수정 권한을 역할에 부여할 수 있습니다. 사용자 레코드의 각 필드에 사용할 수 있는 특정 권한이 있으며, 할당된 역할에 액세스 권한이 있는 필드만 CSV 파일에 포함됩니다.

개별 필드 권한을 설정하려면 먼저 사용자 만들기 또는 사용자 수정 권한이 할당된 역할이 있어야 합니다. 사용자 생성 권한이 설정된 경우 할당된 역할은 새 사용자를 추가할 수 있지만 기존 사용자를 수정할 수는 없습니다. 사용자 수정 권한이 부여되면 할당된 역할은 기존 사용자 레코드를 수정할 수 있지만 새 사용자를 만들 수는 없습니다. 두 권한이 모두 할당된 경우 역할은 새 사용자를 만들고 기존 사용자를 수정할 수 있습니다.

이러한 권한에 따라 할당된 역할은 사용자 수정 권한이 있고 레코드의 해당 필드에 수정 권한이 할당된 경우에만 CSV 파일의 열을 변경할 수 있습니다. 할당된 역할에 필드의 수정 권한이 없으면 CSV 파일이나 템플릿을 다운로드할 때 열이 포함되지 않습니다.

사용자 일괄 관리

다음 각 열에는 수정 액세스를 허용하도록 설정할 수 있는 개별 권한이 있습니다.

  • 이메일

  • 에이전트 ID

  • 이름 및 성

  • 상태

  • 위치

  • 채팅 동시 실행 및 채팅 동시 실행 상태

  • 역할

  • 팀

사용자에게 할당된 역할에 수정 권한이 포함되어 있지 않으면 사용자가 해당 필드를 변경할 수 없습니다. 사용자가 수정 권한이 없는 필드를 변경하려고 하면 유효성 검사 중에 오류가 발생하고 해당 레코드가 업로드되지 않습니다.

사용자 일괄 관리: 신규 또는 업데이트된 사용자 업로드

새 사용자를 동시에 여러 명 업로드하려면 사용자 일괄 가져오기 섹션에 제공된 샘플 템플릿을 다운로드하거나 설명된 열을 사용하여 자체 CSV 파일을 업로드하면 됩니다.

기존 사용자를 수정하려면 전체 사용자 목록 CSV 파일을 다운로드하고 필요한 변경사항을 적용한 다음 CSV 파일을 다시 업로드합니다.

  1. CCAI Platform 포털에서 설정 > 사용자 및 팀으로 이동합니다.

  2. 사용자 및 팀 설정 디스플레이에서 사용자 일괄 관리 탭을 클릭합니다.

    사용자 일괄 관리

  3. 사용자 업로드를 클릭합니다.

    사용자 업로드

  4. 사용자 가져오기 디스플레이에서 1단계: 템플릿 다운로드 섹션의 버튼을 사용하여 사용자를 추가하거나 수정하는 데 사용할 파일을 다운로드합니다.

    사용자 가져오기 표시

  5. 새 사용자를 추가하려면 템플릿을 클릭하여 추가할 사용자의 정보로 채울 수 있는 샘플 CSV 파일을 다운로드합니다.

  6. 기존 사용자를 수정하려면 전체 사용자 목록을 클릭하여 현재 모든 사용자의 정보를 CSV 파일로 다운로드합니다. 그런 다음 필요한 변경사항을 적용하여 이 파일에서 기존 사용자를 수정할 수 있습니다.

  7. CSV 파일이 업데이트되면 3단계: CSV 업로드 섹션으로 이동하여 업데이트된 CSV 파일을 제공된 공간으로 드래그 앤 드롭하거나 파일 찾아보기를 클릭하여 업로드할 파일을 수동으로 선택합니다.

    CSV 파일 찾아보기

  8. 4단계에서 처리를 클릭합니다. CCAI Platform 포털에서 CSV 파일을 검증하고 일괄 사용자 관리 표시로 돌아갑니다.

  9. 파일의 유효성 검사가 완료되면 요청된 대로 사용자가 추가되거나 수정되고, 사용자 목록 관리 권한이 있는 사용자에게 변경사항을 알리는 이메일 알림이 전송됩니다.

  10. 파일의 필드 중 하나라도 유효성 검사에 실패하면 오류 수와 업데이트된 레코드 수를 나타내는 오류 메시지가 표시됩니다. 오류 로그 다운로드를 클릭하여 오류 목록을 확인하거나 다시 시도를 클릭하여 파일의 유효성 검사를 다시 시도합니다.

오류의 잠재적 원인과 업데이트된 CSV 파일을 다시 제출하는 방법에 대한 자세한 내용은 오류 해결을 참고하세요.

오류 해결

파일 업로드에 오류가 포함된 경우 오류가 포함된 레코드 수와 성공적으로 업로드된 레코드 수를 나타내는 메시지가 표시됩니다. 오류 로그 다운로드를 클릭하여 오류가 포함된 레코드와 오류가 있는 특정 필드를 보여주는 파일을 다운로드합니다.

파일 업로드 오류

오류 로그에는 오류의 이유가 나열되고 오류가 발생한 행과 열이 표시됩니다. 오류 로그에는 특정 열을 수정하는 데 필요한 권한이 할당된 역할에 없는 것과 같은 경고도 포함됩니다.

표 2. 샘플 오류 로그 결과

오류 열 행
역할 이름 A가 CCAI Platform에 있어야 합니다. 9
팀 이름 A가 CCAI Platform에 있어야 합니다. 19
이메일은 고유해야 합니다. 1 25
이름은 비워 둘 수 없습니다. 3 190
성은 비워 둘 수 없습니다. 4 195
상태는 Active, Inactive 또는 비어 있어야 합니다. 5 89
위치는 CCAI 플랫폼의 기존 위치와 일치해야 합니다. 6 20
채팅 동시 실행은 1~X 범위 내에 있어야 합니다. 7 78
역할 이름 A는 0, 1 또는 비워야 합니다. 9 22
팀 이름 A는 0, 1 또는 비워야 합니다. 19 165

로그의 오류를 해결하기 위해 CSV 파일을 필요한 대로 변경합니다. 오류가 해결되면 이전 섹션에 설명된 것과 동일한 방법으로 CSV 파일을 다시 업로드하여 유효성 검사를 실행합니다.

오류가 없으면 파일이 성공적으로 처리됩니다. 파일에 오류가 계속 남아 있으면 새 오류 로그를 다운로드하고 이 프로세스를 반복합니다.