クレジット カード登録の事前構築済みコンポーネント

クレジット カード登録の事前構築済みコンポーネントを使用すると、新規および既存の顧客が新しいクレジット カードを申請できます。

コンポーネントは、ユーザーの電話番号の収集を開始して、新規顧客か既存の顧客かを識別します。新規ユーザーの場合、コンポーネントは、月収や費用のカテゴリ、ユーザーが希望するクレジット カードの特典など、必要な詳細情報を収集します。必要な情報がすべて収集されると、コンポーネントはコールバックを手配し、ユーザーにリクエスト番号を提供します。

既存の顧客の場合、コンポーネントはアカウント作成済みユーザー情報を取得し、ユーザーの希望と、信用スコアを含む取得した情報に基づいて、利用可能なクレジットカード オプションをユーザーに提示します。お客様がクレジット カード オプションを選択すると、コンポーネントは、WhatsApp や SMS などの登録済みチャネルを使用して登録手続きを完了するためのリンクを送信します。

このコンポーネントでは、電話番号の収集と郵便番号の収集のコンポーネントを使用して、ユーザーの詳細を収集して検証します。

制限事項

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

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

サンプル ダイアログ

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

新しいユーザー

  1. コンポーネントは、ユーザーが登録済みの電話番号を使用して電話をかけているかどうかを確認し、新規ユーザーかどうかを識別します。
  2. このコンポーネントは、ユーザーが登録を希望するクレジット カードのカテゴリを収集し、郵便番号や電話番号など、ユーザーを特定するための情報を収集します。
  3. コンポーネントはコールバックを手配し、リクエスト番号を提供します。
ユーザー入力 エージェントの応答
銀行の既存の顧客かどうかをご確認ください。
違います
クレジット カードのお申し込みいただきありがとうございます。お客様に適したさまざまなクレジット カードをご用意しています。

最適なクレジット カードをご提供するために、月収を米ドルでお知らせください。
5,000 ドルです
どの費用や特典に興味がありますか?旅行、燃料、ショッピングなど、さまざまなオプションをご用意しています。
ショッピングです
選択した回答はショッピング カテゴリに該当します。続行する場合は「はい」と言ってください。
はい
エージェントは、郵便番号の収集の事前構築済みコンポーネントを使用して、ユーザーの郵便番号を収集します。
郵便番号は 10011 で間違いありませんか?
はい、そうです
ありがとうございます。郵便番号の収集が完了しました。
エージェントは、電話番号の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します。
承知しました。番号は +16502530000 で間違いないでしょうか?
はい
電話番号の収集が完了しました。

お客様の条件に基づいて、Google の担当者から関連するカードに関してご連絡させていただきます。リクエスト番号は 993835 です。

既存の顧客

  1. このコンポーネントは、電話番号を使用して登録済みの顧客を識別し、登録するカードのカテゴリや種類などの情報をリクエストします。
  2. ユーザーがこの情報を確認すると、コンポーネントは、登録プロセスを完了するチャネルを選択するようユーザーにプロンプトを表示し、登録済みのチャネルにリンクを送信します。
ユーザー入力 エージェントの応答
引き続きプロダクトとサービスをお選びいただけます。お客様に適したさまざまなクレジット カードをご用意しています。

ご興味をお持ちの費用や特典を教えてください。旅行、燃料、ショッピングなど、さまざまなオプションをご用意しています。
次の休暇に利用できるカードが欲しいと考えています
選択した回答は旅行カテゴリに該当します。続行する場合は「はい」と言ってください。
はい
リクエストの種類に適した、プラチナ トラベルカード、ゴールド トラベルカード、クラシック トラベルカードという 3 種類のカードがあります。すべてのカードまたは特定のカードに関する情報が必要ですか?たとえば、クラシック カードをお求めの場合は、「クラシック カード」と言ってください。
プラチナカードについて教えてください。
はい。プラチナ トラベルカードの年会費は 95 ドルです。特典: 毎年 10,000 ボーナス マイルを獲得し、その他のすべての購入で無制限の 2 倍マイルを獲得します。マイルの獲得は簡単で、使うのも簡単です。特典やボーナスについて詳しくは、ウェブサイトをご覧ください。

