交換注文の事前構築済みコンポーネント

交換注文の事前構築済みコンポーネントは、ユーザーの認証レベルを確認します。ユーザーが認証されると、コンポーネントは、ユーザーの直近または過去の注文に関する情報を提供します。ユーザーは、注文で複数の商品を交換することを選択し、払い戻しや配送方法などのオプションを選択できます。このコンポーネントは、Retail 認証の事前構築済みコンポーネントを使用してユーザーを認証します。このコンポーネントでは、通話後の要約とよくある質問に生成ツールも使用します。

制限事項

一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。

• このコンポーネントはデータを暗号化しません。

サンプル ダイアログ

次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニーを使用して呼び出されたときの動作を示しています。呼び出しにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。

欠陥のある商品の店舗交換

エンドユーザーはすでに認証されています。エージェントは、最新の注文から交換する必要がある商品を確認し、交換の理由を収集します。 ユーザーが店舗で商品を交換することを選択すると、エージェントは最寄りの店舗のリストを提供します。ユーザーが店舗を選択すると、エージェントはユーザーの登録済みチャネルに送信される配送ラベルを生成します。

ユーザーの回答	エージェントの応答
	2023 年 11 月 10 日に注文された 2 つの ランプ、2 つの Google Pixel、および他の 10 個の製品を含む、末尾が 12375 の直近の注文番号についてお問い合わせですか？
○
	ご注文内で対象となる商品が見つかりました。交換したい商品をお知らせください。商品 1: Google ランプ、商品 2: Google Pixel、商品 3: Google LED ライト 選択するアイテムの商品番号を言うか、入力してください。他の商品を表示するには次とお伝えください。
1
	確認ですが、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。 選択する住所番号を言う、または入力してください。あるいは、他の住所を表示するには「次」とお伝えください。
最初の店舗
	確認ですが、Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US を選択しました。間違いありませんか？
○
	ありがとうございます。ご登録の電話番号とメールアドレスに配送ラベルとチケット番号を送信しました。印刷して荷物に添付して、30 日以内に交換商品をお持ち込みください。商品が倉庫に到着してから、交換品がある場合は、アカウントに表示されるまでに 3 ～ 5 営業日かかります。払い戻し額には、送料と手数料は含まれません。 交換商品の方が高額です。価格の差は 20 ドルです。ご登録の携帯電話番号にお支払いのリンクが間もなく届きます。交換を行うには、24 時間以内にお支払いを行っていただくようお願いいたします。 別の注文を交換しますか？
いいえ、以上です
	お電話ありがとうございます。

価格の差額の払い戻し

エンドユーザーはすでに認証されています。エージェントは、注文番号と交換対象の商品を収集し、交換の理由を収集します。ユーザーは異なるサイズの商品を交換し、集荷をスケジュール設定します。エージェントは交換された商品が新しい商品よりも価格が低いことを確認し、払い戻しのためのお支払い方法をユーザーに確認します。

ユーザーの回答	エージェントの応答
	2023 年 11 月 10 日に注文された 2 個のランプを含む、末尾が 12345 の最新の注文番号についてお問い合わせですか？
×
	別の注文を交換しますか？
○
	ご希望の交換品の注文 ID の末尾 5 桁をお知らせください。
12346
	お伺いした注文 ID の末尾 5 桁は 12345 です。よろしいですか？
○
	注文 ID の収集が完了しました。 注文内に対象の商品が見つかりました。交換したい商品をお知らせください。商品 1: Google 水ボトル、商品 2: Google T シャツ。 選択するアイテムの商品番号を言うか、入力してください。あるいは、他の商品を表示するために次とお伝えください。
2
	確認ですが、Google T シャツの交換をご希望ですね。よろしいですか？
○
	交換の理由を指定してください。たとえば、アイテムに欠陥がある、動作しない、サイズや適合の問題、不完全な注文の問題、スタイルの問題、色が間違っているなどと言うか、あるいはその他とお伝えください。
サイズまたは適合の問題
	交換の理由をお知らせいただき、ありがとうございます。交換をご希望のサイズを教えていただけますか？以下のサイズが用意されています。 S サイズの場合は 1 と言ってください。 M サイズの場合は 2 と言ってください。 L サイズの場合は 3 と言ってください。 XL の場合は 4 と言ってください。 ダブル XL サイズの場合は 5 と言ってください。
