オファーとディールの事前構築済みコンポーネントは、呼び出し元が登録ユーザーかどうかを確認します。ユーザーが登録済みのアカウントがある場合、コンポーネントは、ユーザー固有のオファーやディールに関する情報を提供できます。ユーザーは、一般的なオファーやディールの詳細を確認したり、特定のクーポンコードに関する問題を報告したりすることもできます。このコンポーネントは、英数字の収集の事前構築済みコンポーネントを使用してクーポンコードを収集します。このコンポーネントでは、通話後の要約、よくある質問、オファーの詳細に生成ツールも使用します。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニーを使用して呼び出されたときの動作を示しています。呼び出しにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
ユーザー固有および一般的なオファーとディール
エンドユーザーは認証済みです。ユーザーが最新のオファーを尋ねると、エージェントはユーザーに固有のオファーのリストを提示します。ユーザーはオファーについていくつかの質問を行い、特定のカテゴリのオファーについて質問します。エージェントは、カテゴリのオファーのリストを提示します。エージェントはユーザーにオファーの詳細を送信することを提案し、ユーザーは断ります。
| ユーザー入力 | エージェントの応答 |
|---|---|
| ようこそ。最新のオファーを確認しますか？または特定のクーポンコードに関する問題でお困りのことはありますか？ | |
| 最新のオファーを確認したい | |
| 確認ですが、オファーをお探しですね。間違いありませんか？ | |
| はい | |
| 以下のおファーが見つかりました。詳細は次のとおりです。 オファー 1: 衣料品が 5% オフ。コード APPARELS5 をご利用ください。有効期限は 2024 年 3 月 28 日までです。 オファー 2: 食料品が 15% オフ。コード GROCERY500 を補利用ください。有効期限は 2024 年 3 月 28 日までです。 これらのオファーがお役に立てば幸いです。オファーやディールに関して回答できる質問はありますか？ |
|
| 食料品のオファーに最小購入額はありますか？ | |
| はい。食料品の 15% 割引を利用するには、最低購入額が 10 件に設定されています。このオファーを利用するにはコード GROCERY500 をご利用ください。有効期間は 2024 年 3 月 28 日までです。 必要な情報をお伝えできたでしょうか。オファーやディールに関して回答できる質問はありますか？ |
|
| 電子機器のオファーはありますか？ | |
| もちろんです。オファーの詳細は次のとおりです。 オファー 1: 電子機器が 5% オフ。コード ELECTRIC5 をご利用ください。有効期限は 2024 年 3 月 28 日までです。 オファー 2: 電子機器が 15% オフ。コード ELECTRIC15 をご利用ください。有効期限は 2024 年 3 月 28 日です。 必要な情報をお伝えできたでしょうか。オファーやディールに関して回答できる質問はありますか？ |
|
| いいえ。これで終了する | |
| オファーの詳細を、登録済みのモバイル デバイスまたはメールで共有しますか？ | |
| いいえ。 | |
| お電話ありがとうございます。 |
クーポンコードに関する問題
エンドユーザーは認証済みです。ユーザーは、クーポンコードに問題があると言っています。エージェントはクーポンコードを収集し、クーポンコードの利用に関する詳細をユーザーに提供します。ユーザーがクーポンコードに問題があることを確認すると、エージェントはチケットを送信して問題を報告します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| ようこそ。最新のオファーを確認しますか？または特定のクーポンコードに関する問題でお困りのことはありますか？ | |
| クーポンコードに問題がある | |
| 確認ですが、クーポンコードをお探しですね。間違いありませんか？ | |
| はい | |
| お客様のご期待に添えず、誠に申し訳ございません。ご利用のクーポンコードをお知らせいただけますか？ | |
| エージェントは、英数字の収集の事前構築済みコンポーネントを使用してクーポンコードを収集する | |
| 衣料品に関連付けられている特典コード APPARELS5 は、最低 100$ の購入が必要で、2024 年 3 月 28 日まで有効です。最低購入額の要件などの条件が満たされていることをご確認ください。 この情報はお役に立ちましたか？ |
|
| いいえ | |
| 発生した問題を指定してください。たとえば、クーポンコードが機能しない、またはその地域でコードが機能しないなどと指定することができます。 | |
| クーポンコードが機能しない | |
| 確認ですが、クーポンコードの問題は、クーポンコードが機能しないということですね。よろしいですか？ | |
| はい | |
| お客様の問題を報告するためのチケットを発行しました。お電話ありがとうございます。 |
命名規則
この事前構築済みコンポーネントでは、次の命名規則が使用されています。
| 機能 | 形式 | 例 |
|---|---|---|
| フロー | [コンポーネント名] | オファーとディール |
| エンティティ タイプ | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
入力パラメータ
入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。
この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | （省略可）ユーザーの識別に使用される、国コードなしのユーザーの電話番号。 | 文字列 |
この事前構築済みコンポーネントでは、次のオプションのパラメータを使用して、再試行を含むコンポーネントの動作を構成できます。
| パラメータ名 | 説明 | 形式 |
|---|---|---|
| $flow.max_retry_concern_type | ユーザーがオファーを聞きたいか、クーポンコードに関する問題を報告するかを選択する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_offers_category | オファーを聞くためにカテゴリを提供するときに許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_another_coupon_code | ユーザーが問題を抱えている特定のクーポンコードを指定する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_coupon_code_issue_counter | ユーザーがクーポンコードに関連する問題を指定する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_message_confirm_channel | オファーの詳細を受け取るチャネルを指定するときに許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.valid_coupon_code_status | クーポンコードが有効であることを示す get_coupon_code_details Webhook から返される coupon_code_status フィールドの値を指定します。デフォルト値は "valid" です。 |
文字列 |
| $flow.invalid_coupon_code_status | クーポンコードが無効であることを示す get_coupon_code_details Webhook から返される coupon_code_status フィールドの値を指定します。デフォルト値は "invalid" です。 |
文字列 |
| $flow.expired_coupon_code_status | クーポンコードが期限切れであることを示す get_coupon_code_details Webhook から返される coupon_code_status フィールドの値を指定します。デフォルト値は "expired" です。 |
文字列 |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Build] タブを選択します。
- [Flows] セクションでインポートされたコンポーネントをクリックします。
- [Pages] セクションで [Start Page] をクリックします。
- スタートページで true ルートをクリックします。
- [Route] ウィンドウで、必要に応じて [Parameter Presets] 値を編集します。
- [Save] をクリックします。
出力パラメータ
出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| transfer_reason | このパラメータは、フローが失敗した場合に終了した理由を示します。戻り値は次のいずれかです。agent: エンドユーザーが会話中のいずれかの時点で人間のエージェントをリクエストした。denial_of_information: エンドユーザーが、コンポーネントによってリクエストされた情報を共有することを拒否した。max_no_input: 会話が回答なしイベントの再試行の最大回数に達した。回答なし組み込みイベントをご覧ください。max_no_match: 会話が一致なしイベントの再試行の最大回数に達しました。一致なし組み込みイベントをご覧ください。webhook_error: Webhook エラーが発生しました。webhook.error の組み込みイベントをご覧ください。webhook_not_found: Webhook URL にアクセスできませんでした。webhook.error.not-found の組み込みイベントをご覧ください。 |
文字列 |
生成ツール
このコンポーネントは、生成ツールを使用して会話の特定の部分を有効にします。
要約
Summarization 生成ツールは、コンポーネントによって処理される会話を記述する通話後の要約を生成します。
一般的なよくある質問
General FAQ 生成ツールは、割引、セール、購入、ポイント プログラムに関連するよくある質問の処理に使用されます。
- 気が変わった場合は、セール商品を返品できますか？
- 特定の商品の購入で無料サンプルやギフトを受け取れますか？
- 購入した商品が後にセールになった場合、価格調整はありますか？
- ポイント プログラムの特典の利用に期限はありますか？
ユーザー固有のオファーの詳細
User-specific offer details 生成ツールは、get_offers_details Webhook から提供される情報に基づいて、ユーザー固有のオファーの詳細を提供するために使用されます。
オファーとディールの詳細
Offers and deals details 生成ツールは、get_offers_details Webhook から提供される情報に基づいて、一般的なオファーやディールの詳細を提供するために使用されます。ユーザーは、特定のカテゴリのオファーについて質問したり、特定のオファーの詳細について質問したりできます。
オファーやディールに関するよくある質問
Offers and deals FAQ 生成ツールは、オファーやディールに関連するよくある質問の処理に使用します。
- 新規顧客向けのスペシャル オファーはありますか？
- 今後のディールについて通知を受け取るにはどうすればよいですか？
- 店舗またはオンラインでのみ利用できるディールはありますか？
- 新しいディールがプラットフォームに追加される頻度はどれくらいですか？
割引とプロモーション コードに関するよくある質問
Discount and promo code FAQ は、割引やプロモーション コードに関連するよくある質問の処理に使用されます。
- 割引コードは複数回使用できますか？
- 1 回の注文で複数の割引を利用できますか？
- 購入手続き時に割引コードを利用するにはどうすればよいですか？
- 購入手続き時に割引コードを適用するのを忘れた場合はどうすればよいですか？
基本設定
この事前構築済みコンポーネントを設定するには:
- 事前構築済みコンポーネントをインポートします。
- 外部サービスを記述する構成を使用して、付属の柔軟な Webhook を構成します。Webhook の設定をご覧ください。
Webhook の設定
このコンポーネントを使用するには、付属の柔軟な Webhook を構成して外部サービスから必要な情報を取得する必要があります。
オファーの詳細を取得する
prebuilt_components_offers_and_deals:get_offers_details Webhook は、ユーザー固有のオファーと一般的なオファーの詳細を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | オファーの詳細を取得する電話番号。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| active_category | ユーザーが利用できるオファー カテゴリのリスト。有効な値は prebuilt_components_offers_and_deals_category エンティティによって定義されます。 |
リスト（文字列） |
| user_email | 指定されたアカウントに登録されているメールアドレス。オファーの詳細の送信に使用します。 | 文字列 |
| user_offer | ユーザー固有のオファーの詳細のリスト。リストの各要素は 1 つのオファーを表し、Key-Value ペアはオファーの異なる属性を表します（例: {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}）。 |
リスト（オブジェクト） |
| all_offers | 一般的なオファーの詳細のリスト。リストの各要素は、user_offer フィールドと同じ形式に従って、1 つのオファーを表します。 |
リスト（オブジェクト） |
このコンポーネントの [オファーの詳細を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_offers_and_deals:get_offers_details Webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
クーポンコードの詳細を取得する
prebuilt_components_offers_and_deals:get_coupon_code_details Webhook は、ユーザーが問題を報告した特定のクーポンコードの詳細を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $flow.coupon_code | 詳細を取得するクーポンコード。 | 文字列 |
| $session.params.phone_number | ユーザーのアカウントに関連付けられている電話番号。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| offer_id | クーポンコードのオファー ID。 | 文字列 |
| offer_category_name | クーポンコードのカテゴリ。有効な値は prebuilt_components_offers_and_deals_category エンティティによって定義されます。 |
文字列 |
| coupon_code_status | クーポンコードのステータス。有効な値は、$flow.valid_coupon_code_status、$flow.invalid_coupon_code_status、$flow.valid_coupon_code_status の入力パラメータで定義されます。 |
文字列 |
| valid_until | クーポンコードの有効期限の日付（YYYY-MM-DD 形式）。 |
文字列 |
| minimum_order_value | クーポンコードの最小注文値。 | 文字列 |
このコンポーネントの [クーポンコードの詳細を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_offers_and_deals:get_coupon_code_details Webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
メッセージを送信
prebuilt_components_offers_and_deals:send_message Webhook は、オファーの詳細を含むメッセージをユーザーが選択したチャネルに送信するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.confirmation_channel | オファーの詳細を受け取るためにユーザーが選択したチャネル。有効な値は prebuilt_components_channel_email_phone エンティティによって定義されます。 |
文字列 |
このコンポーネントの [メッセージを送信] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_offers_and_deals:send_message Webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
チケットを発行する
prebuilt_components_offers_and_deals:raise_ticket Webhook は、クーポンコードに関するユーザーの問題を報告するチケットを送信するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.coupon_code | ユーザーが問題を報告したクーポンコード。 | 文字列 |
| $flow.offer_id | 指定されたクーポンコードのオファー ID。 | 文字列 |
| $flow.coupon_code_issue | クーポンコードに関してユーザーから報告された問題。 | 文字列 |
このコンポーネントの [チケットを発行] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- rebuilt_components_offers_and_deals:raise_ticket Webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。