(30011) 通话状态变更
PBX 实时向第三方应用发送所有通话的状态信息。
前提条件
如果需要监控中继的通话状态,你需要现在 PBX 上启用中继的 通话状态监控 功能。更多信息,请参见 启用 Yeastar P 系列云 PBX API。
报告参数
参数 | 类型 | 说明 |
---|---|---|
type | Integer | 事件 ID。 |
sn | String | PBX 序列号 (SN 码)。 |
msg | Object<Call_Info> | 通话详情。 |
- Call_Info
-
参数 类型 说明 call_id String 通话的唯一 ID。 members Array<Members> 通话中的不同类型成员的信息列表。
- Members
-
表 1. 参数 类型 说明 extension Object<Extension_Info> 分机的信息。 inbound Object<Inbound_Info> 外线来电的信息。 outbound Object<Outbound_Info> 外线呼出的信息。 - Extension_Info
-
表 2. 参数 类型 说明 number String 分机号码。 channel_id String 通话中每个成员的通话通道 ID。 member_status String 该成员的通话状态。 ALERT
:该成员作为主叫,发起呼叫后,处于回铃状态。RING
:该成员作为被叫,处于响铃状态。ANSWERED
:该成员作为主叫,发起呼叫后,电话被接听。ANSWER
:该成员作为被叫,接听来电。HOLD
:该成员的通话被保持。BYE
:该成员主动挂断通话。
call_path String 通话建立使用的路径。 注: 当通过 IVR、队列、响铃组、广播组或会议室建立通话时,才会返回值。 - Inbound_Info
-
表 3. 参数 类型 说明 from String 主叫号码。 to String 被叫号码。 trunk_name String 通过哪条中继呼入。 channel_id String 通话中每个成员的通话通道 ID。 member_status String 该成员的通话状态。 ALERT
:该成员作为主叫,发起呼叫后,处于回铃状态。RING
:该成员作为被叫,处于响铃状态。ANSWERED
:该成员作为主叫,发起呼叫后,电话被接听。ANSWER
:该成员作为被叫,接听来电。HOLD
:该成员的通话被保持。BYE
:该成员主动挂断通话。
call_path String 通话建立使用的路径。 注: 当通过 IVR、队列、响铃组、广播组或会议室建立通话时,才会返回值。
- Outbound_Info
-
表 4. 参数 类型 说明 from String 主叫号码。 to String 被叫号码。 trunk_name String 通过哪条中继呼出。 channel_id String 通话中每个成员的通话通道 ID。 member_status String 该成员的通话状态。 ALERT
:该成员作为主叫,发起呼叫后,处于回铃状态。RING
:该成员作为被叫,处于响铃状态。EARLYMEDIA
:该成员作为被叫,处于响铃状态。注: PBX 系统收到被叫方回复的 183 消息后会返回此通话状态。ANSWERED
:该成员作为主叫,发起呼叫后,电话被接听。ANSWER
:该成员作为被叫,接听来电。HOLD
:该成员的通话被保持。BYE
:该成员主动挂断通话。
call_path String 通话建立使用的路径。 注: 当通过 IVR、队列、响铃组、广播组或会议室建立通话时,才会返回值。
报告示例
分机 2002 拨打外线 5503301。
{
"type": 30011,
"sn": "3631A2124XXX",
"msg": "
{
"call_id":"1648801160.110",
"members":
[
{"extension":
{
"number":"2002",
"channel_id":"PJSIP/2002-0000004f",
"member_status":"ANSWERED",
"call_path":" "
}
},
{"outbound":
{
"from":"2002",
"to":"5503301",
"trunk_name":"peer-to-41",
"channel_id":"PJSIP/trunk-peer-to-41-endpoint-00000050",
"member_status":"ANSWER",
"call_path":" "
}
}
]
}"
}