1
	最後に、商品の交換方法をお知らせください。店舗で交換や集荷をスケジュールなどを指定できます。
集荷をスケジュール
	ありがとうございます。登録電話番号とメールアドレスに配送ラベルを送付しました。印刷して荷物に添付してください。24 ～ 48 時間以内に担当チームより、集荷のスケジュール設定についてご連絡いたします。商品が倉庫に到着してから、交換による払い戻しがアカウントに表示されるまでに 3 ～ 5 営業日かかります。 交換される商品は価格が低く、5 ドル払い戻しされます。 ご希望の払い戻し先をお知らせください。たとえば、ストア クレジットや支払い元のアカウントなどを指定できます。
ストア クレジット
	ウォレットへの払い戻しをご希望とのことで、確認いただきありがとうございます。 別のご注文を交換しますか？
無料
	お電話ありがとうございます。

対象外の注文

エンドユーザーはすでに認証されています。エージェントは最新の注文を確認し、交換対象の商品がないことを確認します。エージェントはユーザーから注文番号を収集し、指定された注文に対象となる商品がないことを確認します。

ユーザーの回答	エージェントの応答
	直近のご注文に、交換の対象となる商品が見つかりませんでした。 別の注文を交換しますか？
○
	ご希望の交換品の注文 ID の末尾 5 桁をお知らせください。
23487
	お伺いした注文 ID の末尾 5 桁は 23487 です。よろしいですか？
○
	ありがとうございます。注文 ID の収集が完了しました。
	大変申し訳ありませんが、当社のポリシーに基づいて、注文内に交換対象となる商品がありません。交換に関するポリシーについて詳しくは、ウェブサイトをご覧ください。 別の注文を交換しますか？
無料
	お電話ありがとうございます。

命名規則

この事前構築済みコンポーネントでは、次の命名規則が使用されています。

特徴	形式	例
フロー	[コンポーネント名]	注文のステータス
エンティティ タイプ	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

入力パラメータ

入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。

この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。

パラメータ名	説明	入力形式
$session.params.phone_number	（省略可）ユーザーの識別に使用される、国コードなしのユーザーの電話番号。	string
$session.params.all_recent_order_id	（省略可）このパラメータは、認証済みユーザーに関連付けられている注文 ID を、注文の日付の降順で並べ替えてリストします。配列の最初の要素は最新の注文を表します。ユーザーの注文がない場合、このパラメータの値は null です。	リスト（文字列）
$session.params.email	（省略可）アカウントに登録されているメールアドレス。	string
$session.params.user_first_name	（省略可）ユーザーの名。挨拶とアカウントの所有権の確認に使用します。	string

この事前構築済みコンポーネントでは、次のオプションのパラメータを使用して、再試行を含むコンポーネントの動作を構成できます。

パラメータ名	説明	形式
$flow.max_retry_another_account	代替アカウントで続行するかどうかを選択するときに許可される再試行回数を指定します。デフォルト値は 3 です。	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_retry_exchange_reason	交換の理由を提示するときに許可される再試行回数を指定します。デフォルト値は 3 です。	integer
$flow.max_retry_exchange_reason_counter	交換の理由を確認するときに許可される再試行回数を指定します。デフォルト値は 2 です。	integer
$flow.order_product_exchange_reason_others	ユーザーが「その他」の交換理由を選択したことを示す prebuilt_components_exchange_order_reason エンティティの値を指定します。デフォルト値は "others" です。	string
$flow.max_product_display_counter	1 ターンで表示する商品の最大数を指定します。デフォルト値は 2 です。	integer
$flow.max_product_display	会話全体で表示する商品の最大数を指定します。デフォルト値は 9 です。	integer
$flow.max_product_exchange_confirm	選択した商品の確認時に許可される再試行の最大回数を指定します。デフォルト値は 2 です。	integer
$flow.max_retry_product_number_counter	交換する商品を選択するときに許可される再試行の最大回数を指定します。デフォルト値は 3 です。	integer
$flow.max_retry_select_quantity	交換する商品の数量を選択するときに許可される再試行の最大回数を指定します。デフォルト値は 2 です。	integer
$flow.max_retry_size_number_counter	交換するサイズを選択するときに許可される再試行の最大回数を指定します。デフォルト値は 2 です。	integer
$flow.max_retry_another_zip_code	郵便番号を指定するときに許可される、再試行の最大回数を指定します。デフォルト値は 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	店舗の選択の確認時に許可する再試行回数を指定します。デフォルト値は 3 です。	integer
$flow.max_available_address_reselection_counter	ユーザーが別の店舗の住所を選択するかどうかを確認するときに許可される再試行回数を指定します。デフォルト値は 2 です。	integer
$flow.order_payment_mode_COD	代金引換（COD）のお支払い方法を示す get_order_details Webhook によって返される order_payment_mode フィールドの値を指定します。デフォルト値は "COD" です。	string
$flow.order_payment_mode_store_credit	ストア クレジットのお支払い方法を示す get_order_details Webhook から返される order_payment_mode フィールドの値を指定します。デフォルト値は "store_credit" です。	string
$flow.order_refund_mode_source_account	ユーザーが支払い元のアカウントへの払い戻しを選択したことを示す prebuilt_components_exchange_order_refund_mode エンティティの値を指定します。デフォルト値は source_account です。	string
$flow.order_exchange_location_scheduled_for_pickup	ユーザーが交換の集荷をスケジュールすることを選択したことを示す prebuilt_components_exchange_order_location エンティティの値を指定します。デフォルト値は scheduled_for_pickup です。	string

