17370845950

本教程详细介绍了如何利用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。

    handle-extension.php

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

';
    echo '';
    echo '感谢您的来电，欢迎致电我的公司。';
    // 尝试拨号，并启用录音。如果未接听，则转到 voicemail.php
    echo '';
    // 拨号到业务负责人，并指定 screen-caller.xml 进行筛选
    echo '+10000000000'; 
    echo '';
    echo '';
?>

• ：播放一段欢迎语。
• ：尝试拨号连接到目标号码（+10000000000）。
  • record="true"：开启呼叫录音。
  • timeout="15"：设置拨号超时时间为15秒。
  • action="voicemail.php"：如果拨号未接听或超时，Twilio将向voicemail.php发送请求，处理语音留言。
• ：在连接到目标号码之前，Twilio会向screen-caller.xml发送请求，由其返回TwiML指令进行呼叫筛选。

2.2 来电筛选与业务逻辑

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

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

    
        有新的来电，请注意。
        要接听电话，请按 1。
        要拒绝电话，请按 2。
    

• ：收集用户的数字输入。
  • action="handle-screen-input.php"：用户输入后，Twilio将向此PHP脚本发送请求，并传递输入的数字。
  • numDigits="1"：收集一个数字。
• ：播放提示音，引导业务负责人选择操作。

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

';
    echo '';
    $user_pushed = (int) $_REQUEST['Digits']; // 获取用户按下的数字
    if ($user_pushed == 1) {
        echo '正在连接，请说“您好”。';
        // 如果返回  之后没有其他 TwiML，Twilio 会将呼叫连接到  中指定的号码。
    } else {
        echo ''; // 如果按下 2，则挂断电话。
    }
    echo '';
?>

• 如果业务负责人按下 1，handle-screen-input.php会返回一个 指令，然后Twilio将呼叫连接到handle-extension.php中指定的号码。
• 如果业务负责人按下 2，handle-screen-input.php会返回一个 指令，Twilio将直接挂断当前呼叫。此时，由于原始的指令中设置了action="voicemail.php"，Twilio会将控制权转交给voicemail.php来处理语音留言。

3. 实现语音留言功能

当呼叫未被接听（超时）或被拒绝（handle-screen-input.php返回）时，Twilio会根据handle-extension.php中的action属性，将控制权交给voicemail.php。

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

\n";
    // 可以选择记录传入请求的日志，用于调试
    // file_put_contents('incoming_voicemail.log', "\n" .json_encode($_REQUEST) . "\n", FILE_APPEND);
?>

  您拨打的电话暂时无人接听，请在“嘟”声后留言。
  
  

• ：播放提示音，告知来电者可以留言。
• ：开始录制语音留言。
  • action="mail.php"：这是关键！当录音完成后，Twilio会将录音的URL和其他相关信息POST到mail.php脚本，由其进行后续处理（例如发送邮件）。

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

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

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

    header('content-type: text/xml');
    echo "\n";
    echo ""; // 返回空响应，告知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 \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系统、定制语音留言流程等。