前提条件
コネクションを設定する前に、以下の手順で OAuth アプリケーションを作成します(OAuth および OAuthPKCE のみ):1
管理者アクセス権を持つアカウントで Zendesk にログインします。
2
Zendesk Support の管理画面で、Admin > Channels > API に移動します。
3
Zendesk API ページで OAuth Clients タブをクリックします。
4
クライアント一覧の右側にあるプラスアイコン(+)をクリックします。
5
必須フィールドを入力してクライアントを作成し、Redirect URI を https://oauth.cdata.com/oauth/ に設定します。
6
Save をクリックします。ページが更新されると、Secret フィールドが表示されます。
OAuth アプリケーションの Client kind が Confidential に設定されている場合は、OAuth 認証を使用する必要があります。Client kind が Public に設定されている場合は、OAuthPKCE 認証を使用する必要があります。
セットアップガイド
以下の手順で、Zendesk をConnect AI アカウントに接続します:1
Connect AI のナビゲーションメニューからSources ページを開きます。
2
右上の + Add Connection をクリックします。
3
検索フィールドに Zendesk と入力し、データソース名をクリックします。
4
新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
5
Zendesk Support の URL を入力します。
6
認証方法を選択し、該当するセクションに進んで手順に従います。
認証方式
- OAuth
- OAuthPKCE
- APIToken
1
OAuth Client Id フィールドに、前提条件で取得した一意の識別子を入力します。
2
OAuth Client Secret フィールドに、前提条件で取得したシークレットを入力します。
3
OAuth でセキュアに接続するには、Sign in をクリックします。これにより、Zendesk のサインインページが新しいタブで開かれます。
4
Zendesk アカウントにログインし、リクエストされた権限を設定します(該当する場合)。
5
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。