このガイドでは、Sunshine ConversationsでAPIコールを使用してチャネルごとにデフォルト回答者を設定する方法について説明します。
メモ:このガイドではPostmanを使用します。Postmanをお持ちでない場合は、Postman Webサイトでアカウントに登録して、アプリをダウンロードしてください。
APIテンプレートをインポートする
- postman_collection.jsonファイルを開きます。コレクションはJSON形式で、人間が読みやすいものではありません。
- テキスト全体を選択してコピーします。
3. Postmanを開き、インポートクリックします。
4. コレクションファイルの内容を「cURL、未加工テキストまたはURLを貼り付け」テキストボックスに貼り付けます。
Sunshine Conversations APIコレクションがPostmanインターフェイスに表示されます。
コレクションリストからPATCH APIコールを選択
- PostmanでSunshine Conversations APIコレクションから、インテグレーション > インテグレーションを更新を選択します。
-
メッセージングからインテグレーションIDのリストを取得するのステップに従って、インテグレーションIDとAIエージェントのデフォルト回答者IDの完全なリストを取得します。
デフォルト回答者IDは、すべてのインテグレーションで同じです。
- PATCH APIコールの場合、デフォルトのエンドポイントをZendesk APIキー(AIエージェント(Advanced)への接続で使用したものと同じもの)のアプリIDと、変更するインテグレーションIDに置き換えます。この例では、iOSインテグレーションをターゲットにして、アプリのSDKなしでWeb上で起動できるようにします。
- 上図のように、認証タブをクリックし、Basic認証を選択しますZendeskの同じAPI情報から取得したキーIDとシークレットキーを入力します。
- 本文タブで、AIエージェントのデフォルト回答者IDでAIエージェントを使用するように、インテグレーション(iOS)を手動で設定します(すでに設定されている場合でも)。
「defaultResponderId」を除く本文内のすべての内容を削除し、インテグレーションリストのAPIコールから取得したIDを追加します。不要なカンマは削除してください。
- PATCH APIコールを実行し、Integration List GET APIコールに従って、正常に更新されたことを確認します。
変更後、iOSチャネルは引き続きAIエージェントを使用します。ただし、「inherited」フィールドはfalseに設定されました。これは、AIエージェント(Advanced)が接続されても、AIエージェント(Advanced)に自動的に切り替わらないことを示します。
- AIエージェント(Advanced)をZD本番環境に接続します。「inherited = true」とマークされたチャネルのみがこれを使用することに注意してください。
- カスタマーが追加のチャネルをAIエージェント(Advanced)に移行することを決定したら、値「null(引用符なし)」を対象のチャネルのインテグレーションIDに送信します。このアクションにより、チャネルがデフォルトの動作に戻り、AIエージェント(Advanced)とZendeskは、AIエージェント(Advanced)の接続状態に応じて交互に切り替わります。
iOSチャネルがAIエージェント(Advanced)を使用していることがリストに表示されます。
AIエージェント(Advanced)の接続を解除すると、継承ステータスとマークされたすべてのチャネルがAIエージェントに戻り、その逆も同様です。AIエージェントに手動で設定されたチャネルは、AIエージェントに残ります。
警告:継承プロパティをfalseに設定し、チャネルをAIエージェント(Advanced)に手動で設定しないでください。そうすることで、AIエージェント(Advanced)とZendeskとの接続の解除を防ぐことができます。AIエージェント(Advanced)に問題が発生した場合、デフォルトの回答者はAIエージェント(Advanced)に残り、チャットに応答できなくなる可能性があります。