기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Zendesk Suite 통합
자연어를 사용하여 Amazon Quick에서 직접 Zendesk 지원 티켓을 관리합니다. Zendesk Suite 작업 커넥터를 사용하면 Amazon Quick을 벗어나지 않고도 지원 티켓을 생성, 업데이트, 검색 및 나열할 수 있습니다.
Zendesk Suite는 Amazon Quick에서 내장 커넥터로 사용할 수 있습니다. 이 통합을 설정하려면 다음 두 단계를 완료합니다. 먼저 Zendesk 계정에 필요한 액세스 권한을 준비합니다. 그런 다음 Amazon Quick에서 커넥터를 생성하고 Zendesk 자격 증명으로 인증합니다.
이 커넥터는 OAuth 사용자 인증 및 API 키 서비스 인증을 지원합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).
## 사전 조건
통합을 설정하기 전에 다음 리소스와 액세스 권한이 있는지 확인합니다.
+ 관리자 역할이 있는 활성 Zendesk 계정입니다.
+ Zendesk 인스턴스에서 티켓에 액세스하고 데이터를 지원할 수 있는 권한.
+ 에 설명된 요구 사항을 충족하는 구독입니다[콘솔에서 통합 설정](integration-console-setup-process.md).
## Zendesk 계정 확인
Amazon Quick을 구성하기 전에 Zendesk 계정이 다음 요구 사항을 충족하는지 확인합니다.
+ Zendesk 계정이 활성 상태이며 [Zendesk 웹 사이트의 Zendesk 로그인 페이지에](https://www.zendesk.com/login/) 로그인할 수 있습니다.
+ 액세스하려는 티켓 및 지원 데이터에 계정에 액세스할 수 있습니다.
## Zendesk 계정 구성
Amazon Quick의 사용자 지정 OAuth 앱 인증 방법에는 Zendesk에 구성된 OAuth 클라이언트가 필요합니다. API 키 인증 방법에는 API 토큰이 필요합니다.
### OAuth 클라이언트를 구성하려면
1. Zendesk 인스턴스에서 API 아래의 **관리 센터**, **앱 및 통합**, **OAuth 클라이언트**로 이동합니다****.
1. **OAuth 클라이언트 추가**를 선택합니다.
1. 다음 필드를 사용하여 양식을 작성합니다.
+ **이름** - 앱의 이름을 입력합니다.
+ **설명** - 간단한 설명을 입력합니다.
+ **식별자** - OAuth 클라이언트의 고유 식별자를 입력합니다.
+ **리디렉션 URLs**-를 입력합니다`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. {{region}}을 AWS 리전으로 바꿉니다. 예: `us-east-1`.
1. **저장**을 선택합니다. Zendesk는 클라이언트 보안 암호를 생성합니다.
**중요**
지금 클라이언트 보안 암호를 기록합니다. 이 페이지를 떠난 후에는 검색할 수 없습니다.
1. 보안 암호를 캡처한 후 **저장**을 다시 선택하여 OAuth 클라이언트를 생성합니다.
사용자 지정 OAuth 앱 인증 방법을 사용하여 Amazon Quick에서 작업 커넥터를 구성할 때 식별자와 보안 암호가 클라이언트 ID 및 클라이언트 보안 암호 역할을 합니다.
자세한 내용은 Zendesk 웹 사이트의 [애플리케이션에서 OAuth 인증 사용을 참조하세요](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application).
### API 토큰을 구성하려면
1. **관리 센터로** 이동한 다음 **앱 및 통합**으로 이동한 다음 **API 토큰으로** 이동합니다.
1. **API 토큰 추가**를 선택합니다.
1. **설명**에 API 토큰에 대한 간단한 설명을 입력합니다.
1. **저장**을 선택합니다. Zendesk는 API 토큰을 생성합니다.
**중요**
지금 API 토큰을 기록합니다. 이 페이지를 떠난 후에는 검색할 수 없습니다.
Amazon Quick에서 API 키 인증 방법을 선택하는 경우이 API 토큰을 API 키 값으로 사용합니다.
자세한 내용은 [Zendesk 웹 사이트의 Zendesk API에 대한 API 토큰 액세스 관리를](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) 참조하세요.
## Amazon Quick에서 통합 설정
Zendesk 계정 액세스를 확인한 후 Amazon Quick에서 커넥터를 생성합니다.
1. Amazon Quick 콘솔에서 **커넥터를** 선택합니다.
1. **팀에 대해 생성** 탭을 선택합니다.
1. 사용 가능한 옵션에서 **Zendesk Suite**를 선택합니다.
1. **Zendesk Suite** 대화 상자에서 다음 필드를 입력합니다.
+ **이름** - Zendesk 커넥터의 설명 이름입니다.
+ **설명(선택 사항)** - **\+ 설명 추가**를 선택하여이 커넥터의 사용 방법에 대한 메모를 추가합니다.
+ **연결 유형** - **퍼블릭 네트워크를** 선택합니다.
1. 인증 방법을 선택하고 커넥터 설정을 구성합니다.
+ **사용자 지정 OAuth 앱** - Zendesk 인스턴스에 대해 다음 필드를 입력합니다.
+ **기본 URL**
+ **클라이언트 ID**
+ **클라이언트 보안 암호**
+ **토큰 URL**
+ **권한 부여 URL**
+ **리디렉션 URL**
+ **API 키** - 다음 필드를 입력합니다.
+ **기본 URL**
+ **API 키**(Zendesk API 토큰)
+ Zendesk 계정과 연결된 **이메일**
1. **다음**을 선택합니다.
1. Zendesk Suite에 대한 작업을 검토하고 **다음을** 선택합니다.
1. 커넥터에 액세스할 수 있는 사용자를 지정합니다.
+ 팀과 공유하려면 팀 이름 또는 그룹 이메일을 입력합니다.
+ 비공개로 유지하려면 필드를 비워 둡니다.
+ 모든 사용자와 공유하려면 **조직의 모든 사용자를 전환합니다**.
1. **게시**를 선택합니다.
커넥터가 **사용 가능** 패널에 **연결**됨 상태로 나타납니다.
## 사용 가능한 작업
커넥터를 설정한 후 다음 티켓 관리 작업을 사용할 수 있습니다.
**Zendesk Suite 사용 가능한 작업**
| 작업 | 설명 |
| --- | --- |
| 티켓 생성 | 새 티켓 생성 |
| 검색 결과 나열 | 티켓 검색 |
| 티켓 나열 | 모든 티켓 보기 |
| 티켓 표시 | 티켓 세부 정보 보기 |
| 티켓 업데이트 | 티켓 세부 정보 편집 |
**참고**
사용할 수 있는 작업은 Zendesk 계정에 구성된 권한에 따라 다릅니다.
## 문제 해결
커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
### 인증 문제
+ **로그인 실패 **- Zendesk 계정이 활성 상태이고 [Zendesk 웹 사이트의 Zendesk 로그인 페이지에](https://www.zendesk.com/login/) 로그인할 수 있는지 확인합니다. 조직에서 SSO(Single Sign-On)를 사용하는 경우 자격 증명 공급자가 올바르게 구성되었는지 확인합니다.
+ **액세스 거부** - Zendesk 사용자에게 티켓에 액세스하고 데이터를 지원할 권한이 있는 관리자 역할이 있는지 확인합니다. API 키 연결의 경우 API 토큰이 유효하고 연결된 이메일 주소가 올바른지 확인합니다.