要件
- AIエージェント（Advanced）ダッシュボードのAIエージェントへの管理者アクセス
- Zendeskサブスクリプション
- Zendeskエージェントワークスペース
- Sunshine Conversationsのライセンス
ステップ1： APIキーを作成する
Zendesk管理センターで、アプリとインテグレーション > API > Conversations APIに移動します。
これが表示されない場合は、Zendeskに連絡して設定に追加してもらうか、Smoochダッシュボードにアクセスできる可能性があります。その場合は、こちらの手順に従ってください。
- AIエージェント用の新しいAPIキーを作成します。
- APIキーに名前を付けます。
- ページが表示され、アプリID、キーID、シークレットをコピーして保存します。
ステップ2：AIエージェント（Advanced）ダッシュボードでグループインテグレーションパラメータを設定する
Sunshine ConversationsをCRMインテグレーションとして追加してから、認証用のインテグレーションパラメータを設定する必要があります。
メモ：Sunshine Groupルーティングを追加しました。これは、さまざまなチャネルで異なるカスタマーからの問い合わせに対応する、ダッシュボードのさまざまなAIエージェントにルーティングできる新機能です。
したがって、現時点ではAIエージェントが1人しかいない場合でも、ZendeskメッセージングとSunshine Conversationsを使用しているすべてカスタマーにこの機能を使用することをお勧めします。
Sunshine ConversationsをCRMインテグレーションとして追加する手順：- 設定 > CRMインテグレーションに移動します。
- CRMインテグレーションを追加をクリックします。
-
Sunshineグループ > グループを作成を選択します。
- グループ転送フィールドに、ZendeskのエージェントグループのグループIDを入力します。グループIDを見つけるには、こちらをクリックしてください。
- アバターURLは、チャットエリア内のアバターのプロフィール画像として使用できる画像です。この機能の背後にあるSunshine Conversations APIは、postMessageエンドポイントです。ドキュメントに記載されているように、avatarUrlはJPG、PNG、GIFのいずれかの形式でなければなりません。メモ - これは現在Sunshine Conversationsでのみ表示され、Zendeskには表示されません。
グループインテグレーションパラメータを設定する手順
- 設定 > CRMインテグレーションに移動します。
- グループインテグレーションパラメータをクリックします。新しいページが開きます。
- このページには、Sunshine Conversationsのステップ1で作成したアプリから取得した情報が表示されます。AIエージェント（Advanced）とSunshine間の接続を認証するには、この情報が必要です。
Sunshine Conversationsからグループインテグレーションパラメータを取得する手順：
-
ステップ1で作成したアプリをクリックし、設定に移動します。
-
次のアプリパラメータをコピーして、AIエージェント（Advanced）ダッシュボードに入力します。
- アプリID
-
キーID
-
シークレットキー
-
メモ - 表示されていない場合は、新しいAPIキーを作成をクリックします。
-
- 保存をクリックします。
ステップ3：AIエージェント（Advanced）とSunshine間の接続を認証する
このステップは、ZendeskでSunshine Conversationsを使用している場合にのみ必要です。 Zendesk以外のプラットフォームを使用している場合は、このステップをスキップしてお問い合わせください。
- AIエージェント（Advanced）ダッシュボードでは何も変更しません。
- 別のタブでSunshine Conversationsを開いてログインします。
-
AIエージェント（Advanced）ダッシュボードの認証で、Sunshine Conversationsを認証をクリックします。
-
新しいページが開きます
-
プロンプトが表示されたら、Zendeskサブドメインを入力し、Zendeskアカウントでサインインします。
-
smoochダッシュボードで認証する場合は、ステップ1で作成したアプリを選択します。
-
-
これは、AIエージェント（Advanced）ダッシュボードのボタンがSunshine Conversationsの認証を解除に変わると完了です。
-
AIエージェントが複数いる場合、この操作は1回だけ行う必要があります。
ステップ4：AIエージェントをテストする
Sunshineウィジェットを開き、AIエージェントと話して、すべてが正常に動作しているかを確認します。
ウィジェットの場所がわからない場合は、SunshineのドキュメントでWebページに追加する方法を確認してください。Webサイトの開発者またはマネージャーに相談し、ドキュメントを共有することをお勧めします。
WhatsApp、Facebook Messenger、Instagramなどの他のチャネルを使用している場合は、さまざまなチャネルとの統合方法に関するSunshine Conversationsのドキュメントを参照してください。各チャネルの詳細をサイドメニューから確認できます。
メモ - AIエージェントのアバター画像をカスタマイズする場合は、次の要件を満たす画像をCSMに提供してください。その後、Zendeskが設定します。
- png、jpg、gif
- 128x128以上のサイズ
- 高さと幅が等しい画像（またはSunshine Conversationsがサイズを調整します）。
FAQ
設定後のインテグレーションパラメータの編集方法
アクティブにしたインテグレーションを編集しようとしても、変更を保存できない可能性があります。これは、ライブインテグレーションが誤って変更されないようにするための安全機能です。
変更することもできますが、その前に自動化トグルをオフにする必要があります。
これをオフにすると、許可されていないSunshine Conversationsボタンをクリックできるようになります。これは非アクティブにすることができます。ここで編集して、前述の手順を繰り返します。
Smoochダッシュボード経由で接続する
ステップ1：Sunshine Conversationsで新しいアプリを作成する
https://app.smooch.io/login経由でSunshine Conversationsにログインし、新しいアプリを作成します。
- Sunshine ConversationsにZendeskインスタンスに接続されているアプリがすでにある場合は、ステップ4に進みます。
- Zendeskを使用していて、Sunshine Conversationsにまだアプリがない場合は、ステップ2に進みます。
- Zendesk以外のプラットフォームを使用している場合は、ステップ4をスキップするか、お問い合わせください。
ステップ2：SunshineアプリをZendeskインスタンスに接続する
このステップは、AIエージェント（Advanced）が動作するために不可欠であり、Sunshine ConversationsまたはZendeskによってのみ実行できます。
Sunshine ConversationsまたはZendeskのアカウントマネージャーに、Sunshine Conversationsのステップ1で作成したアプリにZendeskアカウントを追加するように依頼してください。これが完了すると、Sunshine Conversationsでアプリをクリックすると、接続されたインテグレーションとしてZendeskがリストに表示されます。
これらのステップが完了したら、前述のとおり、ステップ3から続行します。