如何解决Twilio中同一Client ID并发呼叫导致的重复振铃问题

问题原因 #

当两个呼叫同时发起时，Twilio尚未将呼叫状态同步到可查询的存储系统中，此时调用calls->read()无法获取到已发起的呼叫记录，导致原有检查逻辑失效，客户端会重复振铃。

解决方案 #

1. 引入分布式锁（Redis锁） #

在发起呼叫前，先针对目标Client ID获取独占锁，只有拿到锁的请求才能发起呼叫到客户端，未拿到锁的请求直接转接到指定号码。这种方式可以从根源上避免并发请求绕过检查。

示例代码：

// 假设已初始化Redis客户端实例$redis
$lockKey = "twilio_call_lock:client:$driver";
// 设置锁有效期为10秒（足够Twilio完成呼叫状态同步），NX表示仅当锁不存在时才设置
$lockAcquired = $redis->set($lockKey, 1, ['NX', 'EX' => 10]);

if (!$lockAcquired) {
    // 未获取到锁，说明有并发呼叫，直接转接
    call_to_manual_phone_number();
    continue;
}

// 二次校验呼叫状态（作为锁机制的补充）
$callsQueued = $twilio->calls->read(['to' => 'client:' . $driver, 'status' => 'queued']);
$callsRinging = $twilio->calls->read(['to' => 'client:' . $driver, 'status' => 'ringing']);
$callsInProgress = $twilio->calls->read(['to' => 'client:' . $driver, 'status' => 'in-progress']);

if (count($callsQueued) > 0 || count($callsRinging) > 0 || count($callsInProgress) > 0) {
    call_to_manual_phone_number();
    $redis->del($lockKey); // 释放锁
    continue;
}

// 将司机添加到会议
add_driver_to_conference();
$redis->del($lockKey); // 释放锁

2. 利用Twilio呼叫状态回调筛选 #

通过Twilio的statusCallback事件，在呼叫初始化阶段检查客户端的活跃呼叫状态，若存在则直接返回转接逻辑的TwiML，避免客户端振铃。

步骤1：配置呼叫的TwiML

<Response>
  <Dial answerOnBridge="true">
    <Client 
      statusCallbackEvent="initiated,ringing" 
      statusCallback="/twilio/check-client-status"
    >
      <Identity>{{$driver}}</Identity>
    </Client>
  </Dial>
</Response>

步骤2：实现状态检查端点

// /twilio/check-client-status 端点代码
$clientId = $_POST['To']; // 格式为client:235242
$callsQueued = $twilio->calls->read(['to' => $clientId, 'status' => 'queued']);
$callsRinging = $twilio->calls->read(['to' => $clientId, 'status' => 'ringing']);
$callsInProgress = $twilio->calls->read(['to' => $clientId, 'status' => 'in-progress']);

// 只要存在活跃呼叫就转接
if (count($callsQueued) + count($callsRinging) + count($callsInProgress) > 1) {
    header('Content-Type: application/xml');
    echo '<Response><Dial>+1234567890</Dial></Response>';
    exit;
}

// 无活跃呼叫，继续振铃
header('Content-Type: application/xml');
echo '<Response><Dial><Client><Identity>' . $_POST['Identity'] . '</Identity></Client></Dial></Response>';

3. 优化原有检查逻辑的条件 #

原逻辑判断count(...)>1，但实际上只要客户端存在任何活跃状态的呼叫（queued/ringing/in-progress），就应该触发转接。调整条件为：

if (count($callsQueued) > 0 || count($callsRinging) > 0 || count($callsInProgress) > 0) {
    call_to_manual_phone_number();
    continue;
}

该优化能提升非并发场景下的准确性，但无法解决并发问题，需配合前两种方案使用。

内容的提问来源于stack exchange，提问作者ali