Twilio来电管理:实现自定义语音邮件并自动发送录音到邮箱的教程

聖光之護
发布: 2025-11-29 12:06:28
原创
879人浏览过

Twilio来电管理:实现自定义语音邮件并自动发送录音到邮箱的教程

本教程详细介绍了如何利用twilio的twiml和php脚本,构建一个功能完善的来电处理系统。该系统实现了来电自动欢迎、业务号码筛选接听、以及在无法接通或拒绝时将来电转接到语音邮件。更进一步,教程重点讲解了如何配置语音邮件系统,使其在录音完成后,自动将语音邮件的录音链接发送到指定的邮箱,从而实现高效的来电管理和信息同步。

引言:Twilio 呼叫流程概述

Twilio作为一个强大的通信平台,允许开发者通过TwiML(Twilio Markup Language)和Webhook来控制电话呼叫的流程。TwiML是一种XML方言,用于指示Twilio在呼叫期间执行何种操作,例如播放语音、收集用户输入、拨号或录音。当Twilio收到一个来电时,它会向预设的Webhook URL发送一个HTTP请求,然后根据该URL返回的TwiML指令来执行相应的操作。

本教程将引导您构建一个实用的Twilio来电处理系统,它不仅能实现基本的来电欢迎和业务筛选功能,还能在业务员无法接听或主动拒绝来电时,将来电转接到语音邮件,并最终将录制好的语音邮件文件链接通过电子邮件发送给您,确保您不会错过任何重要留言。

一、基础呼叫流程与来电筛选

首先,我们来搭建核心的呼叫处理和筛选逻辑。这个流程涉及多个PHP和XML文件,它们共同协作来管理来电。

1.1 来电入口:Handle-Incoming-Call.XML

当客户拨打您的Twilio号码时,Twilio会将请求发送到您在控制台配置的Webhook URL。这个XML文件是整个呼叫流程的起点,它简单地将控制权重定向到一个PHP脚本。

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

解释: <Redirect>动词指示Twilio将当前的呼叫流程重定向到handle-extension.php脚本。这意味着所有后续的TwiML指令将由handle-extension.php生成。

1.2 呼叫拨号与筛选设置:Handle-Extension.PHP

这个PHP脚本负责播放欢迎语,并尝试将呼叫连接到您的业务号码。同时,它集成了呼叫筛选功能,确保您在接听前了解来电意图。

<?php
    header('Content-type: text/xml');
    echo '<?xml version="1.0" encoding="UTF-8"?>';

    echo '<Response>';

    echo '<Say voice="alice">感谢您的来电,我的公司。</Say>';
    echo '<Dial record="true" timeout="15" action="voicemail.php">';
    echo '<Number url="screen-caller.xml">+10000000000</Number>'; // 替换为您的业务电话号码
    echo '</Dial>';

    echo '</Response>';
?>
登录后复制

解释:

  • <Say>:播放一段欢迎语。我们使用了voice="alice"来指定一个声音。
  • <Dial>:尝试将当前呼叫连接到另一个号码。
    • record="true":指示Twilio在整个拨号尝试过程中录音。
    • timeout="15":如果在15秒内没有接听,则拨号超时。
    • action="voicemail.php":这是一个关键属性。如果拨号失败(例如,无人接听、超时、占线),Twilio会将控制权交给voicemail.php。
  • <Number url="screen-caller.xml">:尝试拨打您的业务号码。url="screen-caller.xml"属性使得在您接听电话时,Twilio会先向screen-caller.xml发送请求,获取TwiML指令进行呼叫筛选,而不是直接连接。

1.3 业务端筛选交互:Screen-Caller.XML

当您(业务员)接听电话时,Twilio不会直接连接客户,而是先执行screen-caller.xml中的指令,向您播放一段筛选提示语,并等待您的输入。

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Gather action="handle-screen-input.php" numDigits="1">
        <Say voice="alice">有客户来电。</Say>
        <Say voice="alice">按1接受来电。</Say>
        <Say voice="alice">按2拒绝来电。</Say>
    </Gather>
</Response>
登录后复制

解释:

  • <Gather>:收集用户(这里是业务员)的按键输入。
    • action="handle-screen-input.php":当用户输入完成后,Twilio会将收集到的数字发送到handle-screen-input.php进行处理。
    • numDigits="1":表示只收集一个数字输入。

1.4 处理筛选结果: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 voice="alice">正在连接,请说你好。</Say>';
        // 如果业务员按1,TwiML响应结束,Twilio会默认将呼叫连接到客户。
        // 因为这是在Dial verb的url中执行的,返回空响应或Say后,Dial会继续连接。
    }
    else {
        // 如果业务员按2(拒绝),则将呼叫重定向到语音邮件流程。
        echo '<Redirect>voicemail.php</Redirect>';
    }

    echo '</Response>';
?>
登录后复制

解释:

  • $_REQUEST['Digits']:Twilio会将业务员按下的数字作为Digits参数发送到此脚本。
  • 如果$user_pushed == 1:播放连接提示语。由于此脚本是在<Dial>的url中被调用,当TwiML响应结束后,<Dial>会继续执行,从而将业务员与客户连接起来。
  • 如果$user_pushed == 2:使用<Redirect>将呼叫流程转移到voicemail.php,这意味着客户将被引导去留言。

二、集成语音邮件功能

当业务员拒绝来电,或者业务号码因超时、占线等原因未能接通时,呼叫将进入语音邮件流程。

Magic Write
Magic Write

Canva旗下AI文案生成器

Magic Write 75
查看详情 Magic Write

2.1 语音邮件录制:voicemail.php

