翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Zendesk Suite の統合
<a name="zendesk-integration"></a>

自然言語を使用して Amazon Quick から直接 Zendesk サポートチケットを管理します。Zendesk Suite アクションコネクタを使用すると、Amazon Quick を離れることなく、サポートチケットを作成、更新、検索、一覧表示できます。

Zendesk Suite は、Amazon Quick の組み込みコネクタとして使用できます。この統合を設定するには、次の 2 つのステップを実行します。まず、必要なアクセス権を持つ Zendesk アカウントを準備します。次に、Amazon Quick でコネクタを作成し、Zendesk 認証情報を使用して認証します。

このコネクタは、OAuth ユーザー認証と API キーサービス認証をサポートしています。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## 前提条件
<a name="zendesk-integration-prerequisites"></a>

統合を設定する前に、次のリソースとアクセス権があることを確認してください。
+ 管理者ロールを持つアクティブな Zendesk アカウント。
+ Zendesk インスタンスでチケットにアクセスしてデータをサポートするアクセス許可。
+ で説明されている要件を満たすサブスクリプション[コンソールで統合を設定する](integration-console-setup-process.md)。

## Zendesk アカウントを検証する
<a name="zendesk-account-setup"></a>

Amazon Quick を設定する前に、Zendesk アカウントが次の要件を満たしていることを確認します。
+ Zendesk アカウントがアクティブであり、Zendesk [ウェブサイトの Zendesk サインインページにサインイン](https://www.zendesk.com/login/)できます。
+ アクセスするチケットとサポートデータは、 アカウントからアクセスできます。

## Zendesk アカウントを設定する
<a name="zendesk-configure-account"></a>

Amazon Quick のカスタム OAuth アプリ認証方法には、Zendesk で設定された OAuth クライアントが必要です。API キー認証メソッドには API トークンが必要です。

### OAuth クライアントを設定するには
<a name="zendesk-configure-oauth"></a>

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 トークンを設定するには
<a name="zendesk-configure-api-token"></a>

1. Admin **Center** に移動し、次に **Apps and integrations** に移動し、次に **API トークン**に移動します。

1. **API トークンの追加**を選択します。

1. **説明** に、API トークンの簡単な説明を入力します。

1. **[保存]** を選択します。Zendesk は API トークンを生成します。
**重要**  
API トークンを今すぐ記録します。このページを離れると取得できません。

Amazon Quick で API キー認証方法を選択した場合は、この API トークンを API キー値として使用します。

詳細については、Zendesk ウェブサイトの「[Managing API token access to the Zendesk API](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API)」を参照してください。

## Amazon Quick で統合を設定する
<a name="zendesk-integration-setup"></a>

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 アカウントに関連付けられた **E** メール

1. [**次へ**] を選択します。

1. Zendesk Suite のアクションを確認し、**次へ**を選択します。

1. コネクタにアクセスできるユーザーを指定します。
   + チームと共有するには、チーム名またはグループ E メールを入力します。
   + 非公開にするには、 フィールドを空白のままにします。
   + すべてのユーザーと共有するには、**組織内のすべてのユーザーを切り替えます**。

1. **[公開]** を選択します。

コネクタは、ステータスが **Connected** の **Available** パネルに表示されます。

## 使用可能なアクション
<a name="zendesk-integration-actions"></a>

コネクタを設定したら、次のチケット管理アクションを使用できます。


**Zendesk Suite で使用可能なアクション**  

| [アクション] | 説明 | 
| --- | --- | 
| チケットの作成 | 新しいチケットを作成する | 
| 検索結果を一覧表示する | チケットの検索 | 
| チケットを一覧表示する | すべてのチケットを表示する | 
| チケットの表示 | チケットの詳細を表示する | 
| チケットの更新 | チケットの詳細を編集する | 

**注記**  
使用できるアクションは、Zendesk アカウントで設定されているアクセス許可によって異なります。

## トラブルシューティング
<a name="zendesk-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="zendesk-troubleshooting-auth"></a>
+ **サインインが失敗**する – Zendesk アカウントがアクティブであり、Zendesk [ウェブサイトの Zendesk サインインページにサインイン](https://www.zendesk.com/login/)できることを確認します。組織がシングルサインオン (SSO) を使用している場合は、ID プロバイダーが正しく設定されていることを確認します。
+ **アクセス拒否** – Zendesk ユーザーに、チケットとサポートデータへのアクセス権限を持つ管理者ロールがあることを確認します。API キー接続の場合は、API トークンが有効で、関連付けられた E メールアドレスが正しいことを確認します。