返品と払い戻しの事前構築済みコンポーネントは、ユーザーの認証レベルを確認します。ユーザーが認証されると、コンポーネントはユーザーの最新の注文や過去の注文に関する情報を提供します。ユーザーは、注文内の複数の商品を返品することを選択し、払い戻し方法や返品方法などのオプションを選択できます。このコンポーネントは、Retail 認証の事前構築済みコンポーネントを使用してユーザーを認証します。このコンポーネントでは、通話後の要約とよくある質問に生成ツールも使用します。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニーを使用して呼び出されたときの動作を示しています。呼び出しにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
1 つの商品の店舗返品
エンドユーザーは認証済みです。エージェントは、最新の注文から返品する商品を確認し、返品の理由を収集します。 ユーザーが店舗での返品を選択すると、エージェントは最寄りの店舗のリストを表示します。ユーザーが店舗を選択すると、エージェントはユーザーの登録済みチャネルに送信される配送ラベルを生成します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 2023 年 11 月 10 日に注文された 2 個のランプを含む、末尾が 12345 の最新の注文番号についてお問い合わせですか？ | |
| はい | |
| 確認ですが、Google ランプの返却をご希望ですね。よろしいですか？ | |
| はい | |
| 選択した商品の利用可能な数量は 2 と表示されています。返品を希望される商品の数量をご指定ください。 | |
| 2 | |
| 返品の理由を指定してください。たとえば、商品に欠陥がある、動作しない、不要になった、サイズや適合の問題、間違った商品が届いた、商品が届いたのが遅すぎる、誤って購入したなどと言うか、あるいはその他とお伝えください。 | |
| その他 | |
| 返品理由を入力してください。 | |
| 品質が低い | |
| 確認ですが、返品の理由は品質が低いということですね。よろしいですか？ | |
| はい | |
| 払い戻し先をお知らせください。たとえば、ストア クレジットや支払い元のアカウントなどを指定できます。 | |
| 支払い元のアカウント | |
| 元のお支払い方法への払い戻しをご希望とのことで、確認いただきありがとうございます。 最後に、商品を返品する方法をお知らせください。店舗で返却、特定の場所に持ち込み、集荷をスケジュールするなどを指定できます。 |
|
| 店舗での返品 | |
| お近くの店舗を探しましょう。 | |
| エージェントは、郵便番号の収集の事前構築済みコンポーネントを使用して郵便番号を収集する | |
| 入力した郵便番号の近くにある場所のリストは次のとおりです。 住所 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US。 住所 2: Google California, 19510 Jamboree Road , Irvine, California 92612, US。 選択する住所番号を言う、または入力してください。あるいは、他の住所を表示するには「次」とお伝えください。 |
|
| 1 | |
| 確認ですが、Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US を選択しました。間違いありませんか？ | |
| はい | |
| 完璧です。配送ラベルとチケット番号を、登録されている電話番号とメールアドレスに送信しました。印刷して荷物に添付して、30 日以内に返品してください。 商品が倉庫に到着してから、口座に払い戻しが表示されるまでに 3 ～ 5 営業日かかります。払い戻し額には、送料と手数料は含まれません。 お電話ありがとうございます。 |
命名規則
この事前構築済みコンポーネントでは、次の命名規則が使用されています。
| 機能 | 形式 | 例 |
|---|---|---|
| フロー | [コンポーネント名] | 返品と払い戻し |
| エンティティ タイプ | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_return_refund_mode_of_return |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_return_refund:post_return_details |
入力パラメータ
入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。
この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | （省略可）ユーザーの識別に使用される、国コードなしのユーザーの電話番号。 | 文字列 |
| $session.params.all_recent_order_id | （省略可）このパラメータは、認証済みユーザーに関連付けられている注文 ID を、注文の日付の降順で並べ替えてリストします。配列の最初の要素は最新の注文を表します。ユーザーの注文がない場合、このパラメータの値は null です。 |
リスト（文字列） |
| $session.params.email | （省略可）アカウントに登録されているメールアドレス。 | 文字列 |
| $session.params.user_first_name | （省略可）ユーザーの名。挨拶とアカウントの所有権の確認に使用します。 | 文字列 |
この事前構築済みコンポーネントでは、次のオプションのパラメータを使用して、再試行を含むコンポーネントの動作を構成できます。
| パラメータ名 | 説明 | 形式 |
|---|---|---|
| $flow.max_retry_another_account_counter | 別のアカウントで続行するかどうかを選択する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_order_number | 注文番号の末尾 5 桁を入力するときに許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_retry_another_order | 注文 ID が見つからない場合や注文が返品の対象外である場合に、返品する別の注文を選択するときに許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_select_order_number | 複数の注文が同じ最後の 5 桁を共有している場合に、完全な注文番号を入力するときに許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_product_display_counter | 1 回のターンで表示する商品の最大数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_product_display | 会話全体で提示する商品の最大数を指定します。デフォルト値は 9 です。 |
integer |
| $flow.max_retry_product_number_counter | 返品する商品を選択するときに許可される再試行の最大回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_product_return_confirm_counter | 選択した商品の確認時に許可される再試行の最大回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_return_reason_counter | 返品理由の確認時に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.order_product_return_reason_others | ユーザーが返品理由として「その他」を選択したことを示す prebuilt_components_return_refund_reason エンティティの値を指定します。デフォルト値は "others" です。 |
文字列 |
| $flow.max_retry_select_quantity | 返品する商品の数量を選択するときに許可される再試行の最大回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_store_display_counter | 1 回のターンで表示する店舗の最大数を指定します。デフォルト値は 1 です。 |
integer |
| $flow.max_store_display | 会話全体で表示する店舗の最大数を指定します。デフォルト値は 10 です。 |
integer |
| $flow.max_retry_store_number_counter | 店舗を選択するときに許可される再試行の最大回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_store_selection | 店舗の選択の確認時に許可する再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_another_zip_code | 郵便番号を指定するときに許可される、再試行の最大回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.order_payment_mode_COD | 代金引換（COD）のお支払い方法を示す get_order_details Webhook によって返される order_payment_mode フィールドの値を指定します。デフォルト値は "COD" です。 |
文字列 |
| $flow.order_payment_mode_store_credit | ストア クレジットのお支払い方法を示す get_order_details webhook によって返される order_payment_mode フィールドの値を指定します。デフォルト値は "store_credit" です。 |
文字列 |
| $flow.order_refund_mode_source_account | ユーザーが支払い元のアカウントへの払い戻しを選択したことを示す prebuilt_components_return_refund_mode_of_refund エンティティの値を指定します。デフォルト値は source_account です。 |
文字列 |
| $flow.order_return_location_scheduled_for_pickup | ユーザーが返品の集荷をスケジュールすることを選択したことを示す prebuilt_components_exchange_order_location エンティティの値を指定します。デフォルト値は scheduled_for_pickup です。 |
文字列 |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Build] タブを選択します。
- [Flows] セクションでインポートされたコンポーネントをクリックします。
- [Pages] セクションで [Start Page] をクリックします。
- スタートページで true ルートをクリックします。
- [Route] ウィンドウで、必要に応じて [Parameter Presets] 値を編集します。
- [Save] をクリックします。
出力パラメータ
出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| all_recent_order_id | このパラメータは、認証済みユーザーに関連付けられている注文 ID を、注文の日付の降順で並べ替えてリストします。配列の最初の要素は最新の注文を表します。ユーザーの注文がない場合、このパラメータの値は null です。 |
リスト（文字列） |
| メール | 口座に登録されているメールアドレス。 | 文字列 |
| user_first_name | ユーザーの名。挨拶とアカウントの所有権の確認に使用します。 | 文字列 |
| 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 の組み込みイベントをご覧ください。 |
文字列 |
生成ツール
このコンポーネントは、生成ツールを使用して会話の特定の部分を有効にします。
よくある質問
FAQ 生成ツールは、返品と交換に関するよくある質問の処理に使用します。たとえば、次のような質問です。
- 返品手続きに期限はありますか？
- ギフト アイテムを交換できますか？
- 商品の価格と払い戻し額が違います。なぜでしょう。
要約
Summarization 生成ツールは、コンポーネントによって処理される会話を記述する通話後の要約を生成します。
基本設定
この事前構築済みコンポーネントを設定するには:
- 事前構築済みコンポーネントをインポートします。
- 外部サービスを記述する構成を使用して、付属の柔軟な Webhook を構成します。Webhook の設定をご覧ください。
Webhook の設定
このコンポーネントを使用するには、付属の柔軟な Webhook を構成して外部サービスから必要な情報を取得する必要があります。
認証
認証に必要な外部サービスをまだ構成していない場合は、このコンポーネントのユーザーの認証を有効にするようにそれらを構成する必要があります。詳細な手順については、Retail 認証 Webhook の設定をご覧ください。
注文の詳細情報を取得する
prebuilt_components_return_refund:get_order_details Webhook は、指定された注文の詳細情報を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $flow.order_id | 詳細情報を取得する注文 ID。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| order_date | 注文が行われた日（YYYY-MM-DD 形式）。 |
文字列 |
| order_product_count | 1 つの注文に含まれる一意の商品の数。 | integer |
| order_payment_mode | 注文時に使用された支払いモードを示します。 | 文字列 |
| returnable_product_id | 注文に含まれる返品可能な商品の商品 ID のリスト。 | リスト（文字列） |
| returnable_product_name | 注文に含まれる返品可能な商品の商品名のリスト。 | リスト（文字列） |
| returnable_product_brand_name | 注文に含まれる返品可能な商品のブランド名のリスト。 | リスト（文字列） |
| returnable_product_quantity | 注文に含まれる返品可能な商品の数量のリスト。 | リスト（文字列） |
このコンポーネントの [注文の詳細情報を取得する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_return_refund:get_order_details webhook. を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
重複した注文の詳細情報を取得する
prebuilt_components_retail_services:get_duplicate_order_details Webhook は、複数の注文番号の末尾 5 桁が同じ場合に注文を区別できるよう、詳細情報を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $flow.duplicate_order_id | ユーザーの 1 つ以上の注文で共有されている注文番号の末尾 5 桁を含むリスト。 | リスト（文字列） |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| all_order_date | 指定された末尾 5 桁を持つ重複した注文の注文日のリスト（YYYY-MM-DD 形式）。この配列内の各要素は、all_order_time 配列内の同じ要素に対応しています。 |
リスト（文字列） |
| all_order_time | 指定された末尾 5 桁を持つ重複した注文の注文時刻のリスト（HH:MM 形式）。この配列内の各要素は、all_order_date 配列内の同じ要素に対応しています。 |
リスト（文字列） |
このコンポーネントの [重複した注文の詳細情報を取得する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_retail_services:get_duplicate_order_details Webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
店舗の詳細を取得する
prebuilt_components_return_refund:get_store_details Webhook は、ユーザーが指定した郵便番号の近くにある店舗のリストを取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $flow.zip_code | 近くの店舗を検索するための郵便番号。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| store_id | 店舗 ID のリスト。 | リスト（文字列） |
| store_address | store_id の各要素に対応する店舗の住所のリスト。 |
リスト（文字列） |
このコンポーネントの [店舗の詳細を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_return_refund:get_store_details webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
返品の詳細を送信する
prebuilt_components_return_refund:post_return_details Webhook は、コンポーネントが返品を送信するために使用します。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.order_id | チケットを送信する注文 ID。 | 文字列 |
| $flow.return_product_id_list | ユーザーが返品を希望する商品 ID のリスト。 | リスト（文字列） |
| $flow.return_product_quantity_list | $flow.return_product_id_list の各要素に対応する、ユーザーが返品を希望する商品数量のリスト。 |
リスト（文字列） |
| $flow.return_reason_list | $flow.return_product_id_list の各要素に対応する、返品された各商品の返品理由のリスト。 |
リスト（文字列） |
| $flow.order_return_location | 返品に対して選択したモード。有効な値は prebuilt_components_exchange_order_location エンティティによって定義されます。 |
文字列 |
| $flow.order_return_store_id | 店舗での返品に対してユーザーが選択した店舗の店舗 ID。 | 文字列 |
| $flow.order_refund_mode | 払い戻しの支払いモード。有効な値は prebuilt_components_return_refund_mode_of_return エンティティによって定義されます。 払い戻しが不要な場合は、この値は null です。 |
文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| order_return_ticket_id | 送信された返品情報のチケット ID。 | 文字列 |
このコンポーネントの [返品後の詳細] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_return_refund:post_return_details webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
COD 払い戻し情報を送信する
prebuilt_components_return_refund:send_COD_refund_information Webhook は、返品関連の支払い情報をユーザーに送信するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.order_id | チケットを送信する注文 ID。 | 文字列 |
| $flow.channel | 情報の送信先である特定のチャネル。有効な値は prebuilt_components_channel_email_phone エンティティによって定義されます。 デフォルトでは、phone と email がサポートされています。 |
文字列 |
このコンポーネントの [COD 払い戻し情報を送信] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_return_refund:send_COD_refund_information webhook を選択します。
- 会話エージェント（Dialogflow CX）Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。