zendesk-users
Zendesk 사용자 목록을 조회합니다.
zendesk-users profile=PROFILE
- profile=PROFILE
- 필수 옵션. Zendesk 접속 프로파일 이름
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| profile | 문자열 | 접속 프로파일 | Zendesk 접속 프로파일 이름 |
| id | 64비트 정수 | ID | 사용자 생성 시 자동 할당되는 ID |
| org_name | 문자열 | 조직 | 사용자가 소속된 조직명 |
| name | 문자열 | 이름 | 사용자의 전체 이름 |
| 문자열 | 이메일 | 사용자의 기본 이메일 주소 | |
| phone | 문자열 | 전화번호 | E.164 국제 형식의 전화번호 (예: +15551234567) |
| locale | 문자열 | 로케일 | BCP-47 준수 태그 형식의 사용자 언어 (예: en-US, ko-KR) |
| time_zone | 문자열 | 시간대 | 사용자 시간대 (예: Eastern Time (US & Canada), Seoul) |
| last_login_at | 날짜 | 마지막 로그인 | 사용자가 Zendesk Support에 마지막으로 로그인하거나 API 토큰으로 API 요청을 한 시간 |
| tags | 문자열 | 태그 | 사용자 태그 (사용자 태깅이 활성화된 경우) |
| role | 문자열 | 역할 | 사용자 역할 (예: end-user, agent, admin) |
| role_type | 32비트 정수 | 역할 유형 ID | 사용자 역할 유형 ID (0: 커스텀 에이전트, 1: 라이트 에이전트, 2: 챗 에이전트, 3: 챗 기여자, 4: 관리자, 5: 빌링 관리자) |
| role_type_name | 문자열 | 역할 유형명 | 사용자 역할 유형명 (예: custom agent, light agent, admin, billing admin) |
| is_active | 불리언 | 활성 | 사용자가 삭제된 경우 false |
| is_suspended | 불리언 | 정지됨 | true인 경우 사용자가 Help Center에 로그인할 수 없고 티켓이 정지됨 |
| is_verified | 불리언 | 인증됨 | 사용자의 신원 중 하나라도 인증된 경우 true |
| is_mfa_enabled | 불리언 | 다단계 인증 | 다단계 인증이 활성화되어 있는지 여부 |
| is_restricted_agent | 불리언 | 제한됨 | 제한이 있는 상담원의 경우 true; 관리자 및 제한 없는 상담원의 경우 false |
| is_chat_only | 불리언 | 챗 전용 | 사용자가 챗 전용 상담원인지 여부 |
| is_moderator | 불리언 | 모더레이터 | 포럼 모더레이션 권한 지정 |
| is_only_private_comments | 불리언 | 비공개 댓글만 | 사용자가 비공개 댓글만 작성할 수 있는 경우 true |
| ticket_restriction | 문자열 | 티켓 제한 | 티켓 접근 범위 (예: organization, groups, assigned, requested, 또는 null) |
| organization_id | 64비트 정수 | 조직 ID | 사용자의 조직 ID 또는 여러 멤버십이 있는 경우 기본 조직 ID |
| custom_role_id | 64비트 정수 | 커스텀 역할 ID | Enterprise 플랜 이상의 상담원을 위한 커스텀 역할 |
| default_group_id | 64비트 정수 | 기본 그룹 ID | 사용자의 기본 그룹 ID |
| locale_id | 64비트 정수 | 로케일 ID | 사용자의 언어 식별자 |
| external_id | 문자열 | 외부 ID | 다른 시스템의 고유 식별자 (대소문자 구분 안 함) |
| alias | 문자열 | 별칭 | 최종 사용자에게 표시되는 표시 이름 |
| details | 문자열 | 상세 정보 | 사용자에 대한 추가 정보 (예: 주소) |
| notes | 문자열 | 메모 | 사용자에 대한 내부 메모 |
| signature | 문자열 | 서명 | 사용자 서명 (상담원과 관리자만 서명 보유 가능) |
| created | 날짜 | 생성 시간 | 사용자 생성 타임스탬프 |
| updated | 날짜 | 수정 시간 | 마지막 업데이트 타임스탬프 |