基于Twilio实现来电筛选、语音留言与录音邮件发送教程

碧海醫心
发布: 2025-11-28 09:20:25
原创
135人浏览过

基于Twilio实现来电筛选、语音留言与录音邮件发送教程

本教程详细介绍了如何利用twilio、php和twiml构建一个完整的来电处理系统,实现来电筛选、自动转接语音留言,并将录制好的语音留言链接通过电子邮件发送给指定收件人。文章涵盖了呼叫流程设计、twiml配置、php逻辑实现以及语音留言邮件通知的关键步骤,旨在帮助开发者高效管理twilio来电。

在现代业务通信中,高效处理来电至关重要。Twilio提供强大的可编程通信能力,结合自定义的PHP和TwiML脚本,可以实现复杂的来电处理逻辑,例如来电筛选、自动转接语音留言,并将留言录音通过电子邮件发送给相关人员。本教程将详细阐述如何构建这样一个系统。

1. Twilio来电处理流程概述

一个典型的Twilio来电处理流程涉及多个步骤和组件,通常包括:

  1. 客户呼入:来电抵达Twilio号码。
  2. Webhook触发:Twilio将呼叫事件发送到预配置的Webhook URL。
  3. TwiML指令:Webhook返回TwiML(Twilio Markup Language)指令,指导Twilio如何处理呼叫。
  4. 业务逻辑处理:TwiML可能通过Redirect或Dial等指令将呼叫转接到PHP脚本,由PHP脚本执行更复杂的业务逻辑。
  5. 来电筛选:在将呼叫连接到业务负责人之前,播放提示音并等待输入,以决定接听或拒绝。
  6. 语音留言:如果呼叫被拒绝或无人接听,则转入语音留言系统。
  7. 录音处理与通知:录制语音留言,并将录音链接发送至指定邮箱

2. 核心组件与TwiML配置

本系统主要由一系列PHP脚本和TwiML XML文件构成,共同协作完成呼叫处理。

2.1 入口点与重定向

当客户拨打Twilio号码时,Twilio会向预设的Webhook URL发送请求。此URL通常指向一个XML文件或PHP脚本。

Handle-Incoming-Call.XML: 这是Twilio号码的初始Webhook目标。它简单地将控制权重定向到handle-extension.php。

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Redirect>handle-extension.php</Redirect>
</Response>
登录后复制

handle-extension.php: 此脚本负责播放欢迎语并尝试拨号连接到业务负责人。

<?php
    header('Content-type: text/xml');
    echo '<?xml version="1.0" encoding="UTF-8"?>';
    echo '<Response>';
    echo '<Say>感谢您的来电,欢迎致电我的公司。</Say>';
    // 尝试拨号,并启用录音。如果未接听,则转到 voicemail.php
    echo '<Dial record="true" timeout="15" action="voicemail.php">';
    // 拨号到业务负责人,并指定 screen-caller.xml 进行筛选
    echo '<Number url="screen-caller.xml">+10000000000</Number>'; 
    echo '</Dial>';
    echo '</Response>';
?>
登录后复制
  • <Say>:播放一段欢迎语。
  • <Dial>:尝试拨号连接到目标号码(+10000000000)。
    • record="true":开启呼叫录音。
    • timeout="15":设置拨号超时时间为15秒。
    • action="voicemail.php":如果拨号未接听或超时,Twilio将向voicemail.php发送请求,处理语音留言。
  • <Number url="screen-caller.xml">:在连接到目标号码之前,Twilio会向screen-caller.xml发送请求,由其返回TwiML指令进行呼叫筛选。

2.2 来电筛选与业务逻辑

在handle-extension.php中,通过url="screen-caller.xml"属性,我们引入了来电筛选机制。

screen-caller.xml: 当业务负责人接听电话时,Twilio会向此XML文件发送请求,播放筛选提示音。

uBrand Logo生成器
uBrand Logo生成器