这个脚本负责播放语音邮件提示语,并录制来电者的留言。为了实现录音后的邮件通知,我们需要对其进行关键修改。

<?php
    header('content-type: text/xml');
    echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";

    // 可选:记录Twilio发送的请求参数,用于调试
    // 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>:指示Twilio开始录制来电者的语音留言。
    • action="mail.php":这是实现邮件通知的关键! 当录音完成时,Twilio会将录音文件的相关信息(包括RecordingUrl)作为一个HTTP POST请求发送到mail.php这个URL。这与recordingStatusCallback不同,action在录音结束后立即触发,而recordingStatusCallback是异步触发。对于直接处理录音链接并发送邮件的场景,action更直接。

三、实现语音邮件录音的邮件通知

最后一步是创建mail.php脚本,它将接收Twilio发送的录音信息,并将其通过电子邮件发送给您。

3.1 创建邮件发送脚本:mail.php

<?php
    // 设置响应头,尽管这个脚本主要用于发送邮件,但返回有效的TwiML是好习惯
    header('Content-type: text/xml');
    echo '<?xml version="1.0" encoding="UTF-8"?>';

    // 接收Twilio发送的录音相关参数
    $recordingUrl = $_REQUEST['RecordingUrl'] ?? 'N/A';
    $callSid = $_REQUEST['CallSid'] ?? 'N/A';
    $recordingDuration = $_REQUEST['RecordingDuration'] ?? 'N/A';
    $fromNumber = $_REQUEST['From'] ?? 'N/A'; // 来电者号码

    // 配置邮件接收者和主题
    $to = 'your_email@example.com'; // 替换为您的邮箱地址
    $subject = '新的Twilio语音邮件来自 ' . $fromNumber;

    // 邮件内容
    $message = "您收到一条新的语音邮件!\n\n";
    $message .= "来电号码: " . $fromNumber . "\n";
    $message .= "录音时长: " . $recordingDuration . " 秒\n";
    $message .= "录音链接: " . $recordingUrl . "\n\n";
    $message .= "Twilio Call SID: " . $callSid . "\n";
    $message .= "请点击链接收听留言。\n";

    // 邮件头部
    $headers = 'From: noreply@yourdomain.com' . "\r\n" .
               'Reply-To: noreply@yourdomain.com' . "\r\n" .
               'X-Mailer: PHP/' . phpversion();

    // 发送邮件
    if (mail($to, $subject, $message, $headers)) {
        // 邮件发送成功,可以记录日志
        error_log("语音邮件成功发送到: " . $to . ",录音链接: " . $recordingUrl);
        echo '<Response><Say voice="alice">语音邮件已发送。</Say></Response>';
    } else {
        // 邮件发送失败
        error_log("语音邮件发送失败到: " . $to . ",录音链接: " . $recordingUrl);
        echo '<Response><Say voice="alice">发送语音邮件时出现问题。</Say></Response>';
    }
?>
登录后复制

解释:

  • 参数接收: $_REQUEST['RecordingUrl']是Twilio发送的最重要的参数,它包含了录音文件的直接访问链接。此外,CallSid(呼叫ID)、RecordingDuration(录音时长)和From(来电者号码)等参数也很有用。
  • 邮件配置: 替换$to为您的实际邮箱地址。
  • 邮件内容: 构建包含来电信息和录音链接的邮件正文。
  • mail()函数: PHP内置的mail()函数用于发送邮件。请注意,为了在生产环境中获得更好的可靠性和功能(如附件、HTML邮件),强烈建议使用PHPMailer等专业的PHP邮件发送库,并配置SMTP服务器。
  • 响应: 即使此脚本主要用于后台处理,也最好返回一个简单的TwiML响应,例如<Say>,告知来电者语音邮件已处理完毕,然后挂断。

四、部署与配置要点

完成代码编写后,正确的部署和配置至关重要。

  1. Twilio Webhook URL配置:

    • 登录您的Twilio控制台。
    • 导航到“Phone Numbers” -> “Manage Numbers”。
    • 选择您的Twilio号码。
    • 在“Voice & Fax”部分,找到“A CALL COMES IN”或“When a Call Comes In”,将其设置为“Webhook”。
    • 输入您的Handle-Incoming-Call.XML的公共可访问URL,例如 https://yourdomain.com/twilio/Handle-Incoming-Call.XML。确保使用HTTPS。
  2. 文件路径与可访问性:

    • 将所有PHP和XML文件部署到您的Web服务器上,并确保它们可以通过公共URL访问。
    • 请注意,在TwiML中引用的URL(如<Redirect>handle-extension.php</Redirect>、<Number url="screen-caller.xml">、<Dial action="voicemail.php">、<Record action="mail.php">)可以是相对路径,前提是它们与当前执行的TwiML文件位于同一目录下,或者Twilio能够正确解析它们的相对路径。为了避免路径问题,使用绝对URL(https://yourdomain.com/path/to/file.php)通常更可靠。
  3. 邮件发送配置:

    • PHP mail()函数: 确保您的Web服务器已正确配置sendmail或等效的邮件传输代理(MTA),以便PHP的mail()函数能够正常工作。
    • SMTP服务: 对于生产环境,强烈推荐使用第三方SMTP服务(如SendGrid, Mailgun, AWS SES等)配合PHPMailer等库发送邮件。这能显著提高邮件的送达率和可靠性。
  4. 安全性考虑:

    • 对所有从$_REQUEST获取的输入进行验证和过滤,以防止潜在的安全漏洞(如XSS)。
    • 考虑使用Twilio的请求验证功能,确保只有来自Twilio的请求才能触发您的Webhook。
  5. **

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