出力パラメータ

出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。

パラメータ名	説明	出力形式
phone_number	ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。	string
all_recent_order_id	このパラメータは、認証済みユーザーに関連付けられている注文 ID を、注文の日付の降順で並べ替えてリストします。配列の最初の要素は最新の注文を表します。ユーザーの注文がない場合、このパラメータの値は null です。	リスト（文字列）
email	アカウントに登録されているメールアドレス。	string
user_first_name	ユーザーの名。挨拶とアカウントの所有権の確認に使用します。	string
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 の組み込みイベントをご覧ください。	string

生成ツール

このコンポーネントでは、生成ツールを使用して会話の特定の部分を有効にします。

よくある質問

FAQ 生成ツールは、次のような返品と交換に関するよくある質問を処理するために使用されます。

• 返品手続きの期限はありますか？
• ギフト アイテムを交換できますか？
• 商品の価格と払い戻し額が違います。なぜでしょう。

要約

Summarization 生成ツールは、コンポーネントによって処理される会話を記述する通話後の要約を生成します。

基本設定

この事前構築済みコンポーネントを設定するには:

1. 事前構築済みコンポーネントをインポートします。
2. Dialogflow 外部サービスを記述する構成を使用して、付属の フレキシブル Webhook を構成します。Webhook の設定をご覧ください。

Webhook の設定

このコンポーネントを使用するには、付属の Flexible Webhook を構成して外部サービスから必要な情報を取得する必要があります。

Authentication

認証に必要な外部サービスをまだ構成していない場合は、このコンポーネントのユーザーの認証を有効にするようにそれらを構成する必要があります。詳細な手順については、Retail 認証 Webhook の設定をご覧ください。

注文の詳細を取得する

prebuilt_components_exchange_order:get_order_details Webhook は、指定された注文の注文の詳細を取得するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$flow.order_id	詳細を取得する注文 ID。	string

API レスポンス パラメータ

以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。

パラメータ名	説明	出力形式
order_date	注文が行われた日（YYYY-MM-DD 形式）。	string
order_product_count	1 つの注文に含まれる一意の商品の数。	integer
order_payment_mode	注文時に使用された支払いモードを示します。	string
exchangeable_product_id	注文内の交換可能な商品の商品 ID のリスト。	リスト（文字列）
exchangeable_product_name	注文に含まれる交換可能な商品の商品名のリスト。	リスト（文字列）
exchangeable_product_brand_name	注文内の交換可能な商品のブランド名のリスト。	リスト（文字列）
exchangeable_product_quantity	注文に含まれる交換可能な商品の数量のリスト。	リスト（文字列）
exchangeable_product_price	注文内の交換可能な商品の価格のリスト。	リスト（文字列）

重複した注文の詳細を取得する

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 配列内の同じ要素に対応します。	リスト（文字列）

利用可能な交換サイズを取得する

