支払いを行うための事前構築済みコンポーネントは、ユーザーを認証し、ユーザーが支払いを行えるようにします。このコンポーネントは、アカウント所有者とカード所有者を認証するために、Authentication 事前構築済みコンポーネントのカスタマイズ版を使用します。このコンポーネントは、名前の収集、クレジット カードの有効期限の収集、クレジット カード CVV の収集も使用して、支払いに必要な情報を収集します。
お支払いタイプ
このコンポーネントは、クレジット カードの請求書と受取人アカウントの支払いをサポートしています。クレジット カードの請求については、請求額の最低額、合計額、またはカスタム金額の支払いを選択できます。ユーザーは、銀行口座、デビットカード、クレジット カード、モバイル決済から支払いを行えます。
| お支払いタイプ | ご利用可能なお支払い方法 | 利用可能なお支払い金額 |
|---|---|---|
| クレジット カードの請求書 | 銀行口座、デビットカード、モバイル決済 | 最小額、合計額、任意の金額 |
| 受取人の口座 | 銀行口座、クレジット カード、デビットカード、モバイル決済 | カスタム金額 |
制限事項
一般的な事前構築済みコンポーネントの制限に加えて、この事前構築済みコンポーネントには次の制限があります。
- このコンポーネントはデータを暗号化しません。
サンプル ダイアログ
次のサンプル ダイアログは、この事前構築されたコンポーネントによって処理される一般的なシナリオを示しています。サンプル ダイアログは、コンポーネントがテレフォニー経由で呼び出されたときの動作を示しています。これにより、Default Welcome Intent と会話開始時の最初のエージェント レスポンスがトリガーされます。
受取人口座への支払い
エージェントは、ユーザーが以前に認証されていないことを確認して、ユーザーが登録ユーザーであることを確認するための情報を収集します。受取人口座へのお支払いを希望すると、エージェントは受取人名などの必要な情報を収集し、口座番号を確認します。最後に、ユーザーがデビットカードでの支払いを選択すると、エージェントはデビットカード番号、有効期限、CVV を収集し、支払いを確認します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| エージェントが事前構築済みの Authentication コンポーネントを使用してユーザーを認証します。 | |
| ありがとうございます。認証が完了しました。 | |
| 登録済みのクレジット カードの請求書の支払い、または既存の受取人アカウントへの支払いのどちらをご希望ですか？ | |
| 受取人 | |
| エージェントは、名前の収集の事前構築済みコンポーネントを使用して受取人名を収集します | |
| 受取人名を収集しました。 記録によると、アカウント番号は「7821」で終わっています。口座番号が正しい場合は、「はい」と答えてください。 |
|
| はい | |
| 支払い額を確認してください。たとえば、100.30 ドルを支払う場合は、「100 ポイント 30」と伝えます。 | |
| 50 ドルです。 | |
| 銀行口座、デビットカード、クレジット カード、モバイル決済のどちらでお支払いしますか？ | |
| デビット | |
| お問い合わせのデビットカード番号の末尾 4 桁を教えていただけますか？ | |
| 1234 | |
| デビットカード番号の末尾 4 桁は 1234 で間違いありませんか？ | |
| 正解です。 | |
| エージェントは、クレジット カードの有効期限収集の事前構築済みコンポーネントを使用してデビットカードの有効期限を収集する | |
| ありがとうございます。デビットカードの有効期限の収集が完了しました。 | |
| エージェントは、クレジット カード CVV の収集の事前構築済みコンポーネントを使用してデビットカードの CVV を収集する | |
| ありがとうございます。CVV の収集が完了しました。 | |
| 承知しました。末尾が 1234 のデビットカード番号で、ジェーン様に 50 米ドルをお支払いします。この操作を確定しますか？ | |
| はい | |
| 手続きを進めるため、コードを送信します。コードは、電話とメールのどちらで受け取ることをご希望ですか？ | |
| メールでお願いします | |
| 登録されているメールアドレス john.doe@google.com にコードを送信しました。コードの受信には数秒かかることがあります。コードを確認してください。 | |
| 123456 | |
| 支払いを処理しますので、しばらくお待ちください。 受取人口座へのお支払いは正常に完了しました。 |
クレジット カードの請求の支払い
エージェントは、ユーザーが以前に認証されていないことを確認して、ユーザーが登録ユーザーであることを確認するための情報を収集します。お客様は、銀行口座を使用してクレジット カードの請求額を支払うことを希望しています。エージェントは支払い金額と支払い方法の詳細を確認し、支払いを行います。
| ユーザー入力 | エージェントの応答 |
|---|---|
| エージェントが事前構築済みの Authentication コンポーネントを使用してユーザーを認証します。 | |
| ありがとうございます。認証が完了しました。 | |
| 登録済みのクレジット カードの請求書の支払い、または既存の受取人アカウントへの支払いのどちらをご希望ですか？ | |
| クレジット カードの請求書 | |
| お問い合わせのクレジット カード番号の末尾 4 桁を教えていただけますか？ | |
| 4321 | |
| クレジット カード番号の末尾 4 桁は 4321 で間違いありませんか？ | |
| はい | |
| 支払い合計額は 300 ドルで、最低支払い額は 20 ドルです。全額、最低額、または他の金額で支払いますか？ | |
| 全額 | |
| 銀行口座、デビットカード、モバイル決済のどちらで支払いますか？ | |
| 普通預金口座 | |
| お客様の番号には、2 つのアカウントが関連付けられています。対象アカウントの末尾 4 桁をお知らせください。 | |
| 1001 | |
| 受け取ったアカウント番号の末尾 4 桁は 1001 ですか？ | |
| はい | |
| クレジット カードの請求書（末尾が 4321、口座番号の末尾が 1001）に対して 300 米ドルの支払いを行います。この操作を確定しますか？ | |
| はい | |
| 手続きを進めるため、コードを送信します。コードは、電話とメールのどちらで受け取ることをご希望ですか？ | |
| メールに送信 | |
| 登録されているメールアドレス john.doe@google.com にコードを送信しました。コードの受信には数秒かかることがあります。コードを確認してください。 | |
| 123456 | |
| 支払いを処理いたしますので、しばらくお待ちください。 クレジット カードによるお支払いが完了しました。 |
残高または限度額が不足している
エージェントは、ユーザーが以前に認証されていないことを確認して、ユーザーが登録ユーザーであることを確認するための情報を収集します。ユーザーは、銀行口座とデビットカードを使用してクレジット カードの請求額の支払おうとしますが、どちらも残高不足や限度額超過を理由に支払いが拒否されます。最後に、ユーザーはモバイル決済を選択し、エージェントはモバイル決済用のリンクをユーザーに送信します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| エージェントが事前構築済みの Authentication コンポーネントを使用してユーザーを認証します。 | |
| ありがとうございます。認証が完了しました。 | |
| 登録済みのクレジット カードの請求書の支払い、または既存の受取人アカウントへの支払いのどちらをご希望ですか？ | |
| クレジット カード | |
| お問い合わせのクレジット カード番号の末尾 4 桁を教えていただけますか？ | |
| 4321 | |
| クレジット カード番号の末尾 4 桁は 4321 で間違いありませんか？ | |
| はい | |
| 支払い合計額は 300 ドルで、最低支払い額は 20 ドルです。全額、最低額、または他の金額で支払いますか？ | |
| 全額 | |
| 銀行口座、デビットカード、モバイル決済のどちらで支払いますか？ | |
| 普通 | |
| お客様の番号には、2 つのアカウントが関連付けられています。対象アカウントの末尾 4 桁をお知らせください。 | |
| 1002 | |
| 受け取ったアカウント番号の末尾 4 桁は 2002 ですか？ | |
| はい | |
| クレジット カードの請求書（末尾が 4321、口座番号の末尾が 1002）に対して 300 米ドルの支払いを行います。この操作を確定しますか？ | |
| はい | |
| 手続きを進めるため、コードを送信します。コードは、電話とメールのどちらで受け取ることをご希望ですか？ | |
| メール | |
| 登録されているメールアドレス john.doe@google.com にコードを送信しました。コードの受信には数秒かかることがあります。コードを確認してください。 | |
| 123456 | |
| 支払い手続きを進めますので、しばらくお待ちください。 アカウントの残高が不足しているため、支払いに失敗しました。別の支払い方法でもう一度試しますか？ |
|
| はい | |
| 銀行口座、デビットカード、モバイル決済のどちらで支払いますか？ | |
| デビットカード | |
| お問い合わせのデビットカード番号の末尾 4 桁を教えていただけますか？ | |
| 2345 | |
| デビットカード番号の末尾 4 桁は 2345 で間違いありませんか？ | |
| はい | |
| エージェントは、クレジット カードの有効期限収集の事前構築済みコンポーネントを使用してデビットカードの有効期限を収集する | |
| ありがとうございます。デビットカードの有効期限の収集が完了しました。 | |
| エージェントは、クレジット カード CVV の収集の事前構築済みコンポーネントを使用してデビットカードの CVV を収集する | |
| ありがとうございます。CVV の収集が完了しました。 | |
| 末尾が 4321 のクレジット カードの請求額 300 米ドルを、末尾の番号が 2345 のデビットカードで支払います。この操作を確定しますか？ | |
| はい | |
| 手続きを進めるため、コードを送信します。コードは、電話とメールのどちらで受け取ることをご希望ですか？ | |
| メール | |
| 登録されているメールアドレス john.doe@google.com にコードを送信しました。コードの受信には数秒かかることがあります。コードを確認してください。 | |
| 123456 | |
| 支払い手続きを進めますので、しばらくお待ちください。 デビットカードの利用限度額を超えているため、お支払い手続きが失敗しました。別の支払い方法でもう一度試しますか？ |
|
| はい | |
| 銀行口座、デビットカード、モバイル決済のどちらで支払いますか？ | |
| モバイル | |
| わかりました。登録済みの携帯電話番号に支払いリンクを送信します。この処理には数秒かかることがあります。届いている場合は「はい」と言ってください。 | |
| はい | |
| リンクを開いて、お支払いを続行してください。 |
命名規則
この事前構築済みコンポーネントでは、次の命名規則が使用されています。
| 機能 | 形式 | 例 |
|---|---|---|
| フロー | [コンポーネント名] | 支払いを行う |
| コンポーネントに固有のインテント | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_make_a_payment_payment_type |
| エンティティ タイプ | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_make_a_payment_payment_mode |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_make_a_payment:process_payment_credit_card |
入力パラメータ
入力パラメータは、コンポーネントの特定の動作を構成するために使用されるパラメータです。このパラメータは、コンポーネントの動作を決定するためにフロー内の 1 つ以上の条件によって使用されます。フロースコープのパラメータは、後述するように、コンポーネントのスタートページで設定する必要があります。セッション スコープのパラメータは、呼び出しフローまたはこのコンポーネントのスタートページで設定できます。
この事前構築済みコンポーネントは、次の入力パラメータを受け入れます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.auth_level | 発信者の認証レベルを示します。 | integer |
| $session.params.auth_level_req | ユーザーが取引履歴にアクセスする前に必要な認証レベルを示します。この値は、check auth level ページのページ エントリのフルフィルメントのパラメータ プリセットで構成されます。デフォルト値は 1 です。 |
整数 |
| $session.params.account_auth_enabled | 認証タイプで説明されているように、ユーザーをアカウント所有者として認証する必要があるかどうかを示します。この値は、check auth level ページのページ エントリのフルフィルメントのパラメータ プリセットで構成されます。デフォルト値は true です。 |
ブール値 |
| $session.params.card_auth_enabled | 認証タイプで説明されているように、ユーザーをカード所有者として認証する必要があるかどうかを示します。この値は、check auth level ページのページ エントリのフルフィルメントのパラメータ プリセットで構成されます。デフォルト値は false です。 |
ブール値 |
| $session.params.phone_number | （省略可）認証に使用するお客様の登録電話番号。 | 文字列 |
| $flow.payment_success_code | 支払いが正常に完了したことを示す process_payment Webhook から返される payment_status_code フィールドの値を指定します。デフォルト値は "200" です。 |
文字列 |
| $flow.insufficient_fund_code | 残高不足のため支払いを完了できなかったことを示す process_payment Webhook から返される payment_status_code フィールドの値を指定します。デフォルト値は "400" です。 |
文字列 |
| $flow.limit_exceed_code | 1 日の上限を超えたために支払いを完了できなかったことを示す process_payment Webhook から返される payment_status_code フィールドの値を指定します。デフォルト値は "401" です。 |
文字列 |
| $flow.max_retry_mop_counter | ユーザーが支払い方法を変更できる回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_credit_card_payment | 支払い方法としてクレジット カードを使用して支払いを試行する際に許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_retry_mobile_payment_counter | 支払い方法としてモバイル決済を使用して支払いを試行する際に許可される再試行回数を指定します。デフォルト値は 2 です。 |
integer |
| $flow.max_retry_creditcard_count | お支払い用の有効なクレジット カード番号を収集する際に許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_retry_acc_number | 支払いを行うための有効なアカウント情報を収集する際に許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_retry_debit_card_details | お支払いのために有効なデビットカード情報を収集する際に許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_retry_credit_card_details | お支払いのために有効なクレジット カード情報を収集する際に許可される再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.otp_length | ユーザーに送信されるワンタイム パスワードの想定される長さを指定します。デフォルト値は 6 です。 |
integer |
| $flow.max_retry_otp_count | ユーザーから有効なワンタイム パスワード（OTP）を収集する際に許可する再試行回数を指定します。デフォルト値は 3 です。 |
integer |
| $flow.max_waiting_room_counter | お客様がモバイル決済のリンクを受け取るまで待機するようエージェントに依頼できる回数を指定します。デフォルト値は 2 です。 |
integer |
このコンポーネントの入力パラメータを構成するには、開いて手順を確認します。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Build] タブを選択します。
- [Flows] セクションでインポートされたコンポーネントをクリックします。
- [Pages] セクションで [Start Page] をクリックします。
- スタートページで true ルートをクリックします。
- [Route] ウィンドウで、必要に応じて [Parameter Presets] 値を編集します。
- [Save] をクリックします。
出力パラメータ
出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| auth_level | 発信者の認証レベルを示します。 | integer |
| 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 を構成して外部サービスから必要な情報を取得する必要があります。
認証
認証に必要な外部サービスをまだ構成していない場合は、このコンポーネントのユーザーの認証を有効にするようにそれらを構成する必要があります。詳細な手順については、Authentication Webhook の設定をご覧ください。
アカウントを検証
prebuilt_components_account_services:validate_account Webhook は、ユーザーの登録電話番号と指定されたアカウント番号の末尾 4 桁に基づいてアカウントが存在することを確認するためにコンポーネントによって使用されます。
アカウントが存在する場合、Webhook はアカウント残高も返します。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $session.params.last_four_digit_of_account_number | ユーザーが選択し、お支払いの確認を行ったアカウント番号の末尾 4 桁。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| account_found | 提供された末尾 4 桁のアカウントが、ユーザーの登録済みアカウントに存在するかどうかを示します。 | ブール値 |
| 残高 | アカウントの現在の残高（存在する場合）。 | 数値 |
このコンポーネントの [アカウントを検証] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_account_services:validate_account Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
ユーザーのカード情報
prebuilt_components_make_a_payment:user_card_details Webhook は、登録済みユーザーのデビットカード情報とクレジット カード情報を取得するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| credit_card_count | 登録されている電話番号に関連付けられているクレジット カードの数。 | integer |
| last_four_digit_of_credit_card_number | ユーザーのクレジット カードの下 4 桁。お客様が複数のクレジット カードをお持ちの場合、この値は null です。 |
文字列 |
| debit_card_count | 登録されている電話番号に関連付けられているデビットカードの数。 | integer |
| last_four_digit_of_debit_card_number | ユーザーのデビットカードの下 4 桁。お客様が複数のデビットカードをお持ちの場合、この値は null です。 |
文字列 |
このコンポーネントの [ユーザーのカード情報] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:user_card_details Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
受取人名を確認する
prebuilt_components_make_a_payment:verify_beneficiary_name Webhook は、ユーザーが指定した名前の受取人アカウントが存在することを確認するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $session.params.name_collection_first_name | 受取人の名（ファースト ネーム）。 | 文字列 |
| $session.params.name_collection_last_name | 受取人の姓。 | 文字列 |
| $session.params.name_collection_middle_name | 受取人のミドルネーム。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| beneficiary_account_number | 指定された受取人名の受取人口座番号の末尾 4 桁。指定された名前の受取人口座が見つからない場合、値は null になります。 |
文字列 |
このコンポーネントの [受取人名を確認する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:verify_beneficiary_name Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
支払い金額を取得する
prebuilt_components_make_a_payment:get_due_amount Webhook は、コンポーネントによって、ユーザーのクレジット カードの請求書の最低支払い額と合計支払い額に関する情報を取得するために使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.user_credit_card_number | ユーザーのクレジット カードの下 4 桁。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| minimum_amount | 指定したクレジット カードの請求書の最低支払い額。 | 数値 |
| total_amount | 指定したクレジット カードの請求額の合計。 | 数値 |
このコンポーネントの [請求額を取得] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:get_due_amount Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
クレジット カード番号を確認する
prebuilt_components_make_a_payment:verify_credit_card_number Webhook は、指定されたクレジット カード番号がユーザーのアカウントに登録されていることを確認するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.user_credit_card_number | ユーザーのクレジット カードの下 4 桁。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| card_found | 指定されたクレジット カードが見つかったかどうかを示します。 | ブール値 |
このコンポーネントの [クレジット カード番号を確認する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:verify_credit_card_number Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
クレジット カード情報を確認する
prebuilt_components_make_a_payment:verify_credit_card_details Webhook は、有効期限や CVV などの提供された詳細が、ユーザーが指定したクレジット カードで有効であることを確認するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.credit_card_number | ユーザーのクレジット カードの下 4 桁。 | 文字列 |
| $flow.credit_card_exp_date | ユーザーが指定した特定のクレジット カードの有効期限。 | { |
| $flow.credit_card_cvv_code | 指定されたクレジット カードの CVV コード。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| creditcard_verification_status | 指定されたクレジット カード情報が検証されたかどうかを示します。 | ブール値 |
このコンポーネントの [クレジット カード情報を確認する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:verify_credit_card_details Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
デビットカード情報を確認する
prebuilt_components_make_a_payment:verify_debit_card_details Webhook は、有効期限や CVV などの提供された詳細が、ユーザーが指定したデビットカードで有効であることを確認するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.debit_card_number | ユーザーのデビットカードの下 4 桁。 | 文字列 |
| $flow.debit_card_exp_date | ユーザーが指定したデビットカードの有効期限。 | { |
| $flow.debit_card_cvv_code | ユーザーが指定したデビットカードの CVV コード。 | 文字列 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| debitcard_verification_status | 指定されたデビットカード情報が検証されたかどうかを示します。 | ブール値 |
このコンポーネントの [デビットカード情報を確認する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:verify_debit_card_details Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
クレジット カード支払いを処理する
prebuilt_components_make_a_payment:process_payment_credit_card Webhook は、指定されたクレジット カード情報を使用して支払いを処理するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.payee_number | 支払いの受取人の口座番号の下 4 桁。 | 文字列 |
| $flow.payment_type | 支払いのお支払い方法。有効な値は、prebuilt_components_make_a_payment_payment_type カスタム エンティティによって定義されます。デフォルトでは、このコンポーネントは "beneficiary_pay" と "credit_card_pay" をサポートしています。 |
文字列 |
| $flow.credit_card_number | ユーザーのクレジット カードの下 4 桁。 | 文字列 |
| $flow.credit_card_exp_date | 指定されたクレジット カードについて、ユーザーが指定したクレジット カードの有効期限。 | { |
| $flow.credit_card_cvv_code | 指定されたクレジット カードの CVV コード。 | 文字列 |
| $flow.payment_amount | ユーザーが支払うことを選択した金額。 | 数値 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| payment_status_code | 支払いが成功したかどうかを示します。有効な値は、$flow.payment_success_code、$flow.insufficient_fund_code、$flow.limit_exceed_code の構成可能な入力パラメータによって定義されます。 |
文字列 |
このコンポーネントの [クレジット カード支払いを処理する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:process_payment_credit_card Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
デビットカードの支払いを処理する
prebuilt_components_make_a_payment:process_payment_debit_card Webhook は、指定されたデビットカード情報を使用して支払いを処理するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.payee_number | 支払いの受取人の口座番号の下 4 桁。 | 文字列 |
| $flow.payment_type | 支払いのお支払い方法。有効な値は、prebuilt_components_make_a_payment_payment_type カスタム エンティティによって定義されます。デフォルトでは、このコンポーネントは "beneficiary_pay" と "credit_card_pay" をサポートしています。 |
文字列 |
| $flow.debit_card_number | ユーザーのデビットカードの下 4 桁。 | 文字列 |
| $flow.debit_card_exp_date | ユーザーが指定したデビットカードの有効期限。 | { |
| $flow.debit_card_cvv_code | ユーザーが指定したデビットカードの CVV コード。 | 文字列 |
| $flow.payment_amount | ユーザーが支払うことを選択した金額。 | 数値 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| payment_status_code | 支払いが成功したかどうかを示します。有効な値は、$flow.payment_success_code、$flow.insufficient_fund_code、$flow.limit_exceed_code の構成可能な入力パラメータによって定義されます。 |
文字列 |
このコンポーネントの [デビットカードの支払いを処理する] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:process_payment_debit_card Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
アカウントの支払いを処理する
prebuilt_components_make_a_payment:process_payment_account Webhook は、指定されたアカウントの詳細を使用して支払いを処理するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.payee_number | 支払いの受取人の口座番号の下 4 桁。 | 文字列 |
| $flow.payment_type | 支払いのお支払い方法。有効な値は、prebuilt_components_make_a_payment_payment_type カスタム エンティティによって定義されます。デフォルトでは、このコンポーネントは "beneficiary_pay" と "credit_card_pay" をサポートしています。 |
文字列 |
| $session.params.last_four_digit_of_account_number | ユーザーのアカウントの末尾 4 桁。 | 文字列 |
| $flow.payment_amount | ユーザーが支払うことを選択した金額。 | 数値 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| payment_status_code | 支払いが成功したかどうかを示します。有効な値は、$flow.payment_success_code、$flow.insufficient_fund_code、$flow.limit_exceed_code の構成可能な入力パラメータによって定義されます。 |
文字列 |
このコンポーネントの [アカウントの支払いを処理する] Webhook を構成するには、展開して手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:process_payment_account Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [保存] をクリックします。
モバイル決済を処理する
prebuilt_components_make_a_payment:process_payment_mobile Webhook は、ユーザーが選択したお支払い情報のモバイル決済リンクを生成して送信するためにコンポーネントによって使用されます。
API リクエスト パラメータ
以下のパラメータは、コンポーネントによって API リクエストへの入力として提供されます。
| パラメータ名 | 説明 | 入力形式 |
|---|---|---|
| $session.params.phone_number | ユーザーの識別に使用されるユーザーの電話番号（国コードなし）。 | 文字列 |
| $flow.payee_number | 支払いの受取人の口座番号の下 4 桁。 | 文字列 |
| $flow.payment_type | 支払いのお支払い方法。有効な値は、prebuilt_components_make_a_payment_payment_type カスタム エンティティによって定義されます。デフォルトでは、このコンポーネントは "beneficiary_pay" と "credit_card_pay" をサポートしています。 |
文字列 |
| $flow.payment_amount | ユーザーが支払うことを選択した金額。 | 数値 |
API レスポンス パラメータ
以下のパラメータは、コンポーネントで使用される API レスポンスから取得されます。
| パラメータ名 | 説明 | 出力形式 |
|---|---|---|
| payment_link_generated | モバイル決済リンクが正常に生成され、ユーザーに送信されたかどうかを示します。 | ブール値 |
このコンポーネントの [モバイル決済処理] Webhook を構成するには、開いて手順を確認してください。
- Dialogflow CX Console を開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Manage] タブを選択します。
- [Webhooks] をクリックします。
- prebuilt_components_make_a_payment:process_payment_mobile Webhook を選択します。
- Dialogflow CX Webhook URL フィールドの URL を、統合するサービスのエンドポイントに置き換えます。プルダウンで適切なメソッドを選択します。
- Webhook に適したリクエスト形式になるように、リクエスト本文を確認して更新します。
- レスポンス構成を確認して更新し、Webhook のレスポンスから特定のフィールドを抽出します。パラメータ名は、コンポーネントが返されたフィールド値にアクセスするために必要であるため、変更しないでください。
- 必要に応じて [Authentication] の設定を確認し、更新します。
- [Save] をクリックします。
完了
これで、エージェントとその Webhook が設定され、テストの準備が整いました。