View a markdown version of this page

Zendesk Suite の統合 - Amazon Quick
前提条件Zendesk アカウントを検証するZendesk アカウントを設定するAmazon Quick で統合を設定する使用可能なアクショントラブルシューティング

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

Zendesk Suite の統合

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

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

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

前提条件

統合を設定する前に、次のリソースとアクセス権があることを確認してください。

  • 管理者ロールを持つアクティブな Zendesk アカウント。

  • Zendesk インスタンスでチケットにアクセスしてデータをサポートするアクセス許可。

  • で説明されている要件を満たすサブスクリプションコンソールで統合を設定する。

Zendesk アカウントを検証する

Amazon Quick を設定する前に、Zendesk アカウントが次の要件を満たしていることを確認します。

Zendesk アカウントを設定する

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

OAuth クライアントを設定するには

  1. Zendesk インスタンスで、管理者センターに移動し、次にアプリと統合に移動し、次に API で OAuth クライアントに移動します。

  2. OAuth クライアントの追加を選択します。

  3. 次のフィールドを使用してフォームに入力します。

    • 名前 – アプリの名前を入力します。

    • 説明 – 簡単な説明を入力します。

    • 識別子 – OAuth クライアントの一意の識別子を入力します。

    • リダイレクト URLs と入力しますhttps://region.quicksight.aws.amazon.com/sn/oauthcallback。region を などの AWS リージョンに置き換えますus-east-1。

  4. [保存] を選択します。Zendesk はクライアントシークレットを生成します。

    重要

    クライアントシークレットを今すぐ記録します。このページを離れると取得できません。

  5. シークレットをキャプチャしたら、もう一度保存を選択して OAuth クライアントを作成します。

識別子とシークレットは、カスタム OAuth アプリ認証方法で Amazon Quick でアクションコネクタを設定するときに、クライアント ID とクライアントシークレットとして機能します。

詳細については、Zendesk ウェブサイトの「アプリケーションで OAuth 認証を使用する」を参照してください。

API トークンを設定するには

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

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

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

  4. [保存] を選択します。Zendesk は API トークンを生成します。

    重要

    API トークンを今すぐ記録します。このページを離れると取得できません。

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

詳細については、Zendesk ウェブサイトの「Managing API token access to the Zendesk API」を参照してください。

Amazon Quick で統合を設定する

Zendesk アカウントアクセスを確認したら、Amazon Quick でコネクタを作成します。

  1. Amazon Quick コンソールで、コネクタを選択します。

  2. チームの作成タブを選択します。

  3. 使用可能なオプションから Zendesk Suite を選択します。

  4. Zendesk Suite ダイアログで、次のフィールドに入力します。

    • 名前 – Zendesk コネクタのわかりやすい名前。

    • 説明 (オプション) – 説明を選択して追加し、このコネクタの使用方法に関するメモを追加します。

    • 接続タイプ – パブリックネットワークを選択します。

  5. 認証方法を選択し、コネクタ設定を構成します。

    • カスタム OAuth アプリ – Zendesk インスタンスの次のフィールドに入力します。

      • ベース URL

      • クライアント ID

      • クライアントシークレット

      • トークン URL

      • 認可 URL

      • リダイレクト URL

    • API キー – 次のフィールドに入力します。

      • ベース URL

      • API キー (Zendesk API トークン)

      • Zendesk アカウントに関連付けられた E メール

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

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

  8. コネクタにアクセスできるユーザーを指定します。

    • チームと共有するには、チーム名またはグループ E メールを入力します。

    • 非公開にするには、 フィールドを空白のままにします。

    • すべてのユーザーと共有するには、組織内のすべてのユーザーを切り替えます。

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

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

使用可能なアクション

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

Zendesk Suite で使用可能なアクション
[アクション] 説明
チケットの作成 新しいチケットを作成する
検索結果を一覧表示する チケットの検索
チケットを一覧表示する すべてのチケットを表示する
チケットの表示 チケットの詳細を表示する
チケットの更新 チケットの詳細を編集する
注記

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

トラブルシューティング

コネクタを編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

  • サインインが失敗する – Zendesk アカウントがアクティブであり、Zendesk ウェブサイトの Zendesk サインインページにサインインできることを確認します。組織がシングルサインオン (SSO) を使用している場合は、ID プロバイダーが正しく設定されていることを確認します。

  • アクセス拒否 – Zendesk ユーザーに、チケットとサポートデータへのアクセス権限を持つ管理者ロールがあることを確認します。API キー接続の場合は、API トークンが有効で、関連付けられた E メールアドレスが正しいことを確認します。