本文详细介绍了如何利用twilio、php和twiml构建一个高效的呼叫管理系统。教程涵盖了来电筛选、拒绝呼叫后自动转接至语音信箱，并进一步实现将录制的语音信箱链接通过电子邮件发送给指定收件人。通过逐步指导，读者将学会如何配置twiml指令和php脚本，以实现完整的呼叫流程自动化和语音信箱的便捷管理。
Twilio呼叫管理系统构建：从筛选到邮件通知
在现代商业通信中，高效的呼叫管理系统至关重要。本文将指导您如何使用Twilio、PHP和TwiML构建一个系统，实现来电筛选、拒绝呼叫时自动转入语音信箱，并将录制的语音信箱文件链接通过电子邮件发送给指定邮箱。
1. 呼叫流程概览
整个呼叫流程通过一系列Twilio Webhook触发的XML和PHP脚本协同工作。基本流程如下： 客户呼叫 -> Twilio Webhook -> handle-incoming-call.xml -> handle-extension.php -> screen-caller.xml -> handle-screen-input.php -> voicemail.php -> mail.php。
1.1 入口文件：handle-incoming-call.xml
当客户拨打您的Twilio号码时，Twilio会将呼叫路由到您配置的Webhook URL，该URL指向handle-incoming-call.xml。这个XML文件简单地将控制权重定向到handle-extension.php。
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect>handle-extension.php</Redirect>
</Response>1.2 呼叫拨号与录音设置：handle-extension.php
handle-extension.php负责播放欢迎语，并尝试将呼叫拨号到您的业务号码。关键在于Dial动词的record="true"属性，它会录制整个通话过程（包括语音信箱），以及action="voicemail.php"属性，它定义了当被叫方未接听或无法接通时，Twilio将请求发送到的URL。
<?php
header('Content-type: text/xml');
echo '<?xml version="1.0" encoding="UTF-8"?>';
echo '<Response>';
echo '<Say>感谢您的来电，我的公司。</Say>';
// record="true" 录制整个通话，包括语音信箱。
// action="voicemail.php" 定义了当拨号失败或未接听时，Twilio将请求发送到的URL。
echo '<Dial record="true" timeout="15" action="voicemail.php">';
// url="screen-caller.xml" 定义了在连接到主号码前，Twilio将请求发送到的URL，用于来电筛选。
echo '<Number url="screen-caller.xml">+10000000000</Number>'; // 替换为您的业务号码
echo '</Dial>';
echo '</Response>';
?>2. 来电筛选与决策
在将呼叫连接到您的主号码之前，系统会通过screen-caller.xml进行来电筛选，让您可以选择接听或拒绝。
2.1 来电筛选界面：screen-caller.xml
screen-caller.xml使用Gather动词来收集您的输入。它会向您播放提示语，询问是否接听或拒绝呼叫。
<?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>2.2 处理筛选输入：handle-screen-input.php
handle-screen-input.php接收您在screen-caller.xml中输入的数字。
- 如果您按下1，系统会连接呼叫。
- 如果您按下2，系统会使用Hangup动词直接挂断当前呼叫，此时，由于handle-extension.php中的Dial动词设置了action="voicemail.php"，Twilio会自动将控制权转移到voicemail.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>';
} else {
// 如果按下2，挂断电话，Twilio会根据Dial的action属性转到voicemail.php
echo '<Hangup />';
}
echo '</Response>';
?>3. 语音信箱录制与邮件通知
当呼叫被拒绝或未接听时，系统将转入语音信箱流程，并最终将录音发送到您的邮箱。
3.1 语音信箱录制：voicemail.php
voicemail.php负责播放语音信箱提示语并录制留言。这里的关键是Record动词的action属性，它被设置为mail.php。这意味着当录音完成后，Twilio会将录音的详细信息（包括RecordingUrl）发送到mail.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>
<!-- 当录音完成后，Twilio会将录音数据发送到 mail.php -->
<Record action="mail.php"></Record>
</Response>3.2 语音信箱邮件发送：mail.php
mail.php是实现语音信箱邮件通知的核心。它接收Twilio发送的RecordingUrl和其他相关参数，然后构建一封电子邮件并发送。
<?php
// 设置响应头，尽管这里主要处理邮件发送，但Twilio仍期望一个TwiML响应
header('content-type: text/xml');
echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n";
// 获取Twilio发送的录音URL
$recordingUrl = $_REQUEST['RecordingUrl'] ?? '未获取到录音链接';
$callSid = $_REQUEST['CallSid'] ?? '未知呼叫ID';
$fromNumber = $_REQUEST['From'] ?? '未知来电号码';
$duration = $_REQUEST['RecordingDuration'] ?? '未知时长';
// 邮件配置
$to = 'your_email@example.com'; // 替换为您的收件邮箱
$subject = '新的语音信箱留言来自 ' . $fromNumber;
$message = "您收到一条新的语音信箱留言。\n\n";
$message .= "来电号码: " . $fromNumber . "\n";
$message .= "留言时长: " . $duration . " 秒\n";
$message .= "录音链接: " . $recordingUrl . ".mp3\n\n"; // Twilio录音URL通常不带扩展名，手动添加.mp3
$message .= "Twilio呼叫SID: " . $callSid . "\n";
$headers = 'From: voicemail@yourdomain.com' . "\r\n" .
'Reply-To: no-reply@yourdomain.com' . "\r\n" .
'X-Mailer: PHP/' . phpversion();
// 发送邮件
if (mail($to, $subject, $message, $headers)) {
// 邮件发送成功，可以记录日志或进行其他处理
// error_log("语音信箱邮件发送成功到: " . $to);
echo '<Response><Say>语音信箱已发送。</Say></Response>';
} else {
// 邮件发送失败
// error_log("语音信箱邮件发送失败到: " . $to);
echo '<Response><Say>语音信箱邮件发送失败。</Say></Response>';
}
?>注意事项：
- 请将your_email@example.com和voicemail@yourdomain.com替换为您的实际邮箱地址。
- PHP的mail()函数可能需要您的服务器配置支持才能正常工作。对于生产环境，强烈建议使用更健壮的邮件发送库（如PHPMailer）或专业的邮件服务API（如SendGrid, Mailgun等），它们提供了更好的错误处理、认证和发送可靠性。
- Twilio提供的RecordingUrl通常不包含文件扩展名，为了方便播放，我们手动添加了.mp3。
4. 部署与测试
- 将所有PHP和XML文件部署到您的Web服务器。确保它们可以通过公共URL访问。
- 在Twilio控制台配置您的Twilio号码，将“当有来电时”的Webhook URL指向handle-incoming-call.xml的公共URL。
- 拨打您的Twilio号码进行测试。按照语音提示进行操作，验证呼叫筛选、语音信箱录制和邮件通知功能是否正常。
5. 总结
通过上述步骤，您已经成功构建了一个Twilio呼叫管理系统，实现了来电筛选、拒绝呼叫后自动转入语音信箱，并将语音信箱录音链接通过电子邮件发送。这个系统极大地提升了业务通信的灵活性和效率，确保您不会错过任何重要的客户留言。在实际应用中，您可以根据需求进一步扩展功能，例如添加数据库记录、更多通知渠道或自定义语音提示等。
