电话功能：一键拨号与通话录音（Twilio Voice）

一键呼叫联系人和潜在客户，并使用已配置好用于短信/WhatsApp 的同一个 Twilio 账户（BYO 模式）录制通话。

电话功能使用的是您已经为“消息（短信/WhatsApp）”配置好的同一个 Twilio 账户，遵循 BYO 模式（“自带账户”）。通话在您的 Twilio 账户中拨打并计费：我们这边不产生任何费用、加价或中间环节。您只需要一个已启用语音（VOICE）功能的 Twilio 号码。

该功能处于未启用状态：在 Twilio 集成配置完成、被激活，并填写了语音号码之前，不会发生任何操作。

前提条件

• Twilio 集成（短信/WhatsApp）已配置并激活，使用相同的账户（Account SID + Auth Token）。
• 一个已启用语音（VOICE）功能的 Twilio 号码，采用 E.164 格式，用作来电显示号码。
• 一个坐席电话，用于接听通话的呼入环节（每个用户在拨打电话时都可以输入自己的号码）。
• 在 Sellio 中拥有管理员权限，以便在 Twilio 卡片上填写语音号码。

一键拨号（桥接）的工作原理

我们不使用浏览器内置电话（WebRTC）。整个流程完全在服务器端完成：当您点击“呼叫”时，Twilio 会先呼叫您自己的电话（坐席号码）。当您接听后，Twilio 会将通话连接（桥接）到联系人的号码，并开始录音。通话结束后，通话时长和录音链接会被自动记录。

需要配置的内容

• 已配置好的 Twilio 集成（Account SID + Auth Token），与“消息”功能使用同一个。
• 语音号码（来电显示）：一个已启用语音（VOICE）功能的 Twilio 号码，采用 E.164 格式（例如 +15005550006）。它是通话中显示的标识号码。
• 坐席电话（可选）：一个默认的、会先响铃的号码。每个用户在拨打电话时也可以输入自己的电话号码（会记录在其浏览器中）。

如何配置

1. 打开 Settings → Integrations，找到“短信/WhatsApp 消息（Twilio）”卡片。
2. 填写“语音号码（来电显示）”，如需要也可填写“坐席电话（默认）”。重新输入 Auth Token，然后点击“保存凭据”。
3. TwiML 以及状态/录音 URL 会由一键拨号功能本身自动设置，因此您不需要在 Twilio 控制台中手动配置它们。
4. 确认 Twilio 集成处于“已激活”状态。

如何拨打电话

1. 打开一个填有电话（电话或手机字段）的联系人或潜在客户。
2. 在“电话（通话）”面板中，点击“呼叫”。
3. 核对联系人的号码，如果尚未记住，请输入您自己的电话（坐席），然后点击“立即呼叫”。
4. 当您的电话响铃时接听：Twilio 会将您与联系人连接，并开始录音。
5. 该通话会以状态显示在历史记录中；完成后会显示通话时长和“收听录音”链接。该活动同时也会进入记录的时间线。

CRM 会使用您的 Auth Token 校验状态和录音 webhook 中的 X-Twilio-Signature。录音托管在您的 Twilio 账户中；该链接会打开音频文件（.mp3）。请将 Auth Token 视为机密信息：它会被加密存储，且永远不会再显示出来。

如何测试

1. 打开一个填有电话的联系人/潜在客户，在“电话（通话）”面板中点击“呼叫”。
2. 输入您自己的电话（坐席），然后点击“立即呼叫”。
3. 当您的电话响铃时接听：Twilio 会将您与联系人连接，并开始录音。
4. 挂断后，确认该通话出现在历史记录中，且带有通话时长和“收听录音”链接。

故障排查

• “呼叫”按钮提示缺少配置：Twilio 未激活，或未填写“语音号码（来电显示）”。请在 Twilio 卡片上补全相关信息。
• 出现 401 / 通话无法开始：Account SID/Auth Token 错误。保存语音号码时请重新输入 Auth Token。
• 我的电话不响铃：检查坐席号码是否为 E.164 格式，以及该 Twilio 语音号码是否可以向您所在国家/地区发起呼叫（Twilio 控制台中的 Geo Permissions）。
• 结束时没有录音或没有时长：状态/录音 webhook 由一键拨号功能自动设置。如果失败，请检查 Auth Token 是否正确（X-Twilio-Signature 会用它来校验）。
• 我不需要在 Twilio 中配置 URL：正确。TwiML 以及状态/录音 URL 由流程本身定义；请勿为语音功能在号码上手动配置 webhook。

在系统内打开这篇文章 →