首页 > web前端 > js教程 > 正文

Twilio匿名呼叫转接:未接来电自动转语音留言实现指南

php中文网
发布: 2025-12-07 23:52:02
原创
205人浏览过

twilio匿名呼叫转接:未接来电自动转语音留言实现指南

本教程详细指导如何利用Twilio构建一个匿名电话呼叫转接系统,并实现未接来电自动转语音留言功能。当客户拨打匿名号码,呼叫被转接至用户真实号码后,若用户未接听,系统将引导客户录制语音留言。文章将涵盖Twilio TwiML的Dial动词超时配置、Record动词的使用,以及如何处理录音回调、存储留言并进行语音转文本处理及邮件通知。

1. 引言

在构建基于Twilio的通信应用时,实现匿名呼叫转接是常见的需求。例如,当客户拨打一个由平台提供的匿名号码时,该呼叫会被转接到用户真实的手机号码。然而,如果用户因各种原因(如忙线、未接听、无法接通)未能接听电话,如何确保客户能够留下重要的信息?本教程将详细介绍如何利用Twilio的TwiML(Twilio Markup Language)功能,为未接来电自动启用语音留言系统,并将留言内容(包括语音文件和转录文本)通过邮件发送给用户。

2. 理解Twilio TwiML与呼叫流程

Twilio TwiML是一种XML方言,用于指示Twilio如何处理呼叫和短信。通过在您的服务器上响应Twilio Webhook请求时返回TwiML指令,您可以完全控制呼叫流程。

实现匿名呼叫转接和语音留言的理想流程如下:

Animate AI
Animate AI

Animate AI是个一站式AI动画故事视频生成工具

Animate AI 234
查看详情 Animate AI
  1. 客户拨打匿名号码: 客户拨打由Twilio分配给用户的匿名号码。
  2. Twilio发送Webhook请求: Twilio向您预先配置的Webhook URL发送HTTP请求,告知有新的来电。
  3. 应用处理请求: 您的应用程序接收请求,识别匿名号码对应的用户及其真实号码。
  4. 呼叫转接: 应用程序生成包含Dial(拨号)动词的TwiML响应,尝试将呼叫转接到用户的真实号码。
  5. 超时或未接听处理: 如果用户在预设时间内未接听,或者电话忙线/无法接通,Dial动词将超时。
  6. 语音留言引导: 应用程序在Dial动词之后,通过Say(说话)和Record(录音)动词引导客户录制语音留言。
  7. 录音完成回调: 客户完成录音后,Twilio将录音文件存储起来,并向您配置的recordingStatusCallback URL发送另一个Webhook请求。
  8. 存储与通知: 您的应用程序接收录音回调,将录音信息(如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
登录后复制

以上就是Twilio匿名呼叫转接:未接来电自动转语音留言实现指南的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号