1.接口说明

  • 可通过该接口可查询多个坐席当前状态。
    注：在优音云客服系统中，可通过设置–>开发者中心,查看租户ID:tenant_id。

2.调用URL

https://ykf.uincall.com/openapi/communication/agent/monitorCTIStatus/v1?tenant_id=acf528a2-d0e2-xxxx-xxxx-74cb3995cfab&access_token=b57b2dc8edf583xxxxxd71d8a04d0df3

3.调用方式

POST [ ‘content-type: application/json’]

4、传入参数

名称 类型 是否必填 说明
tenant_id String 是 租户ID
access_token String 是 租户鉴权Token
agent_nums array 否 坐席工号字符串数字

注：agent_nums 为空时，查询租户下所有已登录座席的状态

5、响应参数

名称 类型 说明
errcode Integer 状态码：0成功，其他非0错误码，详见错误码列表
errmsg String 状态说明
agentnum String 座席编号
reason String 变更原因。agent setup 座席主动设置 call out 外呼 call answer 接听 call end 通话结束 incoming call 座席来电 auto start 坐席会话时长开始 auto set 坐席会话时长超时
changetime String 状态变更时间
stateto String 座席通信状态：ready 空闲 busy 忙碌 0 小休 offline 离线
id String ID信息
statefrom String 座席上一个状态

6、使用样例

调用：
https://ykf.uincall.com/openapi/communication/number/skill?number=600439001&tenant_id=acf528a2-d0e2-xxxx-xxxx-74cb3995cfab&access_token=b57b2dc8edf583xxxxxd71d8a04d0df3

请求：

{
    "agent_nums":["8001","8002","8003","8004"]    
}

响应：

{
    "errcode": 0,
    "errmsg": "success",
    "data": [
        {
            "agentnum": "8014",
            "reason": "agent setup",
            "changetime": "2024-08-09 17:45:02",
            "stateto": "0",
            "id": "767a0e25-ca34-47f2-891e-062a95077dfd",
            "statefrom": "ready"
        },
        {
            "agentnum": "8010",
            "reason": "agent setup",
            "changetime": "2024-08-09 17:39:52",
            "stateto": "ready",
            "id": "ab326ea7-a8fb-4358-8402-1e95df3440d4",
            "statefrom": "ready"
        },
        {
            "agentnum": "8018",
            "reason": "agent setup",
            "changetime": "2024-08-09 17:45:01",
            "stateto": "busy",
            "id": "1f0b03ab-47ae-4c45-b8d9-d33363f7275e",
            "statefrom": "ready"
        },
        {
            "agentnum": "8004",
            "reason": "agent setup",
            "changetime": "2024-08-09 13:49:55",
            "stateto": "ready",
            "id": "a3ce5421-43f2-45b9-8147-d6e1d0886747",
            "statefrom": "ready"
        }
    ]
}
文档更新时间: 2024-09-24 14:30   作者：admin