MYVOIPAPP

事件通道

索引
1. 描述

miniSIPServer 事件通道是一种消息通道，建立在websocket连接之上。 miniSIPServer 通过事件通道将内部状态或者告警信息通知给外部程序。

miniSIPServer 与外部程序之间的事件通道

如上图所示，我们可以了解事件通道的几个关键点：

  • 事件通道基于websocket，因此外部应用程序首先需要与 miniSIPServer 建立 websocket 连接。
  • 事件消息内容采用JSON文本格式。

当前 miniSIPServer 会检查应用程序的IP地址作为鉴权。如果IP地址没有在 miniSIPServer 中配置， miniSIPServer 将拒绝该应用程序的 websocket 连接。

2. 配置
2.1 系统

默认情况下， miniSIPServer 打开 TCP 端口5080用于接受 websocket 连接。当然您可以根据自己的需要修改这个端口。请点击菜单“数据 / 系统配置 / 基本”，并修改“事件通道端口”项。如下图所示。

websocket端口配置

2.2 IP地址鉴权

如果外部应用程序要连接 miniSIPServer 事件通道，我们必须将其IP地址添加到 miniSIPServer 进行鉴权。请点击菜单“维护 / 事件通道鉴权”。

添加IP地址进行鉴权

3. 事件（Events）

本章节描述 miniSIPServer 发出的所有事件消息的细节。所有这些消息都是采用 JSON 编码格式的文本字符串。

下面是一个事件消息的示例，该消息用于报告分机“600”的注册状态。

{"command": "userStatus", "userName": "600", "status": "online"}

每个事件消息都必须包含 'command' 参数，该参数是事件标识。目前该参数可以是以下值：

  • userStatus - 报告分机的注册状态
  • sipStatus - 报告 SIP 呼叫的状态
  • sipTrunkWarning - 报告 SIP 中继异常告警
3.1 userStatus

'userStatus' 事件消息包含以下参数。

参数项 类型 描述
userName 字符串 分机名称或者号码
status 字符串 分机的当前状态，可以是以下值：
  • online - 当前分机已注册到 miniSIPServer
  • offline - 当前分机没有注册到 miniSIPServer，已经处于离线状态
3.2 sipStatus

miniSIPServer 通过本事件消息报告内部每一个 SIP 呼叫的具体状态。 由于不同的呼叫中有不同的呼叫参与方， 因此该事件消息有可能携带不同的参数。 这意味着下面这些参数实际上都是可选参数，会随着呼叫状态而有不同的变化。

参数项 类型 描述
sipID 字符串 miniSIPServer 内部资源唯一标识， 每个呼叫都有不同的标识。
callID 字符串 从 SIP 消息中获取的 'Call-ID' 头域。在 SIP 对话中是唯一标识。请注意，一个 SIP 对话中，可能包含不同的‘sipID’，是一对多的关系，但是只可能有一个'callID'对应。
stage 字符串 当前呼叫所处的呼叫阶段，可以是以下值：
  • dial - 拨号阶段，正在发起呼叫。
  • alert - 振铃，或者播放回铃音。
  • progress - 呼叫进行中。
  • talk - 被叫已摘机，呼叫已应答
  • idle - 当前呼叫已释放
type 整数 呼叫的类型
  • 1 - 发起的呼叫
  • 2 - 接受的呼叫
address 字符串 用户的IP地址
from 字符串 主叫号码
to 字符串 被叫号码，或者目的号码
setupTime 字符串 呼叫发起时的时间戳
alertTime 字符串 被叫振铃时的时间戳
progressTime 字符串 收到被叫呼叫进展消息（例如，SIP 183消息等）时的时间戳
talkTime 字符串 被叫应答时的时间戳
idleTime 字符串 呼叫释放时的时间戳

下面是几个简单的示例：

(1) 发起呼叫时的事件消息

{"command": "sipStatus", "sipID": 823853058, "callID": "24F94C6671233752773D3106MSS311B0002", "stage": "dial", "type": 2, "address": "10.0.0.101:62988", "from": "600", "to": "601", "setupTime": "2018-09-03 16:45:09"}

(2) 呼叫释放时的事件消息

{"command": "sipStatus", "sipID": 823853058, "callID": "24F94C6671233752773D3106MSS311B0002", "stage": "idle", "idleTime": "2018-09-03 16:45:17"}

3.3 sipTrunkWarning

如果 miniSIPServer 从 SIP 中继收到呼叫，但是来源的端口与配置的端口不一致， miniSIPServer 将拒绝该呼叫并报告告警信息。

'sipTrunkWarning' 事件包含以下参数：

参数项 类型 描述
ipAddr 字符串 呼叫来源的 IP 地址。
port 整数 呼叫来源的实际端口。

以下是简单示例：

{"command": "sipTrunkWarning", "ipAddr": "1.2.3.4", "port": 6666}