CallStatus（通话状态变更事件）

PBX 实时向应用服务器推送当前所有通话的状态信息。

注： 如需监控中继的通话状态，你需要在 PBX API 网页开启中继的 状态监控。

报告参数

参数 类型 描述
event String 事件类型。
callid String 每个通话的唯一 ID。
members Array <MemberType> 通话中的不同类型成员的信息列表。
sn String PBX 的 SN 码。
MemberType
参数 类型 描述
ext Object <ExtensionInfo> 分机的信息。
inbound Object <InboundInfo> 外线来电的信息。
outbound Object <OutboundInfo> 外线呼出的信息。
ExtensionInfo
参数 类型 描述
number String 分机号码。
channelid String 通话中，每个成员的通话通道 ID。
memberstatus String 该成员的通话状态。
  • ALERT：该成员作为主叫，发起呼叫后，处于回铃状态。
  • RING：该成员作为被叫，处于响铃状态。
  • ANSWERED：该成员作为主叫，发起呼叫后，电话被接听。
  • ANSWER：该成员作为被叫，接听来电。
  • HOLD：该成员的通话被保持住。
  • BYE：该成员主动挂断通话。
callpath Integer 通话建立使用的路径。
注： 通过 IVR、队列、响铃组、广播组或会议室与分机建立通话时，才会携带 callpath。

例如：分机 1000 呼叫 IVR （6500），通过 IVR 转拨分机 2000，callpath 即为 6500。
InboundInfo
参数 类型 描述
from Integer 主叫号码。
to Integer 被叫号码。
trunkname String 通过哪条中继呼入。
channelid String 通话中，每个成员的通话通道 ID。
memberstatus String 该成员的通话状态。
  • ALERT：该成员作为主叫，发起呼叫后，处于回铃状态。
  • RING：该成员作为被叫，处于响铃状态。
  • ANSWERED：该成员作为主叫，发起呼叫后，电话被接听。
  • ANSWER：该成员作为被叫，接听来电。
  • HOLD：该成员的通话被保持住。
  • BYE：该成员主动挂断通话。
callpath Integer

通话建立使用的路径。

注： 通过中继、IVR、队列或响铃组与外线号码建立通话时，才会携带 callpath。

例如：外线 2203303 呼叫 IVR （6500），通过 IVR 转拨分机 2000，callpath 即为 6500。
OutboundInfo
参数 类型 描述
from Integer 主叫号码。
to Integer 被叫号码。
trunkname String 从哪条中继呼出。
channelid String 通话中，每个成员的通话通道 ID。
memberstatus String 该成员的通话状态。
  • ALERT：该成员作为主叫，发起呼叫后，处于回铃状态。
  • RING：该成员作为被叫，处于响铃状态。
  • ANSWERED：该成员作为主叫，发起呼叫后，电话被接听。
  • ANSWER：该成员作为被叫，接听来电。
  • HOLD：该成员的通话被保持住。
  • BYE：该成员主动挂断通话。
callpath Integer
通话建立使用的路径。
注： 通过 IVR、队列或响铃组与外线号码建立通话时，才会携带 callpath。

例如：使用 IVR （6500）拨打外线号码 5503302，callpath 为 6500。

报告示例

外部号码 12345678 拨打分机号码 1023，分机 1023 响铃。

POST / HTTP/1.1
Host: 192.168.5.150: 8260
Accept: application/json
User-Agent: WebAPI
Content-Type: application/json
Accept: application/json

{
	"event": "CallStatus",
	"callid": "1571887584.74",
	"members": [
		{
			"inbound": {
				"from": "12345678",
				"to": "1023",
				"trunkname": "siptrunk",
				"channelid": "PJSIP/trunk-siptrunk-endpoint-00000030",
				"memberstatus": "ALERT"
			}
		},
		{
			"ext": {
				"number": "1023",
				"channelid": "PJSIP/1023-00000031",
				"memberstatus": "RING"
			}
		}
	],
	"sn": "369451090405"
}