本教程详细指导如何利用Twilio构建一个匿名电话呼叫转接系统，并实现未接来电自动转语音留言功能。当客户拨打匿名号码，呼叫被转接至用户真实号码后，若用户未接听，系统将引导客户录制语音留言。文章将涵盖Twilio TwiML的Dial动词超时配置、Record动词的使用，以及如何处理录音回调、存储留言并进行语音转文本处理及邮件通知。
1. 引言
在构建基于Twilio的通信应用时，实现匿名呼叫转接是常见的需求。例如，当客户拨打一个由平台提供的匿名号码时，该呼叫会被转接到用户真实的手机号码。然而，如果用户因各种原因（如忙线、未接听、无法接通）未能接听电话，如何确保客户能够留下重要的信息？本教程将详细介绍如何利用Twilio的TwiML（Twilio Markup Language）功能，为未接来电自动启用语音留言系统，并将留言内容（包括语音文件和转录文本）通过邮件发送给用户。
2. 理解Twilio TwiML与呼叫流程
Twilio TwiML是一种XML方言，用于指示Twilio如何处理呼叫和短信。通过在您的服务器上响应Twilio Webhook请求时返回TwiML指令，您可以完全控制呼叫流程。
实现匿名呼叫转接和语音留言的理想流程如下：
- 客户拨打匿名号码： 客户拨打由Twilio分配给用户的匿名号码。
- Twilio发送Webhook请求： Twilio向您预先配置的Webhook URL发送HTTP请求，告知有新的来电。
- 应用处理请求： 您的应用程序接收请求，识别匿名号码对应的用户及其真实号码。
- 呼叫转接： 应用程序生成包含Dial（拨号）动词的TwiML响应，尝试将呼叫转接到用户的真实号码。
- 超时或未接听处理： 如果用户在预设时间内未接听，或者电话忙线/无法接通，Dial动词将超时。
- 语音留言引导： 应用程序在Dial动词之后，通过Say（说话）和Record（录音）动词引导客户录制语音留言。
- 录音完成回调： 客户完成录音后，Twilio将录音文件存储起来，并向您配置的recordingStatusCallback URL发送另一个Webhook请求。
- 存储与通知： 您的应用程序接收录音回调，将录音信息（如URL）存储到数据库，并利用Twilio的语音转文本API（或已转录文本）通过邮件通知用户。
3. 实现呼叫转接与语音留言逻辑
我们将基于一个现有的Node.js Express应用示例进行修改，重点关注webhook/voice端点和新增的webhook/voicemail-callback端点。
3.1 配置呼叫转接与超时处理
Dial动词是Twilio TwiML中用于将当前呼叫连接到另一个号码的关键。其timeout属性允许您指定Twilio在放弃尝试连接被叫方之前等待的最大秒数。关键在于，如果Dial动词在未指定action属性的情况下超时或失败，Twilio会继续执行其TwiML响应中的下一个指令。这正是我们实现语音留言的入口点。
示例代码：修改 /webhook/voice 端点
const twilio = require("twilio");
const express = require("express");
const router = express.Router();
// 假设这些是您的数据库操作和邮件发送函数
// const { getNumberWithoutUser, updateQuota } = require("../db/dbOperations");
// const { sendMessageNotificationEmail } = require("../emailing/email");
// const { appendCall } = require("../db/callsCollectionUtils");
// 模拟数据库操作和邮件发送函数
async function getNumberWithoutUser(maskedNumber) {
// 模拟从数据库获取号码信息
if (maskedNumber === "+1234567890") { // 假设这是匿名号码
return [{
_id: "user123",
numbers: {
subscriptions: [{ active: true, type: "premium" }],
settings: {
forwarding: { toPrimaryPhone: true, primaryPhoneNumber: "+1987654321" }, // 真实号码
emailForVoicemail: "user@example.com" // 接收语音留言的邮箱
}
}
}];
}
return [null];
}
async function updateQuota(userId, maskedNumber, type, subscriptionType) {
console.log(`Updating quota for user ${userId} for masked number ${maskedNumber}, type: ${type}, subscription: ${subscriptionType}`);
// 实际的配额更新逻辑
}
async function appendCall(userId, to, from, callDetails) {
console.log(`Appending call record for user ${userId}: From ${from} to ${to}`);
// 实际的通话记录存储逻辑
}
async function sendMessageNotificationEmail(toEmail, subject, body) {
console.log(`Sending email to ${toEmail} with subject: "${subject}"`);
// 实际的邮件发送逻辑
}
router.post("/webhook/voice", async (req, res) => {
const { To, From, CallStatus } = req.body;
console.log(`Incoming call status: ${CallStatus}, From: ${From}, To: ${To}`);
const [numbers] = await getNumberWithoutUser(To);
if (!numbers) {
console.warn(`User does not own this number: ${To}`);
return res.status(400).send("User does not own this number");
}
const isToPrimaryPhone = numbers?.numbers?.settings?.forwarding?.toPrimaryPhone;
const primaryPhoneNumber = numbers?.numbers?.settings?.forwarding?.primaryPhoneNumber;
if (isToPrimaryPhone && primaryPhoneNumber) {
const twiml = new twilio.twiml.VoiceResponse();
if (CallStatus === "ringing") {
// 播放欢迎语（可选），使用中文女声
twiml.say({ voice: 'woman', language: 'zh-CN' }, "您好，正在为您转接，请稍候。");
// 尝试拨打用户真实号码，设置7 
