更新时间：2023-09-27 GMT+08:00
三方通话
前置条件
- 座席已签入
- 座席有已经建立的呼叫
- 座席有已经保持的呼叫
场景描述
座席对正在通话中的通话和保持中的通话进行三方通话。
接口方法
设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/voicecall/{agentid}/confjoin
其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。
|
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
|---|---|---|---|---|
|
1 |
agentid |
string |
True |
座席的工号，取值范围：101～59999。 |
日志中的方法名
confJoin
请求说明
- 消息头
表2 请求头参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式，缺省值：application/json; charset=UTF-8
2
Guid
string
True
静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。
- 消息体
表3 消息体参数说明 序号
名称
参数类型
是否必选
说明
1
callid
string
True
已经保持住的呼叫的callid。不可为空
2
callappdata
string
False
需设置的随路数据。内容可为空，最大长度为16k。
响应说明
|
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
|
1 |
message |
string |
描述 |
|
2 |
retcode |
string |
错误码。取值如下： 0：成功 非0：失败 |
|
3 |
result |
object |
预留字段 |
触发事件
- 三方通话成功（AgentEvent_Conference）
- 客户退出呼叫（AgentEvent_Customer_Release）
错误结果码
- 100-006
- 100-007
- 200-010
- 200-011
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
{ "callid": "1455885056-1095", "callappdata": "" } - 响应参数
{ "result": {}, "message": "success", "retcode": "0" }
父主题： 呼叫控制类:voicecall
