クレジット カード有効期限収集の事前構築済みコンポーネント

この事前構築済みコンポーネントは、エンドユーザーからクレジット カードの有効期限を取得します。

制限事項

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

  • このコンポーネントには、決済ゲートウェイの統合は含まれていません。

DTMF を有効にすると、ユーザーは電話の番号入力を使用して数値を入力できます。

追加機能

この事前構築されたコンポーネントには、以下の追加機能が用意されています。

サンプル ダイアログ

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

問題のない入力

エンドユーザーが最初の試行で有効期限を提示し、エージェントが正常に受け入れます。

ユーザー入力 エージェントの応答
クレジット カードの有効期限を、月、年の順に教えてください。
01/27
クレジット カードの有効期限は、2027 年 1 月ですね。間違いありませんか?
はい
ありがとうございます。クレジット カードの有効期限の収集が完了しました。

再試行数

エンドユーザーが、最初の試行で有効期限を提示します。収集された有効期限の再確認で、エンドユーザーが「違う」と言います。エージェントは、エンドユーザーに対して有効期限のどの部分(全体、月、年)が間違っているかを確認し、再度詳細情報を入力するよう求めます。

ユーザー入力 エージェントの応答
クレジット カードの有効期限を、月、年の順に教えてください。
01/27
クレジット カードの有効期限は、2027 年 1 月ですね。間違いありませんか?
違います
すみません、うまく聞き取れませんでした。全体を変更する場合、または月や年を変更する場合は、お知らせください。
ご不便をおかけして申し訳ございません。クレジット カードの有効期限の月を教えてください。
2 月
クレジット カードの有効期限は 2 月ですね。間違いありませんか?
はい
クレジット カードの有効期限は、2027 年 2 月ですね。間違いありませんか?
はい
クレジット カードの有効期限の収集が完了しました。

部分的な入力

シナリオ - エンドユーザーが最初の試行で有効期限を提示できません。エージェントが有効期限を分割して、月、年の順に提供するよう求めます。今回はエンドユーザーが入力を正しく伝え、エージェントがそれを正常に受け入れます。

ユーザー入力 エージェントの応答
クレジット カードの有効期限を、月、年の順に教えてください。
13
申し訳ございませんが、有効期限が正しくないようです。もう一度月を取得してみましょう。

クレジット カードの有効期限の月を教えてください。
1
クレジット カードの有効期限の月は 1 月ですね。間違いありませんか?
はい。正しいです。
クレジット カードの有効期限の年を教えてください。
26
クレジット カードの有効期限の年は 2026 年ですね。間違いありませんか?
はい
クレジット カードの有効期限は 2026 年 1 月と入力されました。間違いありませんか?
はい
ありがとうございます。クレジット カードの有効期限の収集が完了しました。

認識されない入力

エンドユーザーが認識できない入力を 3 回提供すると、コンポーネントはフローを終了します。

ユーザー入力 エージェントの応答
クレジット カードの有効期限を、月、年の順に教えてください。
大丈夫です
すみません、聞き取れませんでした。クレジット カードの有効期限をもう一度教えてください。
素晴らしい
うーん、やはりわかりませんでした。これがクレジット カードの有効期限であることを確認してください。キーパッドを使用してクレジット カードの有効期限を入力することもできます。
良い
申し訳ありませんが、応答を理解するのが難しいです。

クレジット カードの有効期限の検証

クレジット カードの有効期限の月は、01~12 の整数または「1 月」~「12 月」の月を表す文字列として入力する必要があります。

クレジット カードの有効期限の年は 4 桁の数字にする必要があります。入力が 2 桁の場合、4 桁の年に変換されます。たとえば、「25」は「2025」になります。また、現在よりも先の 10 年以内の年でなければなりません。

クレジット カードの有効期限(月と年を含む)は、現在の月と年を考慮して、将来の日付にする必要があります。

命名規則

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

特徴 形式
フロー [コンポーネント名] クレジット カードの有効期限収集
コンポーネントに固有のインテント prebuilt_components_[component_name]_[intent_name] prebuilt_components_credit_card_expiration_date_collection_collect_date
エンティティ タイプ prebuilt_components_[component_name]_[entity_type_name] prebuilt_components_credit_card_expiration_date_collection_month
パラメータ [param_name] expiration_date

出力パラメータ

出力パラメータは、コンポーネントを終了した後もアクティブな状態を継続するセッション パラメータです。これらのパラメータには、コンポーネントによって収集される重要な情報が含まれます。この事前構築されたコンポーネントは、次の出力パラメータの値を提供します。

パラメータ名 説明 出力形式
credit_card_expiration_date_collection_credit_card_expiration_date このパラメータは、会話フロー セッション中にキャプチャされる有効期限要素タイプのオブジェクトを返します。
{
"year": integer,
"month": integer
}

基本設定

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

  1. 事前構築済みコンポーネントをインポートします。

完了

これでエージェントをセットアップし、テストの準備が整いました。