(30011) 通话状态变更

PBX 实时向第三方应用发送所有通话的状态信息。

前提条件

如果需要监控中继的通话状态，你需要现在 PBX 上启用中继的 通话状态监控 功能。更多信息，请参见 启用 Yeastar P 系列 IPPBX 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":" "
                 }
               }
           ]
        }"
}