1.1 接口说明

在优音云客服系统中，可通过座席工号和客户参数（客户姓名、客户手机号）来查询座席的座席的客户简要信息。
其中：座席工号(agent_num)可 登录云客服系统 或 4.2工单流出章节 1.4请求参数部分可获取。

1.2 调用形式

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

1.3 调用方式

POST

1.4 传入参数

非必填参数，调用接口时请传递参数名，参数值可为空

序号 名称 类型 是否必填 说明
1 agent_num String 是 管理员工号
2 customer_truename String 否 客户姓名(与customer_mobile二选一输入)
3 customer_mobile String 否 客户手机号(与customer_truename二选一输入)

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object数组 是 结果集（有数据时返回最新10条数据）
3.1 id String 是 客户唯一标识
3.2 truename String 是 客户真实姓名
3.3 mobile String 是 客户手机号

1.6 使用样例

调用：

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

POST数据：
{
    "agent_num": "1234",
    "customer_truename": "",
    "customer_mobile": "13112345xxx"
}

响应：

{
"errcode": 0,
"errmsg": "success",
"data": [
    {
        "id": "86cb546209e40e79c162e439c52xxxxx",
        "truename": "客户13112345xxx",
        "mobile": "13112345xxx"
    }
]
}
文档更新时间: 2024-09-24 14:34   作者：admin