口座開設の事前構築済みコンポーネントを使用すると、新規および既存のユーザーが新しい口座を解説することも、既存の申請のステータスを確認することもできます。このコンポーネントでは、生年月日の収集、名前の収集、電話番号の収集の事前構築済みコンポーネントを使用して、新しい口座を登録するためにユーザー情報を収集します。
アカウントの種類
このコンポーネントは、デフォルトで次の口座種別をサポートしています。
- 普通預金口座
- 当座預金口座
- Demat 口座
- 給与口座
サポートされている口座種別は、prebuilt_components_open_account_account_type カスタム エンティティを変更することで追加または削除できます。
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニー経由で呼び出されたときの動作を示しています。これにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
新しいユーザー
エージェントはユーザーの電話番号を収集し、ユーザーが口座に登録されていないことを確認します。エージェントは、ユーザーの氏名や生年月日などの詳細を収集し、ユーザーが入力した電話番号に送信される申請を生成します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 確認のために電話番号をお知らせください。 | |
| エージェントは、電話番号の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します | |
| 電話番号の収集が完了しました。 口座の開設について Google にお問い合わせいただきありがとうございます。 |
|
| エージェントは、名前の収集の事前構築済みコンポーネントを使用してユーザーのフルネームを収集します | |
| John Doe さん、ありがとうございます。 | |
| エージェントは、生年月日の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します | |
| 生年月日の収集が完了しました。 開設する口座の種別を教えてください。普通、当座、給与、Demat を指定できます。 |
|
| 当座預金口座 | |
| 確認ですが、新しい当座預金口座の開設を希望されますか？ | |
| はい | |
| 情報をご提供いただきありがとうございます。申請の生成が完了するまでお待ちください。 申請 ID は 81037 です。登録されたモバイル デバイスに記載されたリンクをクリックして、申請を完了してください。 |
既存のユーザー
エージェントは、ユーザーが以前に認証されたことを確認し、ユーザーが開設する口座の種別を確認します。エージェントはユーザーに申請を作成し、そのユーザーの登録済み電話番号に指示を送信します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 新規口座の開設をお申し込みいただきありがとうございます。 開設する口座の種別を教えてください。普通、当座、給与、Demat を指定できます。 |
|
| 普通預金口座をお願いします | |
| 確認ですが、新しい普通預金口座の開設を希望されますか？ | |
| はい、そうです | |
| 情報をご提供いただきありがとうございます。申請の生成が完了するまでお待ちください。 申請 ID は 21430 です。登録されたモバイル デバイスに記載されたリンクをクリックして、申請を完了してください。 |
既存の申請
エージェントは、ユーザーが以前に 1 つの申請を行っていたことを識別し、現在のステータスを提示します。ユーザーが新しい口座で別の申請を開設することを拒否します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 確認のために電話番号をお知らせください。 | |
| エージェントは、電話番号の収集の事前構築済みコンポーネントを使用してユーザーの電話番号を収集します | |
| 電話番号の収集が完了しました。 普通預金口座を開設するための ID 12234 の申請が進行中です。別の口座を開設しますか？ |
|
| いいえ | |
| お電話ありがとうございます。 |
命名規則
この事前構築済みコンポーネントでは、次の命名規則が使用されています。
| 機能 | 形式 | 例 |
|---|---|---|
| フロー | [コンポーネント名] | 口座を開設する |
| コンポーネントに固有のインテント | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| エンティティ タイプ | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
入力パラメータ
入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、後述するように、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。
この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.auth_level | 発信者の認証レベルを示します。 | integer |
| $session.params.phone_number | （省略可）認証に使用するお客様の登録電話番号。 | 文字列 |
| $session.params.min_age_limit | 新規口座を開設が許可されるユーザーの最低年齢を指定します。デフォルト値は 18 です。 |
integer |
| $session.params.max_age_limit | 新規口座を開設が許可されるユーザーの最高年齢を指定します。デフォルト値は 100 です。 |
integer |
| $flow.max_dob_retry_count | 有効な生年月日の収集時に許可する再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_account_type | ユーザーが開設しようとしている口座の種別を収集する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_another_account | 選択した口座の種別をユーザーが変更したい場合に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- 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 の設定
このコンポーネントを使用するには、付属の Flexible Webhook を構成して外部サービスから必要な情報を取得する必要があります。
電話による確認
prebuilt_components_open_account:telephone_verification Webhook は、登録済みの電話番号や、ユーザーの電話番号に関連付けられている以前の申請に関する情報を取得するために、コンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| account_count | 登録されている電話番号に関連付けられている口座の数。これらの口座には、自分の口座とユーザーが委任状を保有する口座が含まれます。指定された電話番号に関連付けられている口座がない場合、この値は null になります。 |
integer |
| user_first_name | 登録ユーザーの名。電話番号が登録済み口座に関連付けられていない場合、この値は null です。 |
文字列 |
| user_last_name | 登録ユーザーの姓。電話番号が登録済み口座に関連付けられていない場合、この値は null です。 |
文字列 |
| user_dob | 登録ユーザーの生年月日（YYYY-MM-DD 形式）。電話番号が登録済み口座に関連付けられていない場合、この値は null です。 |
文字列 |
| application_count | 登録されている電話番号に関連付けられている申請の数。指定された電話番号に関連付けられた申請がない場合、この値は null になります。 |
integer |
| application_id | 指定された電話番号に関連付けられている各申請の申請 ID を含むリスト（例: ["00000", "11111", "22222"]）。このリスト内の各要素は、account_type と application_status で同じインデックスを持つ要素と同じ申請を表します。指定された電話番号に関連付けられた申請がない場合、この値は null になります。 |
リスト（文字列） |
| account_type | 指定された電話番号に関連付けられている各申請の口座種別を含むリスト（例: ["savings", "checking", "demat"]）。このリスト内の各要素は、application_id と application_status で同じインデックスを持つ要素と同じ申請を表します。指定された電話番号に関連付けられた申請がない場合、この値は null になります。 |
リスト（文字列） |
| application_status | 指定された電話番号に関連付けられている各申請のステータスを含むリスト（例: ["in progress", "on hold", "completed"]）。このリスト内の各要素は、application_id と account_type で同じインデックスを持つ要素と同じ申請を表します。指定された電話番号に関連付けられた申請がない場合、この値は null になります。 |
リスト（文字列） |
このコンポーネントの電話確認 Webhook を構成するには、展開して手順をご覧ください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_open_account:telephone_verification Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
申請を生成する
prebuilt_components_open_account:generate_application Webhook は、新しい口座の申請を生成するためにコンポーネントで使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| user_first_name | AppDynamics の一意のユーザー名。 | 文字列 |
| user_last_name | ユーザーの姓。 | 文字列 |
| user_dob | ユーザーの生年月日（YYYY-MM-DD 形式）。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| application_id | 新規口座申請用に生成された申請 ID。 | 文字列 |
このコンポーネント用に申請の生成 Webhook を構成するには、展開して手順をご覧ください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_open_account:generate_application Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。