クレジット カード登録の事前構築済みコンポーネントを使用すると、新規および既存のお客様が新しいクレジット カードを申請できます。
コンポーネントは、エンドユーザーの電話番号の収集を開始して、新規顧客か既存の顧客かを識別します。新規ユーザーの場合、コンポーネントは、月収や費用のカテゴリ、ユーザーがリクエストしたカードの特典など、必要な詳細情報を収集します。必要な情報がすべて収集されると、コンポーネントはコールバックを手配し、ユーザーにリクエスト番号を提供します。
既存の顧客の場合、コンポーネントは登録済みのユーザー情報を取得し、ユーザーの希望と、信用スコアを含む取得した情報に基づいて、利用可能なカード オプションをエンドユーザーに提示します。お客様がカード オプションを選択すると、コンポーネントは、登録手続きを完了するためのリンクを登録済みのチャネル（WhatsApp や SMS など）経由で送信します。
このコンポーネントでは、電話番号の収集と郵便番号の収集の事前構築済みコンポーネントを使用して、ユーザーの詳細を収集して検証します。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニー経由で呼び出されたときの動作を示しています。呼び出しにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
新しいユーザー
コンポーネントは、ユーザーが登録済みの電話番号を使用して電話をかけているかどうかを確認し、新規ユーザーであることを確認します。このコンポーネントは、ユーザーが登録を希望するカードのカテゴリを収集し、郵便番号や電話番号など、ユーザーを特定するための情報を収集します。次に、コンポーネントはコールバックを手配して、ユーザーにリクエスト番号を付与します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 銀行の既存の顧客かどうかをご確認ください。 | |
| 違います | |
| クレジット カードのお申し込みいただきありがとうございます。お客様に適したさまざまなクレジット カードをご用意しています。 最適なカードをご提供するために、月収を米ドルでお知らせください。 |
|
| 5,000 ドルです | |
| どの費用や福利厚生に興味がありますか？旅行、ガソリン、ショッピングなど、さまざまなオプションをご利用いただけます。 | |
| ショッピングです | |
| 選択した回答はショッピング カテゴリに該当します。続行する場合は「はい」と言ってください。 | |
| ○ | |
| エージェントは、郵便番号の収集の事前構築済みコンポーネントを使用して、ユーザーの郵便番号を収集します。 | |
| 郵便番号は 10011 で間違いありませんか？ | |
| はい、そうです | |
| ありがとうございます。郵便番号の収集が完了しました。 | |
| エージェントは、電話番号の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します | |
| 承知しました。番号は 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 | （省略可）エンドユーザーの電話番号。このパラメータを指定しない場合、このコンポーネントはエンドユーザーから電話番号を収集します。 | 文字列 |
| $flow.max_retry_count | エンドユーザーに許可する再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.currency_name | 毎月の収入の詳細を収集する際に想定される通貨を指定します。デフォルト値は "USD" です。 |
文字列 |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX Console を開きます。
- ご自身の 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 の組み込みイベントをご覧ください。 |
文字列 |
基本設定
この事前構築済みコンポーネントを設定するには:
- 事前構築済みコンポーネントをインポートします。
- 外部サービスを記述する構成を使用して、付属の柔軟な 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 を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_account_details Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
カード数を取得
prebuilt_components_credit_card_enrollment:get_card_count Webhook は、登録済みのユーザーのクレジット カードの数を取得するためにコンポーネントによって使用します。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| card_count | 登録済みユーザーのアカウントにまたがるクレジット カードの合計数。 | integer |
このコンポーネントの [カード数を取得] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_card_count Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [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 を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_available_card Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [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 を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:get_selected_card Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [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 を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:submit_enroll Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [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 を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_credit_card_enrollment:send_message Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。