多方会议接口

创建多方会议接口(快速)

使用场景 在坐席通话时，对接系统向呼叫中心服务器发送HTTP请求，创建三方会议。 实现流程

接口描述 接口完整URL：

http://x.x.x.x:12121/bridge/callctrl?caller=132XXXXXXXX&callee=801&target=802&opt=CONFERENCE_CREATE
字段名字段含义描述
caller通话中的主叫号码
callee通话中的被叫号码
target被邀请加入会议的号码可以是分机号，可以是手机，固定号码等
optCONFERENCE_CREATE默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功
  • 404: 找不到相关的通话，无法创建3方会议
  • 483: 重复创建
  • 486: 被邀请电话忙
  • 503: 系统资源不足

邀请终端加入会议

使用场景 创建会议后，使用该接口邀请终端加入会议。 实现流程 参考上图：图8-1 接口描述 完整URL：

http://x.x.x.x:12121/bridge/callctrl?conferenceid=801&target=159XXXXXXXX&opt=CONFERENCE_JOIN
字段名字段含义描述
conferenceid会议编号一般使用创建会议的callee作为会议编号
target被邀请加入会议的号码可以是分机号，可以是手机，固定号码等
optCONFERENCE_JOIN默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功
  • 404: 找不到相关的会议，无法加入会议
  • 486: 被邀请电话忙
  • 480: 正在创建会议，稍后再试。
  • 503: 系统资源不足

通话中呼叫第三方接口

使用场景 在客户呼入正与坐席通话中，对接系统可调用呼叫中心服务器HTTP接口，请求通话中呼叫第三方号码。呼叫中心在收到请求后，先给主叫播放等待音乐，然后呼叫第三方电话号码，此时话务员可以与第三方终端进行通话。在第三方终端振铃时对接系统可调用HTTP接口通话恢复通话，还可调用接口转接来电到第三方，还可以调用接口创建3方会议。 实现流程

接口描述 通话中呼叫第三方URL：

http:// x.x.x.x:12121/bridge/callctrl?callee=801&target=802&opt=CALL_THIRD
字段名字段含义描述
caller 或 callee通话中的分机号码callee: 表示被叫坐席发起呼叫第三方
caller: 表示主叫坐席发起呼叫第三方
backid返回关联呼叫记录的CALL-IDtrue: 成功后返回callid,可用于查询相关呼叫记录
false: 默认, 不返回callid, 成功返回200
target分机号或手机号、固话号码等
optCALL_THIRD默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功, 如果请求参数的backid=false或不携带backid参数
  • 400: 参数错误
  • 404: 无法找到callee相关的通话
  • 500: 系统错误

呼叫第三方时恢复通话URL：（无论第三方终端是振铃或接听都可调用该接口恢复之前通话）

http://x.x.x.x:12121/bridge/callctrl?callee=801&opt=CALL_THIRD_RESUME
字段名字段含义描述
caller
callee		通话中的分机号码系统会根据callee或者caller找到相关通话，然后恢复通话。
callee: 表示被叫坐席发起呼叫第三方
caller: 表示主叫坐席发起呼叫第三方
optCALL_THIRD_RESUME默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功
  • 400: 参数错误
  • 404: 无法找到callee相关的通话
  • 500: 系统错误

呼叫第三方时查询呼叫状态URL：

http://x.x.x.x:12121/bridge/callctrl?callee=801&opt=CALL_THIRD_GET_THIRD_STATE
字段名字段含义描述
caller
callee		通话中的分机号码系统会根据callee或者caller找到相关通话。
callee: 表示被叫坐席发起呼叫第三方
caller: 表示主叫坐席发起呼叫第三方或者点击呼叫先呼叫坐席自己再呼叫第三方
optCALL_THIRD_GET_THIRD_STATE默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 100: 瞬时状态，很少遇到，如果获取可忽略
  • 180: 目标终端振铃
  • 200: 目标终端接听，如：PSTN线路此处不是很准确，需结合坐席话筒判断
  • 400: 参数错误
  • 404: 无法找到callee相关的通话，或者已经转话或创建三方
  • 603: 目标终端忙，拒绝接听

三方通话接口（基于通话中呼叫第三方接口）

使用场景 在客户呼入正与坐席通话中，对接系统可调用呼叫中心服务器HTTP接口，请求通话中呼叫第三方号码。呼叫中心在收到请求后，先给主叫播放等待音乐，然后呼叫第三方电话号码，此时话务员可以与第三方终端进行通话。在话务员与第三方终端通话通话后，可以调用本接口创建3方会议。 实现流程

接口描述 基于通话中呼叫第三方，创建三方通话接口URL：

http:// x.x.x.x:12121/bridge/callctrl?callee=801&opt=CALL_THIRD_CONFERENCE
字段名字段含义描述
caller
callee		通话中的分机号码caller: 表示主叫坐席发起呼叫第三方
callee: 表示被叫坐席发起呼叫第三方
optCALL_THIRD_CONFERENCE默认不要修改
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功
  • 400: 参数错误
  • 404: 无法找到caller或callee的相关的通话，之前没有调用CALL_THIRD邀请第三方
  • 500: 系统错误
  • 487: 有终端挂机,无法创建三方通话

三方|会议踢出与会人接口

使用场景 创建三方通话或者会议之后，调用该接口踢出会议成员。 实现流程 略 接口描述 三方|会议踢出与会人接口:

http://x.x.x.x:12121/bridge/callctrl?extnum=806&target=808&opt=KICK_OUT_OF_CONFERENCE
字段名字段含义描述
extnum创建会议的分机号
target踢出会议的号码
optKICK_OUT_OF_CONFERENCE
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • 200: 操作成功
  • 400: 参数错误
  • 404: 无法找到相关的资源
  • 500: 系统错误

三方|会议成员查询接口

使用场景 创建三方通话或者会议之后，调用该接口获取会议成员。 实现流程 略 接口描述 基于通话中呼叫第三方，创建三方通话接口URL：

http://x.x.x.x:12121/bridge/conference?extnum=xxx
字段名字段含义描述
extnum会议中的分机号码
x.x.x.x:12121服务器IP通讯地址12121默认端口，如果手动修改过端口号请使用修改后的端口

Http请求响应码解释：

  • {}: 无数据
  • json格式的数据：
{
  "conferenceId": "806",
  "stauts": 1,
  "talkTime": 4,
  "timeStamp": "2025-05-24 16:19:33",
  "participants": [{
    "telnum": "158755XXXXX",
    "timeStamp": "2025-05-24 16:19:34",
    "talkTime": 3,
    "stauts": 1,
    "owner": false
  }, {
    "telnum": "806",
    "timeStamp": "2025-05-24 16:19:34",
    "talkTime": 3,
    "stauts": 1,
    "owner": true
  }, {
    "telnum": "802",
    "timeStamp": "2025-05-24 16:19:35",
    "talkTime": 2,
    "stauts": 1,
    "owner": false
  }]
}