1.1 接口说明

在优音云客服系统中，可通过座席工号来查询座席信息。
目前4.2工单流出章节 1.4请求参数部分可获取座席工号。

1.2 调用形式

https://ykf.uincall.com/openapi/agent/detail?agent_num=xxxx&tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=670253572927b24acffc41078ddxxxxx

1.3 调用方式

GET

1.4 传入参数

序号 名称 类型 是否必填 说明
1 agent_num String 是 座席工号

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object数组 是 结果集（有数据时返回Object）
3.1 agent_name String 是 座席名称
3.2 agent_num String 是 座席工号
3.3 status String 是 0-禁用；1-启用；
3.4 role_names String 是 座席角色名称(多个以英文逗号分割)
3.5 dept_name String 是 部门名称
3.6 mobile String 是 座席手机号
3.7 mail String 是 座席邮箱
3.8 nickname String 是 座席昵称

1.6 使用样例

调用：

url：https://ykf.uincall.com/openapi/agent/detail?agent_num=1234&tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=670253572927b24acffc41078ddxxxxx

响应：

{
"errcode": 0,
"errmsg": "success",
"data": {
    "agent_name": "张三",
    "agent_num": "1234",
    "status": "1",
    "role_names": "座席,质检员",
    "dept_name": "销售部",
    "mobile": "13012345678",
    "mail": "13012345678@qq.com",
    "nickname": "哈尼"
    }
}

其他异常响应：

{
    "errcode": 140001,
    "errmsg": "座席工号不能为空"
}

{
    "errcode": 140003,
    "errmsg": "座席信息不存在"
}
文档更新时间: 2024-09-24 14:38   作者：admin