クレジット カード登録の事前構築済みコンポーネントを使用すると、新規および既存のお客様が新しいクレジット カードを申請できます。
コンポーネントは、エンドユーザーの電話番号の収集を開始して、新規顧客か既存の顧客かを識別します。新規ユーザーの場合、コンポーネントは、月収や費用のカテゴリ、ユーザーがリクエストしたカードの特典など、必要な詳細情報を収集します。必要な情報がすべて収集されると、コンポーネントはコールバックを手配し、ユーザーにリクエスト番号を提供します。
既存の顧客の場合、コンポーネントは登録済みのユーザー情報を取得し、ユーザーの希望と、信用スコアを含む取得した情報に基づいて、利用可能なカード オプションをエンドユーザーに提示します。お客様がカード オプションを選択すると、コンポーネントは、WhatsApp や SMS などの登録済みチャネルを介して、登録手続きを完了するためのリンクを送信します。
このコンポーネントでは、電話番号の収集と郵便番号の収集の事前構築済みコンポーネントを使用して、ユーザーの詳細を収集して検証します。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニー経由で呼び出されたときの動作を示しています。これにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
新規ユーザー
コンポーネントは、ユーザーが登録済みの電話番号を使用して電話をかけているかどうかを確認し、新規ユーザーであることを確認します。このコンポーネントは、ユーザーが登録を希望するカードのカテゴリを収集し、郵便番号や電話番号など、ユーザーを特定するための情報を収集します。次に、コンポーネントはコールバックを手配して、ユーザーにリクエスト番号を付与します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 銀行の既存の顧客かどうかをご確認ください。 | |
| 違います | |
| クレジット カードのお申し込みいただきありがとうございます。お客様に適したさまざまなクレジット カードをご用意しています。 最適なカードをご提供するために、月収を米ドルでお知らせください。 |
|
| 5,000 ドルです | |
| どの費用または特典に関心がありますか？旅行、燃料、ショッピングなど、幅広いオプションをご用意しています。 | |
| ショッピングです | |
| 選択したレスポンスはショッピング カテゴリに分類されます。続行する場合は「はい」と言ってください。 | |
| はい | |
| エージェントは、郵便番号の収集の事前構築済みコンポーネントを使用して、ユーザーの郵便番号を収集します。 | |
| 郵便番号は 10011 で間違いありませんか？ | |
| はい、そうです | |
| ありがとうございます。郵便番号の収集が完了しました。 | |
| エージェントは、電話番号の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します | |
| OK。番号は 1 6502530000 で間違いないでしょうか？ | |
| はい | |
| 電話番号の収集が完了しました。 お客様の条件に基づいて、Google の担当者から関連するカードに関してご連絡させていただきます。リクエスト番号は 993835 です。 |
既存のお客様
コンポーネントは、電話番号を使用して登録済みのお客様を識別します。続いて、登録するカードのカテゴリや種類などの情報をリクエストします。この情報が確認されると、コンポーネントは、登録プロセスを完了するチャネルを選択するようお客様に依頼し、顧客の登録済みチャネルへのリンクを送信します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 引き続きプロダクトとサービスをお選びいただけます。お客様に適したさまざまなクレジット カードをご用意しています。 ご興味をお持ちの費用や特典を教えてください。旅行、燃料、ショッピングなど、幅広いオプションをご用意しています。 |
|
| 次の休暇に利用できるカードが欲しいと考えています | |
| 選択したレスポンスは旅行カテゴリに分類されます。続行する場合は「はい」と言ってください。 | |
| はい | |
| リクエストの種類に適した、プラチナ トラベルカード、ゴールド トラベルカード、クラシック トラベルカードという 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 | （省略可）エンドユーザーの電話番号。このパラメータを指定しない場合、コンポーネントはエンドユーザーから電話番号を収集します。 | string |
| $flow.max_retry_count | エンドユーザーに許可する再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.currency_name | 毎月の収入の詳細を収集する際に想定される通貨を指定します。デフォルト値は "USD" です。 |
string |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [ビルド] タブを選択します。
- [フロー] セクションでインポートされたコンポーネントをクリックします。
- [ページ] セクションで [スタートページ] をクリックします。
- スタートページで [true ルート] をクリックします。
- [ルート] ウィンドウで、必要に応じて [パラメータのプリセット] 値を編集します。
- [Save] をクリックします。
出力パラメータ
出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 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 |
基本設定
この事前構築済みコンポーネントを設定するには:
- 事前構築済みコンポーネントをインポートします。
- Dialogflow 外部サービスを記述する構成を使用して、付属の フレキシブル Webhook を構成します。以下の Webhook の設定をご覧ください。
Webhook の設定
このコンポーネントを使用するには、付属の Flexible Webhook を構成して外部サービスから必要な情報を取得する必要があります。
アカウントの詳細を取得
prebuilt_components_credit_card_enrollment:get_account_details Webhook は、アカウントが存在する場合、ユーザーのアカウントの詳細を取得するためにコンポーネントで使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | string |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| account_count | 登録されている電話番号に関連付けられているアカウントの数。 | integer |
| credit_score | ユーザーの登録された信用スコア。 | integer |
このコンポーネントの [アカウントの詳細を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_account_details Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [保存] をクリックします。
カード数を取得
prebuilt_components_credit_card_enrollment:get_card_count Webhook は、登録済みのユーザーのクレジット カードの数を取得するためにコンポーネントによって使用します。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | string |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| card_count | 登録済みユーザーのアカウントにまたがるクレジット カードの合計数。 | integer |
このコンポーネントの [カード数を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_card_count Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [保存] をクリックします。
利用可能なカードを取得
prebuilt_components_credit_card_enrollment:get_available_card Webhook は、ユーザーの信用スコアに基づいて特定のカテゴリで利用可能なカードのリストを取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $flow.expense_category | ユーザーが登録するよう選択した費用のカテゴリ。有効な値は、prebuilt_components_cc_enroll_expense_category カスタム エンティティによって定義されます。デフォルトでは、fuel、shopping、travel がサポートされています。 |
string |
| $flow.credit_score | [アカウントの詳細を取得] Webhook を使用してコンポーネントによって取得されたユーザーの信用スコア。 | integer |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| available_card_names | ユーザーが使用できるカードのリスト（["gold shopping card","classic shopping card"] など）。 |
リスト（文字列） |
| cards_count | ユーザーが使用できるカードの数。 | integer |
このコンポーネントの [利用可能なカードを取得] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_available_card Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [保存] をクリックします。
選択したカード情報を取得
prebuilt_components_credit_card_enrollment:get_selected_card Webhook は、選択したカードの年間手数料と特典を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $flow.card_type | ユーザーが登録するよう選択したカードの種類。有効な値は、prebuilt_components_cc_enroll_card_type カスタム エンティティによって定義されます。デフォルトでは、classic、gold、platinum がサポートされています。 |
string |
| $flow.expense_category | ユーザーが登録するよう選択した費用のカテゴリ。有効な値は、prebuilt_components_cc_enroll_expense_category カスタム エンティティによって定義されます。デフォルトでは、fuel、shopping、travel がサポートされています。 |
string |
| $flow.credit_score | [アカウントの詳細を取得] Webhook を使用してコンポーネントによって取得されたユーザーの信用スコア。 | integer |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| selected_card_benefits | 選択したカードの特典に関する情報。 | string |
| selected_card_annual_fee | 選択したカードの年間手数料。 | integer |
| selected_card_name | 選択したカードの名前。 | string |
このコンポーネントの [選択したカード情報を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_selected_card Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [保存] をクリックします。
登録リクエストを送信
prebuilt_components_credit_card_enrollment:submit_enroll Webhook は、新しいユーザーの設定とユーザー詳細に基づいてカード登録リクエストを作成するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | string |
| $flow.zipcode | ユーザーが指定した郵便番号。 | string |
| $flow.monthly_salary | ユーザーが指定した月額給与。 | integer |
| $flow.currency_name | コンポーネントの入力パラメータで構成された月額給与の通貨。入力パラメータをご覧ください。 | string |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| request_number | カード登録リクエストを正常に登録するためのリクエスト番号。 | integer |
このコンポーネントの [登録リクエストを送信] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:submit_enroll Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [保存] をクリックします。
メッセージを送信
prebuilt_components_credit_card_enrollment:send_message Webhook は、既存のお客様のクレジット カード登録を完了するためのリンクを含むメッセージを送信するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメーター名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | string |
| $flow.channel | メッセージを受信するためにユーザーが選択したチャネル。有効な値は、prebuilt_components_cc_enroll_channel カスタム エンティティによって定義されます。デフォルトでは、SMS と WhatsApp がサポートされています。 |
string |
| $flow.selected_card_name | ユーザーが選択したカードのリスト（["gold shopping card","classic shopping card"] など）。 |
リスト（文字列） |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメーター名 | 説明 | 出力形式 |
|---|---|---|
| message_sent | ユーザーが指定したチャネルにメッセージが正常に送信されたかどうかを示します。 | ブール値 |
このコンポーネントの [メッセージを送信] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:send_message Webhook を選択します。
- Dialogflow Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、[リクエスト本文] を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [認証] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。