启用 API 功能

在连接第三方应用服务器与 PBX 之前,你要先启用 PBX 的 API 接口,并做好相应的配置。

  1. 登录 PBX 网页,进入 配置 > PBX > 常规设置 > 二次开发接口
  2. 启用 API 功能。
    1. 勾选 启用
    2. 设置 用户名密码,点击 保存应用
      注: 此处的用户名和密码是第三方应用通过 API 连接到 IPPBX 时所要用到的用户名及密码。
  3. 选择是否监控分机的状态。

    当该分机状态有变更时(如:分机状态从忙变为空闲),API 会主动向第三方应用发送分机状态变更的事件报告。

  4. 选择是否监控中继状态和控制来电。
    • 来电接听控制:勾选来电接听控制之后,当该条中继有来电时先交由第三方应用处理,第三方应用可选择接受或者拒绝该来电。
      • 接受:如果第三方应用选择接受该来电,则该来电直接进入对应呼入路由目的地。

      • 拒绝:如果第三方应用选择拒绝该来电,则该来电将被直接挂断,而不会到达 PBX,PBX 上也不会有该来电的通话记录。

        PBX 将留有10秒给第三方应用处理的时间,超时则默认第三方应用接受该来电,则该来电直接进入对应呼入路由的目的地。

    • 呼入目的地控制:勾选呼入目的地控制后,当该条中继有来电时将不会直接进入对应呼入路由的目的地,而是有10秒的时间等待第三方应用指定该通通话的目的地,如果10秒超时第三方应用未指定该通话目的地,则默认进入对应呼入路由所设置的目的地。
    • 状态监控:勾选中继的状态监控后,当该中继状态有变更时(如:中继状态从注册上变为注册失败),API 会主动向第三方应用发送中继状态变更的事件报告。