電話番号収集の事前構築済みコンポーネント

この事前構築済みコンポーネントでは、国コードと電話番号を取得して検証します。

制限事項

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

16 桁を超える電話番号には対応していません。

推奨されるエージェント設定

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

その他の機能

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

サンプルダイアログ

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

有効な電話番号を 2 ターンで指定する

エンドユーザーは、最初に国コード、続けて電話番号を指定し、エージェントが正常に検証して受け入れます。

ユーザー入力	エージェントの応答
	国名またはコードを教えてください。
+1
	わかりました。国コードは +1 ですね。電話番号を教えてください。
6502530000
	OK。番号は 1 6502530000 で間違いないでしょうか？
はい、正しいです
	電話番号の収集が完了しました。

有効な電話番号を 1 ターンで入力する

エンドユーザーが国コードと電話番号を同時に指定し、エージェントはそれを検証して受け入れます。

ユーザー入力	エージェントの応答
	国名またはコードを教えてください。
+1 6502530000
	OK。番号は 1 6502530000 で間違いないでしょうか？
はい、正しいです
	電話番号の収集が完了しました。

電話番号が無効です

エンドユーザーが国コードと電話番号を 1 ターンで入力します。エージェントは、指定された電話番号が有効な長さ（16 桁以内）ではあるが、有効な電話番号ではないことを確認します。エージェントはエンドユーザーに電話番号の入力を再度求めます。

ユーザー入力	エージェントの応答
	国名またはコードを教えてください。
+1 6502530001
	申し訳ありませんが、この電話番号は認識できません。国コードを +1 として収集しました。有効な電話番号を指定してください。
6502530000
	OK。番号は 1 6502530000 で間違いないでしょうか？
はい、正しいです
	電話番号の収集が完了しました。

国コードと電話番号が無効

エンドユーザーが国コードと電話番号を 1 ターンで入力します。エージェントは、入力された国コードと電話番号が無効なことを確認します。エージェントは、エンドユーザーに国コードと電話番号の入力を再度求めます。

ユーザー入力	エージェントの応答
	国名またはコードを教えてください。
+0080000000000
	すみません。指定された国コードまたは電話番号が無効です。もう一度始めましょう。国名またはコードを教えてください。
1
	わかりました。国コードは +1 ですね。電話番号を教えてください。
6502530000
	OK。番号は 1 6502530000 で間違いないでしょうか？
はい、正しいです
	電話番号の収集が完了しました。

認識されない入力

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

ユーザー入力	エージェントの応答
	国名またはコードを教えてください。
大丈夫です
	すみません、聞き取れませんでした。国コードをもう一度言うか入力してください。
nice
	うーん、やはりわかりませんでした。今は国コードを聞いていることをご確認ください。音声認識に問題がある場合は、キーパッドを使用して国コードを入力することもできます。
good
	申し訳ありませんが、応答を理解するのが難しいです。

電話番号の検証

事前構築された電話番号コンポーネントでは、IS_PHONE_NUMBER システム関数を使用して、電話番号が有効なパターンと一致することを確認します。

命名規則

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

特徴	形式	例
フロー	[コンポーネント名]	電話番号の収集
コンポーネント固有のインテント	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_number_collection_incorrect_country_code
パラメータ	[param_name]	telephone_number
エンティティタイプ	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_no_country_code

出力パラメータ

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

パラメーター名	説明	出力形式
telephone_number_collection_telephone_number	このパラメータは、コンポーネントによって取得された電話番号を返します	string
telephone_number_collection_country_code	このパラメータは、コンポーネントによってキャプチャされた国コードを返します	string

基本設定

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

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

完了

これで、エージェントが設定され、テストの準備が整いました。

通信の運用

トランザクション履歴