prebuilt_components_exchange_order:get_available_exchange_size Webhook は、サイズや適合性の問題によりユーザーが商品の交換を希望する場合に、利用可能な交換サイズを取得するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$flow.selected_order_product_id	ユーザーが交換を希望する商品の商品 ID。	string

API レスポンス パラメータ

以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。

パラメータ名	説明	出力形式
product_available_sizes	選択した商品で利用可能なサイズのリスト。	リスト（文字列）

商品交換の在庫状況を取得する

prebuilt_components_exchange_order:get_product_exchange_availability Webhook は、ユーザーが選択した商品、数量、オプションのサイズが交換用に利用可能かどうかを確認するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$flow.order_id	詳細を取得する注文 ID。	string
$flow.selected_order_product_id	ユーザーが交換を希望する商品の商品 ID。	string
$flow.order_product_quantity_exchange_count	ユーザーが交換を希望する商品の数量。	integer
$flow.product_selected_size	ユーザー交換を希望する商品のサイズ。	string

API レスポンス パラメータ

以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。

パラメータ名	説明	出力形式
product_exchange_availability	選択した商品、数量、サイズが交換用に利用可能かどうかを示します。	boolean
product_exchange_price	選択した商品とサイズの 1 つのアイテムの交換価格を示します。	数値

未完了の注文チケットを発行する

prebuilt_components_exchange_order:raise_incomplete_order_ticket Webhook は、未完了の理由でユーザーが注文内で商品を交換しようとしたときに、チケットを発行するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$session.params.phone_number	ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。	string
$flow.order_id	チケットを送信する注文 ID。	string
$flow.selected_order_product_id	ユーザーが交換を希望する商品の商品 ID。	string
$flow.order_product_quantity_exchange_count	ユーザーが交換を希望する商品の数量。	integer
$flow.order_product_exchange_reason	ユーザーが商品の交換を希望する理由。	string

店舗の詳細を取得する

prebuilt_components_exchange_order:get_store_details Webhook は、ユーザーが指定した郵便番号の近くにある店舗のリストを取得するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$flow.zip_code	付近の店舗を検索する郵便番号。	string

API レスポンス パラメータ

以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。

パラメータ名	説明	出力形式
store_id	店舗 ID のリスト。	リスト（文字列）
store_address	store_id の各要素に対応する店舗住所のリスト。	リスト（文字列）

交換後の詳細

prebuilt_components_exchange_order:post_exchange_details Webhook は、交換を送信するためにコンポーネントによって使用されます。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$session.params.phone_number	ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。	string
$flow.order_id	チケットを送信する注文 ID。	string
$flow.selected_order_product_id	ユーザーが交換を希望する商品の商品 ID。	string
$flow.order_product_quantity_exchange_count	ユーザーが交換を希望する商品の数量。	integer
$flow.product_selected_size	ユーザー交換を希望する商品のサイズ。	string
$flow.order_product_exchange_reason	ユーザーが商品の交換を希望する理由。	string
$flow.order_exchange_location	交換に対して選択したモード。有効な値は、prebuilt_components_exchange_order_location エンティティによって定義されます。	string
$flow.order_exchange_store_id	店舗交換に対してユーザーが選択した店舗の店舗 ID。	string
$flow.order_refund_mode	払い戻しの支払い方法（該当する場合）。有効な値は、prebuilt_components_exchange_order_refund_mode エンティティによって定義されます。払い戻しが不要な場合、この値は null です。	string
$flow.total_refund_amount	交換可能な商品価格が新しい商品よりも高い場合に払い戻される金額。払い戻しが不要な場合、この値は null です。	integer

API レスポンス パラメータ

以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。

パラメータ名	説明	出力形式
order_exchange_ticket_id	送信された交換のチケット ID。	string

COD の払い戻し情報を送信する

prebuilt_components_exchange_order:send_COD_refund_information Webhook は、交換関連の支払い情報をユーザーに送信するためにコンポーネントによって使用します。

API リクエスト パラメータ

以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。

パラメータ名	説明	入力形式
$session.params.phone_number	ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。	string
$flow.order_id	チケットを送信する注文 ID。	string
$flow.channel	情報の送信先となる特定のチャネル。有効な値は、prebuilt_components_channel_email_phone エンティティによって定義されます。デフォルトでは、phone と email がサポートされています。	string

完了

これで、エージェントとその Webhook が設定され、テストの準備が整いました。