AIエージェントダッシュボードでは、Sunshine Conversationsと直接ではなく、メッセージングとボットを統合する場合は、テンプレートを作成できません。

このレシピでは、Sunshine Conversations （SunCo） API を使用してテンプレートを作成し、ダイアログフローで短縮形を適用する方法について説明します。

メモ：Sunshine Conversationsに直接統合されたボットのテンプレートを作成するには、以下を参照してください。テンプレートSunshine Conversationsを作成します。

このワークフローには以下のステップが含まれます。 

  • ステップ1：必要なAPIキーを作成する
  • ステップ2：APIキーとSunCo APIを使用してテンプレートを作成する
  • ステップ3：Sunshine Conversationsをダイアログフローで簡潔に適用する

ステップ1：必要なAPIキーを作成する

Conversations APIキーを作成するには、この記事の手順に従ってください。Conversations APIキーの使用。

ステップ2：APIキーとSunCo APIを使用してテンプレートを作成する

SunCo APIを呼び出すには、Postmanなどのツールが必要です。 

SunCo APIを使用したPostmanの設定

  1. 同社のWebサイトからPostmanアプリをダウンロードします。Postmanダウンロード
  2. SunCo Postmanコレクションをダウンロードするには、ファイルを右クリックしてローカルドライブに保存します。「Postman collection file」を参照
  3. Postmanで、コレクションファイルをインポートするには、右上隅の「インポート」を選択します。これにより、コレクションがインポートされ、「Smooch」という名前を付けられます。

Conversations APIキーでPostmanを認証

  1. 「Smooch」という名前の新しく作成したコレクションをクリックし、「Variables」タブを選択します。
  2. 次の3つの新しい変数を追加します: keyId、appId、およびsecret
  3. 「現在の値」列で、対応する値と管理センターから取得した値を追加します。
  4. 右上隅の「保存」をクリックします。
  5. 「Authorization」タブを選択します。
  6. 「 Auth Type」ドロップダウンメニューをクリックし、「 Basic Auth」を選択します。
  7. 「 ユーザー名」フィールドに、変数「{{keyId}}」を追加します。これは、「変数」タブで設定された keyId値を参照します。
  8. 「パスワード」フィールドに変数 {{secret}}を追加します。
  9. 右上隅の「保存」をクリックします。

テンプレートを作成

さまざまなテンプレートを含むテンプレートを作成するには、次の手順に従います。新しいテンプレートの作成に使用されるエンドポイントは、Create Templatesエンドポイントです。このエンドポイントのAPIドキュメントはこちらで参照できます。

  1. Postmanで、 Templatesフォルダ> Create Template Examplesを開きます。テンプレートを作成するエンドポイントの例はこちらにあります
  2. エンドポイントの例を選択し、応答の本文を入力します。独自のエンドポイントを作成していちから作成することもできます
  3. 右上隅の the Send ボタンをクリックしてリクエストを送信し、テンプレートを作成します。応答はnameフィールドを返します。次の手順で必要になるので、必ずコピーしてください。

ステップ3：Sunshine Conversationsをダイアログフローに簡潔に適用する

専用の短縮構文を使用してテンプレートを送信できます。AI エージェントがテンプレートを送信するようにするには、対話ビルダー内の AI エージェントメッセージブロックに省略名を追加する必要があります。

  1. AIエージェントの詳細ダッシュボードで、テンプレートの送信先となるダイアログを開きます。
  2. 対話フローにAIエージェントメッセージブロックを追加する
  3. 新しく作成したブロックに、短縮構文でテンプレートを追加します。%((template:value_of_name_field))%
  4. 対話を公開

ボットは会話フローの途中でテンプレートを送信します。APIを使用してテンプレートに変更を加える必要があります。

翻訳に関する免責事項：この記事は、お客様の利便性のために自動翻訳ソフ トウェアによって翻訳されたものです。Zendeskでは、翻訳の正確さを期すために相応の努力を払っておりますが、翻訳の正確性につ いては保証いたしません。

翻訳された記事の内容の正確性に関して疑問が生じた場合は、正式版である英語の記事 を参照してください。

Powered by Zendesk