坐席登入
更新时间: 2022/08/19 09:10:32
坐席登入
- 调用坐席登陆前,一定要保证终端已经初始化(sip话机/websdk),不然会坐席上线失败,由于终端(sip话机/websdk)和坐席两个接口不是同步的,一般建议终端登陆成功后,7s后再调用坐席上线接口
URL
- 请求方法:POST
- URL:
http://voip-host/api/v1/voip/cti/app/seat/in
请求参数
参数名称 | 类型 | 是否必选 | 示例 | 描述 |
appId | string | 必填 | eca23f68c66d4acfceee77c200200359 | 应用ID。 |
phone | string | 选填 | 15700084166 | 坐席绑定的手机号码,如果绑定了手机号,会切换为坐席手机在线模式,即呼入转到当前的坐席,会呼叫到绑定的手机号上。 |
queueServiceId | string | 必填 | 22222 | 队列ID,需要用户先创建队列,坐席登陆会将坐席放入这个队列中,当呼叫入队的时候,如果当前的坐席是空闲的,会直接取出使用。 |
sipAccount | string | 必填 | 266080000000002 | 坐席sip帐号。 |
seatId | string | 必填 | 12345 | 坐席ID,只能是数字串,且非零开头。 |
state | int | 必填 | 0 | 坐席状态,1忙碌状态,不允许接电话.允许外呼,2空闲状态,允许外呼和接电话。 |
返回参数
参数名称 | 类型 | 示例 | 描述 |
code | int | 0 | 状态码。 |
message | string | OK | 请求成功或者失败描述信息。 |
示例
请求示例
{
"answerType": 0,
"appId": "eca23f68c66d4acfceee77c200200359",
"force": 0,
"phone": "15700084166",
"queueServiceId": "888888",
"sipAccount": "266080000000002",
"seatId": "123456serid",
"state": 2
}
正常返回示例
{
"code": 0,
"message": "OK"
}
错误码
-
body 中的错误码(code)
该接口在 HTTP Body 中返回错误码(code),错误码列表请参考业务错误码。
此文档是否对你有帮助?