プラチナ トラベルカードへの登録を希望されるかどうかご確認ください。
はい、希望します
登録手続きの手順へのリンクを共有します。SMS または WhatsApp を介してこれらのカード情報を携帯電話番号と共有しますか?
SMS でお願いします
わかりました。登録済みの携帯電話番号にリンクを送信します。この処理には数秒かかることがあります。「はい」か「いいえ」と言ってリンクを受け取ったことを確認していただけますか?
受け取りました
リンクを開いて、カードの登録の詳細を確認してください。データが完成すると、新しいカードの発行が開始され、お客様の現住所に送信されます。

情報の拒否

ユーザーがクレジット カードへの登録に必要な情報の提供を拒否すると、エラー メッセージが表示され、コンポーネントは終了します。

ユーザー入力 エージェントの応答
銀行の既存の顧客かどうかをご確認ください。
いえ、違います
クレジット カードのお申し込みいただきありがとうございます。お客様に適したさまざまなクレジット カードをご用意しています。

最適なクレジット カードをご提供するために、月収を米ドルでお知らせください。
その情報は伝えたくありません
お電話ありがとうございます。恐れ入りますが、現時点ではリクエストされた情報なしでは続行できません。

命名規則

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

機能 形式 例
フロー [コンポーネント名] クレジット カードの登録
コンポーネントに固有のインテント prebuilt_components_[component_name]_[intent_name] prebuilt_components_cc_enroll_collect_cardtype
エンティティ タイプ prebuilt_components_[component_name]_[entity_type] prebuilt_components_cc_enroll_expense_category
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_credit_card_enrollment:get_available_card

入力パラメータ

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

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

パラメータ名 説明 入力形式
$session.params.auth_level (省略可)ユーザーの現在の認証レベルを示します。 integer
$session.params.phone_number (省略可)ユーザーの電話番号。このパラメータを指定しない場合、このコンポーネントはユーザーから電話番号を収集します。 文字列
$flow.max_retry_count ユーザーに許可する再試行回数を指定します。デフォルト値は 3 です。 integer
$flow.currency_name 毎月の収入の詳細を収集する際に想定される通貨を指定します。デフォルト値は "USD" です。 文字列

このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Build] タブを選択します。
  5. [Flows] セクションでインポートされたコンポーネントをクリックします。
  6. [Pages] セクションで [Start Page] をクリックします。
  7. スタートページで true ルートをクリックします。
  8. [Route] ウィンドウで、必要に応じて [Parameter Presets] 値を編集します。
  9. [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 の組み込みイベントをご覧ください。
文字列

基本設定

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

  1. 事前構築済みコンポーネントをインポートします(事前構築済みコンポーネントをインポートするをご覧ください)。
  2. 付属の柔軟な Webhook を構成して、外部サービスを記述します。詳細については、Webhook の設定セクションをご覧ください。

Webhook の設定

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

アカウントの詳細を取得

コンポーネントは、アカウントが存在する場合、prebuilt_components_credit_card_enrollment:get_account_details Webhook を使用してユーザーのアカウントの詳細を取得します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$session.params.phone_number ユーザーの識別に使用されるユーザーの電話番号(国コードなし)。 文字列

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
account_count 登録されている電話番号に関連付けられているアカウントの数。 integer
credit_score ユーザーの登録された信用スコア。 integer

このコンポーネントの [アカウントの詳細を取得] Webhook を構成するには、開いて手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:get_account_details Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

カード数を取得

このコンポーネントは、prebuilt_components_credit_card_enrollment:get_card_count Webhook を使用して、登録済みのユーザー アカウントに関連付けられているクレジット カードの数を取得します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$session.params.phone_number ユーザーの識別に使用されるユーザーの電話番号(国コードなし)。 文字列

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
card_count 登録済みユーザーのアカウントにまたがるクレジット カードの合計数。 integer

このコンポーネントの [クレジット カード数を取得] Webhook を構成するには、開いて手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:get_card_count Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

利用可能なクレジット カードを取得する

このコンポーネントは、prebuilt_components_credit_card_enrollment:get_available_card Webhook を使用して、ユーザーの信用スコアに基づいて特定の費用カテゴリで利用可能なクレジット カードのリストを取得します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$flow.expense_category ユーザーが登録を選択した経費カテゴリ。有効な値は、prebuilt_components_cc_enroll_expense_category カスタム エンティティによって定義されます。デフォルトでは、fuel、shopping、travel がサポートされています。 文字列
$flow.credit_score [アカウントの詳細を取得] Webhook を使用してコンポーネントによって取得されたユーザーの信用スコア。 integer

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
available_card_names ユーザーが利用できるクレジット カードのリスト(例: ["gold shopping card","classic shopping card"])。 リスト(文字列)
cards_count ユーザーが利用できるクレジット カードの数。 integer

このコンポーネントの [利用可能なカードを取得] Webhook を構成するには、展開して手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:get_available_card Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

選択したクレジット カード情報を取得

このコンポーネントは、prebuilt_components_credit_card_enrollment:get_selected_card Webhook を使用して、選択したクレジット カードの年間手数料と特典を取得します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$flow.card_type ユーザーが登録を選択したクレジット カードの種類。有効な値は、prebuilt_components_cc_enroll_card_type カスタム エンティティによって定義されます。デフォルトでは、classic、gold、platinum がサポートされています。 文字列
$flow.expense_category ユーザーが登録を選択した経費カテゴリ。有効な値は、prebuilt_components_cc_enroll_expense_category カスタム エンティティによって定義されます。デフォルトでは、fuel、shopping、travel がサポートされています。 文字列
$flow.credit_score [アカウントの詳細を取得] Webhook を使用してコンポーネントによって取得されたユーザーの信用スコア。 integer

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
selected_card_benefits 選択したクレジット カードの特典に関する情報。 文字列
selected_card_annual_fee 選択したクレジット カードの年間手数料。 integer
selected_card_name 選択したクレジット カードの名前。 文字列

このコンポーネントの [選択したクレジット カード情報を取得] Webhook を構成するには、開いて手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:get_selected_card Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

登録リクエストを送信する

このコンポーネントは、prebuilt_components_credit_card_enrollment:submit_enroll Webhook を使用して、新規ユーザーの設定とユーザー詳細に基づいてクレジット カード登録リクエストを作成します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$session.params.phone_number ユーザーの識別に使用されるユーザーの電話番号(国コードなし)。 文字列
$flow.zipcode お客様から提供された郵便番号。 文字列
$flow.monthly_salary ユーザーが提供した月給。 integer
$flow.currency_name コンポーネントの入力パラメータで構成された月額給与の通貨。入力パラメータをご覧ください。 文字列

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
request_number クレジット カード登録リクエストの登録が成功した際のリクエスト番号。 integer

このコンポーネントの [登録リクエストを送信] Webhook を構成するには、開いて手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:submit_enroll Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

メッセージを送信

コンポーネントは、prebuilt_components_credit_card_enrollment:send_message Webhook を使用して、既存のお客様のクレジット カード登録を完了するためのリンクを含むメッセージを送信します。

API リクエスト パラメータ

このコンポーネントは、API リクエストへの入力として次のパラメータを提供します。

パラメータ名 説明 入力形式
$session.params.phone_number ユーザーの識別に使用されるユーザーの電話番号(国コードなし)。 文字列
$flow.channel メッセージを受信するためにユーザーが選択したチャネル。有効な値は、prebuilt_components_cc_enroll_channel カスタム エンティティによって定義されます。デフォルトでは、SMS と WhatsApp がサポートされています。 文字列
$flow.selected_card_name ユーザーが選択したクレジット カードのリスト(例: ["gold shopping card","classic shopping card"])。 リスト(文字列)

API レスポンス パラメータ

コンポーネントは、API レスポンスから次のパラメータを取得します。

パラメータ名 説明 出力形式
message_sent ユーザーが指定したチャネルにメッセージが正常に送信されたかどうかを示します。 ブール値

このコンポーネントの [メッセージを送信] Webhook を構成するには、展開して手順を確認してください。

  1. Dialogflow CX コンソールを開きます。
  2. ご自身の Google Cloud プロジェクトを選択します。
  3. エージェントを選択します。
  4. [Manage] タブを選択します。
  5. [Webhooks] をクリックします。
  6. prebuilt_components_credit_card_enrollment:send_message Webhook を選択します。
  7. Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
  8. Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
  9. レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
  10. 必要に応じて [Authentication] の設定を確認し、更新します。
  11. [Save] をクリックします。

完了

クレジット カード登録の事前構築済みコンポーネントとその Webhook が設定され、テストの準備が整いました。