内部呼叫技能队列
前置条件
- 座席已签入
- 座席当前无正在接听的呼叫(不包括保持后的呼叫)
- 被呼叫技能队列下有空闲座席
场景描述
座席登录以后进行内部呼叫。常用业务场景:座席内部咨询某个技能队列下的座席。
接口方法
设置成“PUT”。该接口仅支持PUT方法,不支持POST、GET和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/voicecall/{agentid}/callinnerskill
如果CC-Gateway单机部署,IP地址为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号,默认值为8043;如果CC-Gateway采用集群模式部署,IP请配置为NSLB地址, Port请配置为默认值8043。
NSLB上的CC-Gateway端口号,请以nslb用户登录任意一个NSLB节点,执行./nslbctl l查询,查询结果中,如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。

SaaS场景下请咨询运维人员获取IP和Port。
|
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
|---|---|---|---|---|
|
1 |
agentid |
string |
True |
座席的工号,取值范围:101~999999 |
日志中的方法名
callInnerSkill
请求说明
- 消息头
表2 请求头参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式,缺省值:application/json; charset=UTF-8
2
Guid
string
True
静态鉴权(AUTHMODE = 1)签入接口返回的Guid;动态鉴权(AUTHMODE = 2)轮询事件接口返回的Guid。
- 消息体
参数名
数据类型
选取原则
说明
skillId
int
必选
被叫的技能ID
响应说明
|
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
|
1 |
message |
string |
描述 |
|
2 |
retcode |
string |
错误码。取值如下: 0:成功 非0:失败 |
|
3 |
result |
string |
呼叫成功后,返回呼叫唯一标识callid。 呼叫失败不返回该项。 |
触发事件
内部呼叫成功,触发如下事件
- 座席物理话机振铃(AgentOther_PhoneAlerting)
- 座席物理话机摘机(AgentOther_PhoneOffhook)
- 座席忙事件(AgentState_Busy)
- 对方振铃(AgentEvent_Customer_Alerting)
- 座席进入Talking(AgentEvent_Talking)
内部呼叫失败,触发如下事件:
- 内部呼叫失败(AgentEvent_Inside_Call_Fail)
错误结果码
- 000-002
- 100-006
- 100-007
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
{ "skillId": 2 } - 响应参数
{ "result": "1721980849-240", "message": "success", "retcode": "0" }