
本教程详细指导如何利用Twilio构建一个匿名电话呼叫转接系统,并实现未接来电自动转语音留言功能。当客户拨打匿名号码,呼叫被转接至用户真实号码后,若用户未接听,系统将引导客户录制语音留言。文章将涵盖Twilio TwiML的Dial动词超时配置、Record动词的使用,以及如何处理录音回调、存储留言并进行语音转文本处理及邮件通知。
在构建基于Twilio的通信应用时,实现匿名呼叫转接是常见的需求。例如,当客户拨打一个由平台提供的匿名号码时,该呼叫会被转接到用户真实的手机号码。然而,如果用户因各种原因(如忙线、未接听、无法接通)未能接听电话,如何确保客户能够留下重要的信息?本教程将详细介绍如何利用Twilio的TwiML(Twilio Markup Language)功能,为未接来电自动启用语音留言系统,并将留言内容(包括语音文件和转录文本)通过邮件发送给用户。
Twilio TwiML是一种XML方言,用于指示Twilio如何处理呼叫和短信。通过在您的服务器上响应Twilio Webhook请求时返回TwiML指令,您可以完全控制呼叫流程。
实现匿名呼叫转接和语音留言的理想流程如下:
我们将基于一个现有的Node.js Express应用示例进行修改,重点关注webhook/voice端点和新增的webhook/voicemail-callback端点。
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以上就是Twilio匿名呼叫转接:未接来电自动转语音留言实现指南的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号