
本教程详细介绍了如何利用twilio、php和twiml构建一个完整的来电处理系统,实现来电筛选、自动转接语音留言,并将录制好的语音留言链接通过电子邮件发送给指定收件人。文章涵盖了呼叫流程设计、twiml配置、php逻辑实现以及语音留言邮件通知的关键步骤,旨在帮助开发者高效管理twilio来电。
在现代业务通信中,高效处理来电至关重要。Twilio提供强大的可编程通信能力,结合自定义的PHP和TwiML脚本,可以实现复杂的来电处理逻辑,例如来电筛选、自动转接语音留言,并将留言录音通过电子邮件发送给相关人员。本教程将详细阐述如何构建这样一个系统。
一个典型的Twilio来电处理流程涉及多个步骤和组件,通常包括:
本系统主要由一系列PHP脚本和TwiML XML文件构成,共同协作完成呼叫处理。
当客户拨打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>';
?>在handle-extension.php中,通过url="screen-caller.xml"属性,我们引入了来电筛选机制。
screen-caller.xml: 当业务负责人接听电话时,Twilio会向此XML文件发送请求,播放筛选提示音。
<?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>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>';
?>当呼叫未被接听(超时)或被拒绝(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>为了将录制的语音留言发送到指定邮箱,我们需要创建一个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}");
}
?>通过上述步骤,我们成功构建了一个基于Twilio、PHP和TwiML的来电处理系统。该系统能够实现来电筛选,根据业务负责人的选择决定接听或拒绝,并在拒绝或无人接听时自动转入语音留言,最终将录制的语音留言链接通过电子邮件发送给指定收件人。这不仅提升了来电处理的效率,也确保了重要语音留言的及时通知。开发者可以根据自身需求,在此基础上进一步扩展功能,例如集成CRM系统、定制语音留言流程等。
以上就是基于Twilio实现来电筛选、语音留言与录音邮件发送教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号