此预构建组件会捕获并验证国家/地区代码和电话号码。
限制
除了常见的预构建组件限制之外，此预构建组件还具有以下限制：
- 不接受超过 16 位的电话号码。
建议的代理设置
启用 DTMF，允许用户使用电话拨号键盘输入数值。
其他功能
此预构建组件提供以下附加功能：
对话示例
以下示例对话展示了此预构建组件处理的常见场景。示例对话演示了通过电话呼叫组件时的行为，这会在对话开始时触发默认欢迎 intent 和第一个代理响应。
Valid telephone number in two turns
最终用户先提供国家/地区代码，然后提供电话号码；客服人员成功验证并接受该号码。
| 用户输入 | 智能体回答 |
|---|---|
| 您所在国家/地区的名称或代码是什么？ | |
| +1 | |
| 知道了，您的国家/地区代码是 +1。请说出您的电话号码。 | |
| 6502530000 | |
| 知道了。您提到的号码是 +1 6502530000，对吗？ | |
| 是的，正确 | |
| 太好了，我已收集完电话号码。 |
单轮对话中提供有效的电话号码
最终用户同时提供国家/地区代码和电话号码，代理成功验证并接受。
| 用户输入 | 智能体回答 |
|---|---|
| 您所在国家/地区的名称或代码是什么？ | |
| +1 6502530000 | |
| 知道了。您提到的号码是 +1 6502530000，对吗？ | |
| 是的，正确 | |
| 太好了，我已收集完电话号码。 |
电话号码无效
最终用户在一轮对话中提供国家/地区代码和电话号码；代理检查并发现提供的电话号码长度有效（16 位以内），但不是有效的电话号码。然后，代理会再次提示最终用户提供电话号码。
| 用户输入 | 智能体回答 |
|---|---|
| 您所在国家/地区的名称或代码是什么？ | |
| +1 6502530001 | |
| 抱歉，无法识别此电话号码。我已收集到国家/地区代码为 +1。请提供有效的电话号码。 | |
| 6502530000 | |
| 知道了。您提到的号码是 +1 6502530000，对吗？ | |
| 是的，正确 | |
| 太好了，我已收集完电话号码。 |
国家/地区代码和电话号码无效
最终用户在一轮对话中提供国家/地区代码和电话号码；代理检查并发现提供的国家/地区代码和电话号码无效。然后，代理会重新提示最终用户提供国家/地区代码和电话号码。
| 用户输入 | 智能体回答 |
|---|---|
| 您所在国家/地区的名称或代码是什么？ | |
| +0080000000000 | |
| 抱歉，您提供的国家/地区代码或电话号码似乎无效。我们重新开始吧。请说出您所在国家/地区的名称或代码。 | |
| 1 | |
| 知道了，您的国家/地区代码是 +1。您的电话号码是多少？ | |
| 6502530000 | |
| 知道了。您提到的号码是 +1 6502530000，对吗？ | |
| 是的，正确 | |
| 太好了，我已收集完电话号码。 |
无法识别所输入的内容
在最终用户三次提供无法识别的输入后，组件会退出流程。
| 用户输入 | 智能体回答 |
|---|---|
| 您所在国家/地区的名称或代码是什么？ | |
| 没关系 | |
| 抱歉，我没听明白。您能再说一遍或重新输入国家/地区代码吗？ | |
| nice | |
| 抱歉，我还是没听明白。请确保您说出了国家/地区代码。如果我听不清您说的话，您也可以使用键盘输入国家/地区代码。 | |
| 好 | |
| 抱歉，我没听懂您的回答。 |
电话号码验证
手机号码预构建组件使用 IS_PHONE_NUMBER 系统函数来验证手机号码是否与有效格式匹配。
命名规则
此预构建组件使用以下命名惯例：
| 功能 | 格式 | 示例 |
|---|---|---|
| Flow | [Component Name] | 电话号码收集 |
| 组件特定 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 | 此参数会返回组件捕获的国家/地区代码 | 字符串 |
基本设置
如需设置此预构建组件，请执行以下操作：
完成
您的代理现在应该已设置完毕，可以进行测试了。