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

利用Twilio为未接听的掩码号码呼叫实现语音留言系统

花韻仙語
发布: 2025-12-08 23:28:16
原创
912人浏览过

利用twilio为未接听的掩码号码呼叫实现语音留言系统

本教程详细介绍了如何将语音留言系统集成到基于Twilio的掩码号码呼叫转接应用中。它涵盖了如何利用Twilio TwiML的Dial动词结合timeout属性来处理未接听的呼叫,以及如何使用Record动词让客户留言。文章还解释了如何配置录音回调,以进行语音留言的处理、存储和转录,确保用户通过电子邮件及时收到通知。

在构建基于Twilio的通信应用时,为用户提供掩码号码(Masked Number)服务,并实现呼叫转接是常见的需求。当客户拨打用户的掩码号码时,呼叫会被转接到用户的真实号码。然而,如果用户因忙碌、无法接听或无法联系到而错过呼叫,提供语音留言功能将极大地提升用户体验。本教程将指导您如何利用Twilio的TwiML动词(Dial和Record)来构建一个健壮的语音留言系统,包括未接听呼叫的检测、语音留言的录制、存储、转录以及通过电子邮件通知用户。

核心挑战与解决方案概述

挑战: 如何在呼叫转接失败(例如,用户未接听)时,自动引导客户进入语音留言流程,并对留言进行后续处理。

解决方案:

  1. 设置呼叫超时: 使用Dial动词的timeout属性,限制呼叫转接的振铃时间。
  2. 定义未接通回调: 利用Dial动词的action属性,在呼叫超时或未接通时,将控制权转交给另一个Webhook URL。
  3. 录制语音留言: 在上述action指向的Webhook中,使用Record动词引导客户留言。
  4. 处理录音结果: 配置Record动词的recordingStatusCallback属性,接收录音完成后的通知,进而进行存储、语音转文本(Speech-to-Text)处理,并通过邮件发送给用户。

1. 处理未接听的呼叫:Dial动词与超时设置

当客户呼叫掩码号码时,您的Twilio Webhook会接收到CallStatus为ringing的请求。在此阶段,您需要尝试将呼叫转接到用户的真实号码。为了在用户未接听时启动语音留言流程,我们需要在Dial动词中设置timeout和action属性。

timeout属性定义了Twilio尝试连接被叫方的时间(单位:秒)。如果在此时间内被叫方未接听,Twilio将停止拨号并向action属性指定的URL发送一个HTTP请求。

示例代码(webhook/voice端点修改):

假设您已有一个处理/webhook/voice的Express路由。我们需要修改其中CallStatus为ringing时的逻辑。

乾坤圈新媒体矩阵管家
乾坤圈新媒体矩阵管家

新媒体账号、门店矩阵智能管理系统

乾坤圈新媒体矩阵管家 219
查看详情 乾坤圈新媒体矩阵管家
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");

router.post("/webhook/voice", async (req, res) => {
  const { To, From, CallStatus } = req.body;

  // 假设getNumberWithoutUser函数能够根据掩码号码获取相关用户及设置
  const [numbers] = await getNumberWithoutUser(To);
  if (!numbers) {
    return res.status(400).send("User does not own this number");
  }

  const type = numbers.numbers.subscriptions.find(
    (subscription) => subscription.active
  ).type;
  const isToPrimaryPhone =
    numbers?.numbers?.settings?.forwarding?.toPrimaryPhone;
  const primaryPhoneNumber =
    numbers?.numbers?.settings?.forwarding?.primaryPhoneNumber;

  if (isToPrimaryPhone) {
    const twiml = new twilio.twiml.VoiceResponse();
    switch (CallStatus) {
      case "ringing":
        // 尝试拨打用户主号码,设置超时和未接通后的回调URL
        // 注意:action URL 必须是 Twilio 可访问的公共 URL (例如您的 ngrok 或生产环境域名)
        twiml.dial({
          timeout: 15, // 设置拨打超时时间,例如15秒
          action: `https://your-domain.com/webhook/voicemail?To=${To}&From=${From}`, // 超时或未接通后,Twilio会请求此URL
          method: 'POST'
        }, primaryPhoneNumber);

        // 更新呼叫转接配额
        await updateQuota(numbers._id, To, "callForwarding", type);
        res.type("text/xml");
        return res.send(twiml.toString());

      case "completed":
        // 正常通话完成,记录通话信息
        await appendCall(numbers._id, To, From, req.body);
        return res.send("success");

      // 您可能还需要处理其他 CallStatus,但 'action' URL 会处理 'no-answer', 'busy' 等情况
    }
  }
  // 如果呼叫转接未启用或套餐已过期
  res.send("Call Forwarding is disabled or package has finished");
});
登录后复制

