服务端
服务端API文档

坐席登入

更新时间: 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),错误码列表请参考业务错误码

此文档是否对你有帮助?
有帮助
去反馈
  • 坐席登入
  • URL
  • 请求参数
  • 返回参数
  • 示例
  • 请求示例
  • 正常返回示例
  • 错误码