uBrand Logo生成器是一款强大的AI智能LOGO设计工具。

uBrand Logo生成器 124
查看详情 uBrand Logo生成器
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Gather action="handle-screen-input.php" numDigits="1">
        <Say>有新的来电,请注意。</Say>
        <Say>要接听电话,请按 1。</Say>
        <Say>要拒绝电话,请按 2。</Say>
    </Gather>
</Response>
登录后复制
  • <Gather>:收集用户的数字输入。
    • action="handle-screen-input.php":用户输入后,Twilio将向此PHP脚本发送请求,并传递输入的数字。
    • numDigits="1":收集一个数字。
  • <Say>:播放提示音,引导业务负责人选择操作。

handle-screen-input.php: 根据业务负责人的输入,决定是接听电话还是挂断。

<?php
    header('Content-type: text/xml');
    echo '<?xml version="1.0" encoding="UTF-8"?>';
    echo '<Response>';
    $user_pushed = (int) $_REQUEST['Digits']; // 获取用户按下的数字
    if ($user_pushed == 1) {
        echo '<Say>正在连接,请说“您好”。</Say>';
        // 如果返回 <Say> 之后没有其他 TwiML,Twilio 会将呼叫连接到 <Dial> 中指定的号码。
    } else {
        echo '<Hangup />'; // 如果按下 2,则挂断电话。
    }
    echo '</Response>';
?>
登录后复制
  • 如果业务负责人按下 1,handle-screen-input.php会返回一个 <Say> 指令,然后Twilio将呼叫连接到handle-extension.php中<Dial>指定的号码。
  • 如果业务负责人按下 2,handle-screen-input.php会返回一个 <Hangup /> 指令,Twilio将直接挂断当前呼叫。此时,由于原始的<Dial>指令中设置了action="voicemail.php",Twilio会将控制权转交给voicemail.php来处理语音留言。

3. 实现语音留言功能

当呼叫未被接听(超时)或被拒绝(handle-screen-input.php返回<Hangup />)时,Twilio会根据handle-extension.php中<Dial>的action属性,将控制权交给voicemail.php。

voicemail.php: 此脚本负责播放语音留言提示,并录制留言。

<?php
    header('content-type: text/xml');
    echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
    // 可以选择记录传入请求的日志,用于调试
    // file_put_contents('incoming_voicemail.log', "\n" .json_encode($_REQUEST) . "\n", FILE_APPEND);
?>
<Response>
  <Say voice="alice">您拨打的电话暂时无人接听,请在“嘟”声后留言。
  </Say>
  <Record action="mail.php"></Record>
</Response>
登录后复制
  • <Say>:播放提示音,告知来电者可以留言。
  • <Record>:开始录制语音留言。
    • action="mail.php":这是关键!当录音完成后,Twilio会将录音的URL和其他相关信息POST到mail.php脚本,由其进行后续处理(例如发送邮件)。

4. 语音留言录音的邮件通知

为了将录制的语音留言发送到指定邮箱,我们需要创建一个mail.php脚本来接收Twilio的录音完成通知,并构建邮件内容。

mail.php: 接收Twilio的录音完成Webhook,并发送包含录音链接的邮件。

