Twilio添加会议参与者无应答时未返回no-answer呼叫状态问题

业务实现代码 #

呼叫人员A并创建会议的逻辑：

Dial.Builder dial = new Dial.Builder()
        .action(actionUrl)
        .timeout(timeout)
        .callerId(callBackNumber);

Conference conference = new Conference.Builder("MyConference")
        .statusCallback(statusCallbackUrl)
        .statusCallbackEvents(Arrays.asList(Conference.ConferenceEvent.values()))
        .build();
dial = dial.conference(conference);
return new VoiceResponse.Builder().dial(dial.build());

收到携带conferenceSid的会议事件后，外呼人员B加入会议的逻辑：

Participant participant = Participant.creator(
        conferenceSid,
        new com.twilio.type.PhoneNumber(fromPhoneNumber),
        new com.twilio.type.PhoneNumber(toPhoneNumber))
        .setStatusCallback(statusCallbackUrl)
        .setStatusCallbackEvent(Arrays.asList("initiated ringing answered completed".split(" ")))
        .setRecord(true)
        .create();

问题现象 #

人员B未接听呼叫时，statusCallbackUrl收到的请求中CallStatus字段不会返回no-answer，最终只会推送completed状态。仅在不使用会议、通过Number名词直接呼叫人员B时才能收到no-answer状态，但业务必须使用会议呼叫能力，需要确认配置问题、排查思路和解决方案。

排查结论与解决方案 #

这不是配置错误，是Twilio会议参与者API的默认行为差异：直接通过Participant.creator接口外呼添加会议参与者时，呼叫终态的回调逻辑和普通直拨Dial逻辑不一致，未接通场景默认不会返回no-answer的CallStatus，统一归为completed终态。
可按以下思路排查解决：

• 先确认超时参数配置：Participant.creator接口默认呼叫超时是30秒，若未手动显式设置timeout参数，需核对振铃时长是否符合预期，部分运营商会在60秒内提前截断呼叫，导致Twilio侧无法识别为无应答状态。
• 优先通过多字段组合识别无应答场景：不要仅依赖CallStatus字段判断，人员B未接听时，回调请求会携带以下特征：
  • CallDuration值为0
  • 若开启了应答机检测，AnsweredBy字段值为no-answer
  • 对应会议事件回调中participantStatus为failed，participantStatusReason为no-answer
    基于以上字段组合判断即可准确识别未接听场景，无需修改现有呼叫流程，改造成本最低。
• 若必须拿到标准no-answer的CallStatus值，调整呼叫流程即可：
  不要直接通过Participant.creator外呼人员B，改为先通过普通Call API向人员B发起外呼，在该呼叫的statusCallback中判断状态：如果收到answered状态，就返回TwiML将这通呼叫Dial到目标会议；如果收到no-answer、busy、failed等未接通状态，直接走业务侧的未接逻辑即可。该流程和普通直拨Number的逻辑完全一致，可以正常收到所有标准CallStatus回调。
  注意该方案下需要给外呼人员B的Call显式设置和业务要求一致的timeout参数，避免Twilio侧超时和运营商侧截断时长不一致导致状态误判。

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