本教程详细指导如何构建一个完整的twilio呼叫处理系统。内容涵盖来电配置、呼叫筛选、将拒接电话转接至语音邮件，并最终实现将录制的语音邮件自动发送至指定邮箱。通过学习，您将掌握如何利用twilio的twiml和php webhook，创建高效且无缝的通信流程，确保重要信息不被遗漏，提升业务沟通效率。
引言
在现代业务通信中，高效的呼叫处理机制至关重要。Twilio作为领先的云通信平台，提供了强大的API和TwiML（Twilio Markup Language），使得开发者能够灵活地定制呼叫流程。本文将深入探讨如何利用Twilio构建一个智能呼叫系统，实现客户来电的筛选、拒接电话自动转接至语音邮件，并将录制的语音邮件链接通过电子邮件发送给业务负责人，从而确保即使在无法接听电话时，也能及时获取重要信息。
Twilio呼叫流程概览
一个典型的Twilio呼叫处理流程涉及多个环节，通过一系列XML和PHP文件协同工作。以下是我们将要实现的呼叫路径：
- 客户来电: 客户拨打Twilio号码。
- Webhook触发: Twilio将呼叫事件发送到预设的Webhook URL（例如，handle-incoming-call.xml）。
- 初始重定向: handle-incoming-call.xml将请求重定向到核心处理逻辑（例如，handle-extension.php）。
- 欢迎语与拨号尝试: handle-extension.php播放欢迎语，并尝试将呼叫转接到业务负责人。在此过程中，会先进行呼叫筛选。
- 呼叫筛选: 业务负责人在接听前会听到一段提示，选择接受或拒绝来电。
- 处理筛选结果: 根据业务负责人的选择，决定是连接电话还是执行其他操作（如挂断）。
- 语音邮件转接: 如果呼叫被拒绝或无人接听，系统将自动转接到语音邮件。
- 语音邮件录制与邮件通知: 客户留言后，录音文件将生成，并通过电子邮件发送给业务负责人。
接下来，我们将详细介绍每个环节的实现细节。
核心文件与TwiML配置
1. handle-incoming-call.xml – 初始呼叫入口
当Twilio号码接到呼叫时，会向此Webhook URL发送请求。此文件通常只负责将请求重定向到更复杂的处理逻辑。
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Redirect>handle-extension.php</Redirect>
</Response>
2. handle-extension.php – 欢迎语与拨号逻辑
此PHP文件负责播放欢迎语，并尝试将呼叫转接给业务负责人。关键在于<Dial>动词的action属性，它定义了当拨号失败（例如，被叫方未接听、忙线或被主动拒绝）时Twilio应该执行的TwiML URL。同时，url属性用于在拨号前对被叫方进行筛选。
<?php
header('Content-type: text/xml');
echo '<?xml version="1.0" encoding="UTF-8"?>';
echo '<Response>';
// 播放欢迎语
echo '<Say voice="alice">感谢您致电我的公司</Say>';
// 尝试拨号给业务负责人
// record="true" 启用录音（如果业务方接听并通话）
// timeout="15" 设置拨号超时时间
// action="voicemail.php" 定义当拨号失败时（如无人接听或被拒绝），Twilio将请求发送到此URL
echo '<Dial record="true" timeout="15" action="voicemail.php">';
// url="screen-caller.xml" 定义在连接被叫方之前，先执行此TwiML进行呼叫筛选
echo '<Number url="screen-caller.xml">+10000000000</Number>'; // 替换为您的业务电话号码
echo '</Dial>';
echo '</Response>';
?>
3. screen-caller.xml – 呼叫筛选界面
此TwiML文件在handle-extension.php尝试拨号给业务负责人时被执行。它使用<Gather>动词收集业务负责人的按键输入，以决定是否接受来电。
<?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>
4. handle-screen-input.php – 处理筛选结果
此PHP文件接收screen-caller.xml中收集到的按键输入。如果业务负责人按1，则连接呼叫；如果按2，则执行<Hangup />。关键在于，当在<Dial>的url中执行<Hangup />时，Twilio会认为被叫方拒绝了呼叫，从而触发<Dial>的action属性指向的URL（即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 voice="alice">正在连接，请说“你好”。</Say>';
// Twilio将自动连接来电者与业务负责人
}
else {
// 如果按2，挂断当前连接尝试。
// 这将触发 handle-extension.php 中 <Dial> 的 action 属性，转到 voicemail.php
echo '<Hangup />';
}
echo '</Response>';
?>
实现呼叫拒接转语音邮件
当handle-extension.php中的<Dial>动词因无人接听或被handle-screen-input.php中的<Hangup />拒绝而失败时，Twilio会将控制权转交给action属性指定的voicemail.php。
voicemail.php – 语音邮件录制
此文件负责播放语音邮件提示语，并使用<Record>动词录制客户的留言。核心改动在于<Record>的action属性，它指定了录音完成后Twilio将请求发送到的URL，以便处理录音文件。
<?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>
语音邮件录音的邮件通知
录音完成后，Twilio会将包含录音链接的请求发送到voicemail.php中<Record>动词的action属性指定的mail.php。
mail.php – 发送语音邮件通知邮件
mail.php文件将接收Twilio发送的Webhook请求，其中包含RecordingUrl参数。我们可以利用此参数构建一封电子邮件，并发送给指定的收件人。
<?php
// 确保Twilio能够接收到TwiML响应，即使我们不返回任何内容
header('Content-type: text/xml');
echo '<?xml version="1.0" encoding="UTF-8"?><Response></Response>';
// 接收Twilio发送的参数
$recordingUrl = $_REQUEST['RecordingUrl'] ?? null;
$callSid = $_REQUEST['CallSid'] ?? 'N/A';
$fromNumber = $_REQUEST['From'] ?? 'N/A';
$duration = $_REQUEST['RecordingDuration'] ?? 'N/A';
if ($recordingUrl) {
$to = 'your_email@example.com'; // 替换为您的收件邮箱
$subject = '新的Twilio语音邮件 - 来自 ' . $fromNumber;
$message = "您收到一条新的语音邮件。/n/n";
$message .= "来自号码: " . $fromNumber . "/n";
$message .= "录音时长: " . $duration . " 秒/n";
$message .= "录音链接: " . $recordingUrl . ".mp3/n"; // Twilio录音链接通常是MP3格式
$message .= "Call SID: " . $callSid . "/n/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)) {
// 邮件发送成功，可以记录日志
file_put_contents('mail_log.log', "语音邮件通知邮件发送成功到 $to (Call SID: $callSid)/n", FILE_APPEND);
} else {
// 邮件发送失败，记录错误
file_put_contents('mail_log.log', "语音邮件通知邮件发送失败到 $to (Call SID: $callSid)/n", FILE_APPEND);
}
} else {
// 未获取到录音链接，记录错误
file_put_contents('mail_log.log', "mail.php 未收到 RecordingUrl (Call SID: $callSid)/n", FILE_APPEND);
}
?>
注意:
- 请将your_email@example.com替换为实际的收件邮箱。
- noreply@yourdomain.com应替换为有效的发件邮箱地址。
- PHP的mail()函数依赖于服务器的邮件配置（如sendmail）。在生产环境中，建议使用更健壮的邮件库，如PHPMailer或SwiftMailer，它们支持SMTP认证，提供更好的可靠性和错误处理。
- Twilio提供的RecordingUrl通常是一个链接，直接访问即可下载或播放，添加.mp3后缀可以确保某些邮件客户端正确识别为音频文件。
注意事项与最佳实践
- Webhook URL配置: 确保在Twilio控制台中正确配置您的电话号码的”A CALL COMES IN” Webhook URL，指向handle-incoming-call.xml的公开可访问地址。
- HTTPS: 出于安全考虑，强烈建议所有Twilio Webhook URL都使用HTTPS。
- 错误处理与日志记录: 在每个PHP文件中加入适当的错误处理和日志记录机制，以便在出现问题时能够快速诊断。例如，使用file_put_contents()记录请求参数或错误信息。
- 邮件内容优化: 邮件内容可以根据需求进行定制，例如包含来电者号码、通话ID、语音邮件持续时间等更多信息。
- 安全性: 在处理邮件发送时，请确保发件箱配置安全，避免垃圾邮件问题。
- 可扩展性: 随着业务增长，可以考虑将配置参数（如收件邮箱、欢迎语文本、业务号码）外部化到配置文件或数据库中，以便于管理。
- Twilio TwiML Bin/Functions: 对于简单的逻辑，也可以考虑使用Twilio的TwiML Bin或Functions服务，避免自己维护服务器。
总结
通过以上步骤，我们成功构建了一个功能完善的Twilio呼叫处理系统。它不仅能够智能地筛选来电，还能在业务负责人无法接听时，自动将电话转接至语音邮件，并将录音文件通过电子邮件及时通知。这种自动化流程大大提高了通信效率，确保了重要信息的传递，是现代企业不可或缺的通信解决方案。您可以根据自身业务需求，在此基础上进行进一步的定制和扩展。
以上就是Twilio呼叫拒接与语音邮件转发及邮件通知实现教程的详细内容，更多请关注php中文网其它相关文章！