<?php
    // 设置响应头,尽管Twilio通常不处理这个脚本的响应,但良好的实践是返回一个空的 <Response>
    header('content-type: text/xml');
    echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
    echo "<Response></Response>"; // 返回空响应,告知Twilio已处理

    // 获取Twilio发送的录音URL
    $recordingUrl = $_REQUEST['RecordingUrl'] ?? null;
    $callSid = $_REQUEST['CallSid'] ?? 'N/A';
    $fromNumber = $_REQUEST['From'] ?? 'N/A';

    if ($recordingUrl) {
        $to = "your_email@example.com"; // 替换为你的收件邮箱
        $subject = "新的Twilio语音留言 - 来自 {$fromNumber}";
        $message = "您收到了一条新的语音留言。\n\n";
        $message .= "呼叫ID: {$callSid}\n";
        $message .= "来电号码: {$fromNumber}\n";
        $message .= "录音链接: {$recordingUrl}.mp3\n\n"; // Twilio录音URL通常支持.mp3后缀直接播放
        $message .= "请点击链接收听留言。";

        $headers = "From: Twilio Voicemail <no-reply@yourdomain.com>\r\n"; // 替换为你的发件邮箱
        $headers .= "Reply-To: no-reply@yourdomain.com\r\n";
        $headers .= "MIME-Version: 1.0\r\n";
        $headers .= "Content-type: text/plain; charset=UTF-8\r\n";

        // 使用PHP内置的 mail() 函数发送邮件
        // 注意:在生产环境中,强烈建议使用专业的邮件发送库(如PHPMailer)或邮件服务(如SendGrid, Mailgun)
        // 以确保邮件的可靠投递和安全性。
        $mailSent = mail($to, $subject, $message, $headers);

        if ($mailSent) {
            // 邮件发送成功日志(可选)
            // error_log("Voicemail email sent successfully for CallSid: {$callSid}");
        } else {
            // 邮件发送失败日志(可选)
            // error_log("Failed to send voicemail email for CallSid: {$callSid}");
        }
    } else {
        // 录音URL缺失日志(可选)
        // error_log("RecordingUrl not found in Twilio webhook for CallSid: {$callSid}");
    }
?>
登录后复制
  • $_REQUEST['RecordingUrl']: 这是Twilio在录音完成后POST给action URL的最重要参数,它包含了录音文件的URL。
  • 邮件发送逻辑: 脚本构建邮件的主题、内容和头部,然后使用PHP的mail()函数发送邮件。
  • 注意事项:
    • 请将your_email@example.com和no-reply@yourdomain.com替换为实际的邮箱地址。
    • PHP的mail()函数在某些服务器环境下可能配置不当或被禁用,且功能相对基础。在生产环境中,强烈建议使用更健壮的邮件发送解决方案,例如:
      • PHPMailer:一个功能强大的PHP邮件发送库,支持SMTP、HTML邮件、附件等。
      • SendGrid, Mailgun, Amazon SES:专业的第三方邮件发送服务,提供更高的送达率、统计和API集成。

5. 注意事项与最佳实践

  1. 安全性:
    • Webhook验证: Twilio发送的Webhook请求可以被验证,以确保请求确实来自Twilio,防止伪造请求。可以使用Twilio的PHP SDK来验证请求签名。
    • 敏感信息: 避免在代码中硬编码敏感信息(如API密钥、邮箱密码),应使用环境变量配置文件进行管理。
  2. 错误处理与日志:
    • 在每个PHP脚本中加入错误日志记录,特别是在关键操作(如邮件发送)失败时,以便于调试和问题排查。
    • Twilio控制台提供了详细的呼叫日志和错误信息,是调试TwiML和Webhook问题的宝贵工具
  3. 可扩展性:
    • 随着业务增长,可能需要更复杂的路由逻辑。考虑将TwiML生成逻辑从简单的echo语句抽象到模板引擎或更结构化的PHP类中。
  4. 邮件发送服务:
    • 对于生产环境,务必选择可靠的邮件发送服务或库。PHP内置的mail()函数在可靠性和功能性方面可能无法满足生产需求。

总结

通过上述步骤,我们成功构建了一个基于Twilio、PHP和TwiML的来电处理系统。该系统能够实现来电筛选,根据业务负责人的选择决定接听或拒绝,并在拒绝或无人接听时自动转入语音留言,最终将录制的语音留言链接通过电子邮件发送给指定收件人。这不仅提升了来电处理的效率,也确保了重要语音留言的及时通知。开发者可以根据自身需求,在此基础上进一步扩展功能,例如集成CRM系统、定制语音留言流程等。

以上就是基于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号