1.1 接口说明

在优音云客服系统中，可通过座席工号来查询座席信息。
注：在优音云客服系统中，可通过设置–>开发者中心,查看租户ID:tenant_id。

1.2 调用形式

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

1.3 调用方式

GET

1.4 传入参数

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

序号 名称 类型 是否必填 说明
1 tenant_id String 是 租户ID
2 access_token String 是 租户鉴权Token
3 agent_num String 是 座席编号

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Integer 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object数组 是 结果集（有数据时返回Object）
3.1 data.tenantId String 是 租户ID
3.2 data.explicitNumber String 是 外显号码
3.3 data.calloutToday String 是 当日已经呼叫次数
3.4 data.calloutLimit String 是 当日呼叫上限
3.5 data.area String 是 外显号归属地
3.6 data.alias String 是 外显号别名
3.7 data.isChoose Boolean 是 true 当前座席已选择的外显号码

1.6 使用样例

调用：

url：https://ykf.uincall.com/openapi/agent/explicitnumber?tenant_id=xxxx-d0e2-xxxx-74cb399xxxxx&access_token=xxxx927b24acffc41078ddxxxxx&agent_num=8xxx

响应：

    {
    "errcode": 0,
    "errmsg": "success",
    "data": [
        {
            "tenantId": "xxxx-d0e2-xxxx-74cb399xxxxx",
            "explicitNumber": "028xxxx8372",
            "calloutToday": "4",
            "calloutLimit": "1500",
            "area": "四川眉山",
            "alias": "优音客服",
            "isChoose": true
        }
    ]
}
文档更新时间: 2025-10-31 11:35   作者：admin