设置 Phone AI 接听来电
连接一个 Twilio 号码,测试 Webhook,然后启用 Phone AI。通常约需 10 分钟。
本指南帮助你使用 AVA 接听酒店来电,并查看每次通话的文字记录。
前往: Settings → Communications → Phone AI
快速参考
| 设置 | 功能 | 显示内容 |
|---|---|---|
| Twilio Account SID | 选择 Twilio 帐户 | 以 AC 开头的标识符 |
| Twilio phone number | 接收宾客来电 | 带 + 和国家代码的号码 |
| Twilio Auth Token | 授权 AVA 验证并处理来电 | 保存后不再显示的受保护密钥 |
| Purpose | 为号码添加可选备注 | 设置页上的说明 |
| Incoming-call webhook | 将 Twilio 来电转至 AVA | 可复制的 URL 和 Test webhook 操作 |
| Phone AI 开关 | 启用或暂停 AI 来电处理 | Active 或 Not active |
| Call Activity | 列出通话及其状态 | 来电号码、开始时间、状态和文字记录 |
开始之前
- 你拥有 Settings write 权限
- 你有一个专用 Twilio 电话号码
- 你有 Twilio Account SID 和 Auth Token
- 电话号码采用国际格式
请像保护密码一样保护 Twilio Auth Token。 AVA 会在保存后保护它,并且不再显示。
保存 Twilio 连接
-
留在 Setup 标签页。
-
输入 Twilio Account SID。
-
输入带
+和国家代码的 Twilio phone number。 -
输入 Twilio Auth Token。
-
添加可选的 Purpose。
-
选择 Save settings。
✓ 页面显示“Phone AI settings saved.” ✓ Auth Token 字段变为受保护的占位内容。
将 Auth Token 留空可保留已保存的 Token。 仅在需要更换时输入新 Token。
从 Twilio 转接来电
-
在 Setup 中找到 Incoming-call webhook。
-
选择 Copy。
-
打开 Twilio Console。
-
打开 Phone Numbers,然后选择酒店号码。
-
在 Voice configuration 中,将 A call comes in 设为 Webhook。
-
粘贴复制的 URL。
-
选择 POST,然后保存 Twilio 配置。
✓ Twilio 会将来电发送至 AVA Webhook。
测试并启用 Phone AI
-
返回 Settings → Communications → Phone AI。
-
保存所有未保存的更改。
-
选择 Test webhook。
-
确认成功消息。
-
开启 Enable Phone AI。
-
选择 Save settings。
-
使用另一部电话拨打 Twilio 号码。
✓ Phone AI 接听来电。 ✓ 通话显示在 Call Activity 中。
启用前必须保存 Account SID、电话号码和 Auth Token。 存在未保存的更改时,Webhook 测试也会停用。
查看通话活动
-
打开 Call Activity。
-
按来电号码和开始时间查找通话。
-
查看通话状态。
-
选择 View transcript。
-
查看完成后关闭文字记录。
✓ 你可以查看该通话中的宾客和助手消息。
故障排除
电话号码被拒绝
你看到: “Enter the Twilio phone number in E.164 format, including + and country code.”
解决方法:
- 以
+开始号码。 - 添加国家代码。
- 删除空格、括号和连字符。
- 再次选择 Save settings。
Webhook 测试已停用
你看到: 无法选择 Test webhook。
解决方法:
- 填写 Account SID、电话号码和 Auth Token。
- 选择 Save settings。
- 等待保存确认。
- 再次选择 Test webhook。
Webhook 测试失败
你看到: “Unable to verify the Twilio webhook configuration.”
解决方法:
- 再次复制当前 Incoming-call webhook。
- 确认 Twilio 的 A call comes in 使用该 URL。
- 确认方法为 POST。
- 在 Twilio 中保存,然后在 AVA 中重新测试。
无法启用 Phone AI
你看到: Enable Phone AI 开关保持停用状态。
解决方法:
- 确认你拥有 Settings write 权限。
- 保存所有必填 Twilio 设置。
- 确认电话号码包含
+和国家代码。 - 刷新页面并重试。
无法打开文字记录
你看到: “Unable to load this transcript.”
解决方法:
- 关闭文字记录面板。
- 刷新 Call Activity。
- 再次打开该通话。
- 如果其他记录也失败,请联系支持团队。
仍需帮助?
以下情况请联系 success@vouch-technologies.com:
- ❌ 已保存的 Webhook 持续测试失败
- ❌ 通话未显示在 Call Activity 中
- ❌ 启用后 Phone AI 未接听来电
建议提供:
- 未显示密钥的设置状态截图
- Twilio 电话号码
- 一次测试通话的时间
- 完整错误消息