电话号码收集预构建组件

此 预构建组件 可捕获并验证国家/地区代码和电话号码。

限制

除了常见的预构建组件限制之外，此预构建组件还存在以下限制：

• 不接受超过 16 位数的电话号码。

建议的智能体设置

启用 DTMF，以便用户可以使用电话拨号键盘输入数值。

其他功能

此预构建组件提供以下其他功能：

• 重复
• 等候室
• 播放

对话示例

以下对话示例展示了此预构建组件处理的常见场景。这些对话示例展示了通过电话调用组件时的行为，该行为会在对话开始时触发默认欢迎意图和智能体的第一个回答。

在两个轮次中提供有效的电话号码

最终用户先提供国家/地区代码，然后提供电话号码；智能体成功验证并接受该电话号码。

用户输入	智能体回答
	您所在的国家/地区的名称或代码是什么？
+1
	知道了，您的国家/地区代码是 +1。请说出您的电话号码。
6502530000
	知道了。您提到的号码是 [phone]，对吗？
是的，没错
	太棒了，我已经收集完电话号码了。

在一个轮次中提供有效的电话号码

最终用户同时提供国家/地区代码和电话号码，智能体成功验证并接受该电话号码。

用户输入	智能体回答
	您所在的国家/地区的名称或代码是什么？
[phone]
	知道了。您提到的号码是 [phone]，对吗？
是的，没错
	太棒了，我已经收集完电话号码了。

无效手机号码

最终用户在一个轮次中提供国家/地区代码和电话号码；智能体检查后发现，所提供的电话号码长度有效（不超过 16 位数），但不是有效的电话号码。然后，智能体再次提示最终用户提供电话号码。

用户输入	智能体回答
	您所在的国家/地区的名称或代码是什么？
[phone]
	抱歉，我无法识别此电话号码。我已经收集到国家/地区代码 +1。请提供有效的电话号码。
6502530000
	知道了。您提到的号码是 [phone]，对吗？
是的，没错
	太棒了，我已经收集完电话号码了。

无效的国家/地区代码和电话号码

最终用户在一个轮次中提供国家/地区代码和电话号码；智能体检查后发现，所提供的国家/地区代码和电话号码无效。然后，智能体再次提示最终用户提供国家/地区代码和电话号码。

用户输入	智能体回答
	您所在的国家/地区的名称或代码是什么？
+0080000000000
	抱歉，您提供的国家/地区代码或电话号码似乎无效。我们重来一次吧。请说出您所在的国家/地区的名称或代码。
1
	知道了，您的国家/地区代码是 +1。您的电话号码是什么？
6502530000
	知道了。您提到的号码是 [phone]，对吗？
是的，没错
	太棒了，我已经收集完电话号码了。

无法识别的输入

最终用户提供无法识别的输入三次后，组件会退出流程。

用户输入	智能体回答
	您所在的国家/地区的名称或代码是什么？
没关系
	抱歉，我没听清。您能再说一遍或重新输入国家/地区代码吗？
nice
	嗯，我还是没听清。请确保您说的是国家/地区代码。如果您觉得我听不清您说话，也可以使用键盘输入国家/地区代码。
好
	抱歉，我很难理解您的回答。

电话号码验证

手机号码预构建组件使用 IS_PHONE_NUMBER 系统函数 来验证手机号码是否与有效模式匹配。

命名规则

此预构建组件使用以下命名规则：

功能	格式	示例
Flow	[组件名称]	电话号码收集
组件专用意图	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_number_collection_incorrect_country_code
参数	[参数名称]	telephone_number
实体类型	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_no_country_code

输出参数

输出参数是会话参数，退出组件后仍会保持有效状态。这些参数包含组件收集的重要信息。此预构建组件为以下输出参数提供值：

参数名称	说明	输出格式
telephone_number_collection_telephone_number	此参数返回组件捕获的电话号码	字符串
telephone_number_collection_country_code	此参数返回组件捕获的国家/地区代码	字符串

基本设置

如需设置此预构建组件，请执行以下操作：

1. 导入预构建组件。

完成

您的智能体现在应该已设置完毕，可以进行测试了。