电话号码收集预构建组件

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

限制

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

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

其他功能

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

示例对话框

以下示例对话框展示了此预构建组件处理的常见场景。这些示例对话框演示了通过电话调用组件时的行为，这会在对话开始时触发“默认欢迎意图”和第一个代理响应。

两轮的有效电话号码

最终用户先提供国家/地区代码，后跟电话号码；客服人员成功验证并接受。

用户输入	代理响应
	您所在国家/地区的名称或代码是什么？
+1
	知道了，你的国家/地区代码是 +1。请说出您的电话号码。
6502530000
	知道了。你提到的号码是 1 6502530000，对吗？
是的，正确
	太好了，我已经收集完电话号码了。

单轮有效电话号码

最终用户同时提供国家/地区代码和电话号码，客服人员成功验证并接受。

用户输入	代理响应
	您所在国家/地区的名称或代码是什么？
+1 6502530000
	知道了。你提到的号码是 1 6502530000，对吗？
是的，正确
	太好了，我已经收集完电话号码了。

电话号码无效

最终用户依次提供国家/地区代码和电话号码；代理经过检查，发现所提供的电话号码长度有效（16 位以内），但电话号码无效。然后，客服人员会重新提示最终用户提供电话号码。

用户输入	代理响应
	您所在国家/地区的名称或代码是什么？
+1 6502530001
	抱歉，我们无法识别此电话号码。我已将国家/地区代码设为 +1。请提供有效的电话号码。
6502530000
	知道了。你提到的号码是 1 6502530000，对吗？
是的，正确
	太好了，我已经收集完电话号码了。

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

最终用户一次性提供国家/地区代码和电话号码；代理经过检查，发现提供的国家/地区代码和电话号码无效。然后，代理会重新提示最终用户提供国家/地区代码和电话号码。

用户输入	代理响应
	您所在国家/地区的名称或代码是什么？
+0080000000000
	抱歉，提供的国家/地区代码或电话号码似乎无效。我们重新开始吧。请说出你所在的国家/地区名称或代码。
1
	知道了，你的国家/地区代码是 +1。您的电话号码是什么？
6502530000
	知道了。你提到的号码是 1 6502530000，对吗？
是的，正确
	太好了，我已经收集完电话号码了。

无法识别的输入内容

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

用户输入	代理响应
	您所在国家/地区的名称或代码是什么？
没关系
	抱歉，我没听明白。您可以说或再输入一次国家/地区代码吗？
nice
	抱歉，我还是没听明白。请确保您说的是国家/地区代码。如果没听清，您也可以使用键盘输入国家/地区代码。
good
	抱歉，我没听懂你的回复。

电话号码验证

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

命名惯例

此预构建组件使用以下命名惯例：

特征	形式	示例
流	[组件名称]	电话号码收集
组件专用 intent	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	此参数返回组件捕获的电话号码	字符串
telephone_number_collection_country_code	此参数返回组件捕获的国家/地区代码	字符串

基本设置

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

导入预构建组件。

完成

您的代理现在应已设置完毕，可以进行测试了。

电信监管

交易记录