1.1 接口说明

可通过该接口实现座席单点登录。(通过该接口获取的登录地址有效期为120秒,同时只能登录一次)
注:在优音云客服系统中,可通过设置–>开发者中心,查看租户ID:tenant_id。

1.2 调用URL

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

1.3 调用方式

POST

1.4 传入参数

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

名称 类型 是否必填 说明
agent_num String 座席编号
mode Integer 登录方式 枚举如下:1-手机 2-SIP话机 4-插件 6-在线客服 7-SIM卡话机 8-SIP软电话
agent_state String 座席状态 “busy”为忙碌 “ready”为空闲

1.5 回应参数

名称 类型 说明
errcode Integer 状态码:0成功,其他非0错误码,详见错误码列表
errmsg String 状态说明
data JsonObject 响应数据
data.url String 登录地址,浏览器直接访问即可实现登录

1.6 使用样例

调用:

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

请求体:

{
    "agent_num": "1003",
    "mode": 6,
    "agent_state":"ready"
}

响应:

{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "url": "https://ykf.uincall.com/agentSSOLogin.html?tenant_id=acf528a2-d0e2-4a7b-8513-74cb3995cfab&agent_num=1003&mode=6&sso_token=eyJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRfaWQiOiJhY2Y1MjhhMi1kMGUyLTRhN2ItODUxMy03NGNiMzk5NWNmYWIiLCJtb2RlIjo2LCJhZ2VudF9udW0iOiIxMDAzIiwiaWF0IjoxNzA5NzkzNTcyLCJleHAiOjE3MDk4Nzk5NzJ9.7fimSlpbqa8GPcXPyNfq8tA0sbbZ9uXXjdU8c2uNLng"
    }
}
文档更新时间: 2024-09-24 14:26   作者:admin