说明:

  • timeout: 15:设置振铃15秒。如果用户在此时间内未接听,呼叫将转到action指定的URL。
  • action: https://your-domain.com/webhook/voicemail?To=${To}&From=${From}:这是关键。当拨号失败时,Twilio会向此URL发送一个POST请求。我们将To(掩码号码)和From(客户号码)作为查询参数传递,以便在后续的语音留言处理中使用。
  • 请务必将https://your-domain.com替换为您的实际公共域名或ngrok转发地址。

2. 实现语音留言录制:Record动词

当Dial动词因超时或其他原因失败时,Twilio会向action指定的/webhook/voicemail端点发送请求。在这个端点中,我们将使用Record动词来提示客户留言。

示例代码(/webhook/voicemail端点):

// ... (之前的导入和设置) ...

router.post("/webhook/voicemail", async (req, res) => {
  // 从查询参数中获取掩码号码 (To) 和客户号码 (From)
  const { To, From } = req.query;
  const twiml = new twilio.twiml.VoiceResponse();

  // 播放提示音,引导客户留言
  twiml.say({ voice: 'alice', language: 'zh-CN' }, "您拨打的用户暂时无法接听,请在'嘟'声后留言。留言结束后请按星号键。");
  twiml.record({
    recordingStatusCallback: `https://your-domain.com/webhook/recording-callback?To=${To}&From=${From}`, // 留言完成后,Twilio会请求此URL
    recordingStatusCallbackMethod: 'POST',
    maxLength: 60, // 最长录音60秒
    finishOnKey: '*' // 客户可以按星号键提前结束录音
  });
  twiml.say({ voice: 'alice', language: 'zh-CN' }, "感谢您的留言,再见。"); // 留言结束后播放感谢语

  res.type("text/xml");
  res.send(twiml.toString());
});
登录后复制

说明:

  • twiml.say():播放一段语音提示,告知客户当前情况并引导留言。您可以自定义语音内容、语言和声音。
  • twiml.record():这是录制语音留言的核心。
    • recordingStatusCallback: 录音完成后,Twilio会将录音文件URL及其他相关信息POST到此URL。同样,我们将To和From作为查询参数传递。
    • maxLength: 设置录音的最大时长,防止录音过长。
    • finishOnKey: 允许客户通过按特定按键(例如*星号键)提前结束录音。

3. 语音留言的后续处理:存储、转录与通知

当客户完成留言后,Twilio会向recordingStatusCallback指定的/webhook/recording-callback端点发送一个POST请求。这个请求包含了录音文件的URL以及其他有用的信息。

示例代码(/webhook/recording-callback端点):

// ... (之前的导入和设置) ...
// const { getNumberWithoutUser, sendMessageNotificationEmail } = require("../db/dbOperations");
// const { appendMessage } = require("../db/messagingCollectionUtils"); // 用于存储留言信息
// const { client } = require("../twilioFunctions"); // 如果需要调用Twilio REST API进行转录

router.post("/webhook/recording-callback", async (req, res) => {
  const { To, From } = req.query; // 掩码号码 (To) 和客户号码 (From)
  const { RecordingUrl, RecordingDuration, CallSid, TranscriptionText, TranscriptionSid } = req.body; // Twilio发送的录音详情

  // 假设getNumberWithoutUser函数能够根据掩码号码获取相关用户
  const [numbers] = await getNumberWithoutUser(To);
  if (!numbers) {
    console.error(`User for masked number ${To} not found.`);
    return res.status(404).send("User not found");
  }

  try {
    // 1. 存储录音信息到数据库
    // 您可以将 RecordingUrl、RecordingDuration、From、To 等信息存储到数据库中
    await appendMessage(numbers._id, To, From, {
      type: 'voicemail',
登录后复制

以上就是利用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号