‘响铃&回铃’报告

当 PBX 的分机拨打电话或收到来电时,PBX 会向第三方服务器发送回铃报告(ALERT)和响铃报告(RING)。

注:
  • 必须在 PBX 的 API 配置界面启用分机的 状态监控,PBX 才会发送响铃报告和回铃报告。
  • 同一个呼叫事件中,PBX 同时发送响铃报告和回铃报告。

报告参数-回铃事件

主叫拨打被叫号码后,被叫响铃后,主叫听到回铃音。

名称 类型 描述
action String 回铃事件:ALERT。
callid String 该通电话的 id。
call Object 对象参数。
主叫为分机
ext Object 分机对象。
extid String 主叫号码。
主叫为外线号码

inbound

Object 外线来电对象。
from String 主叫号码。
to String 被叫号码。
trunk String 通过哪条中继呼入。

inboundid

String 外线来电编号。
sn String PBX 的 SN 码。

报告参数-响铃事件

被叫收到来电后,被叫听到响铃音。

注: 响铃报告事件中会显示被叫号码和主叫号码。报告中,先显示被叫号码,再显示主叫号码。
名称 类型 描述
action String 回铃事件:RING。
callid String 该通电话的 id。
call Object 对象参数。
主叫为分机,被叫为分机
ext Object 分机对象。
extid String 分机号码。
主叫为分机,被叫为外线号码,先显示outbound对象,再显示ext对象。

outbound

Object 外线去电对象。
from String 主叫号码。
to String 被叫号码。
trunk String 通过哪条中继呼出。

outboundid

String 外线去电编码。
主叫为外线号码,被叫为分机,先显示ext对象,再显示inbound对象。

inbound

Object 外线来电对象。
from String 主叫号码。
to String 被叫号码。
trunk String 通过哪条中继呼入。

inboundid

String 外线来电编号。
sn String PBX 的 SN 码。

报告示例

分机 1001 呼叫分机 1002。
POST / HTTP/1.1
User-Agent: WebAPI
Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json

{
    "action": "ALERT",
    "callid": "1550710849.199",
    "call": [
        {
            "ext": {
                "extid": "1001"
            }
        }
    ],
    "sn": "369351034049"
}
POST / HTTP/1.1
User-Agent: WebAPI

Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json
{
    "action": "RING",
    "callid": "1550710849.199",
    "call": [
        {
            "ext": {
                "extid": "1002"
            }
        },
        {
            "ext": {
                "extid": "1001"
            }
        }
    ],
    "sn": "369351034049"
}

分机1001 拨打外线号码 9282883883。

POST / HTTP/1.1
User-Agent: WebAPI

Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json

{
    "action": "ALERT",
    "callid": "1547396927.428",
    "call": [
        {
            "ext": {
                "extid": "1001"
            }
        }
    ],
    "sn": "369362089179"
}

POST / HTTP/1.1
User-Agent: WebAPI

Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json

{
    "action": "RING",
    "callid": "1547396927.428",
    "call": [
        {
            "outbound": {
                "from": "1001",
                "to": "9282883883",
                "trunk": "SPS-6-36",
                "outboundid": "1547396927.429"
            }
        },
        {
            "ext": {
                "extid": "1001"
            }
        }
    ],
    "sn": "369362089179"
}

外线号码123838838呼叫分机1002。

POST / HTTP/1.1
User-Agent: WebAPI

Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json
Content-Length: 98

{
    "action": "ALERT",
    "callid": "1550714393.225",
    "call": [
        {
            "inbound": {
                "from": "123838838",
                "to": "1002",
                "trunk": "spstrunk",
                "inboundid": "1550714393.225"
            }
        }
    ],
    "sn": "369351034049"
}

POST / HTTP/1.1
User-Agent: WebAPI

Host: api.yeastarcloud.com
Content-Type: application/json
Accept: application/json

{
    "action": "RING",
    "callid": "1550714393.225",
    "call": [
        {
            "ext": {
                "extid": "1002"
            }
        },
        {
            "inbound": {
                "from": "123838838",
                "to": "1002",
                "trunk": "spstrunk",
                "inboundid": "1550714393.225"
            }
        }
    ],
    "sn": "369351034049"
}