调用SignInGroup使坐席签入指定实例下的指定技能组,即坐席上线操作。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 实例 ID。 | ccc-test |
UserId | string | 否 | 坐席 ID,不填默认使用当前 RAM 账号映射的坐席。 | agent@ccc-test |
DeviceId | string | 是 | 语音设备 ID。当有多个语音设备可用时,通过此参数指定其中一个语音设备,比如浏览器 WebRTC 或者 SIP 话机等。 | CCC-xx.xx.xx.xx-chrome119-bse1b618bff3xxxxd |
SignedSkillGroupIdList | string | 是 | 想要签入的技能组 ID 列表,格式为 JSON 数组字符串,数组元素是技能组 ID。 | ["skillgroup1@ccc-test","skillgroup2@ccc-test"] |
ChatDeviceId | string | 否 | Chat 设备 ID。 | 4c51c9116c36537cb850dc1081d745df |
Additivity | boolean | 否 | 座席已经签入一些技能组后,如果指定此参数为 True, 则可以签入更多新技能组。 | false |
返回参数
示例
正常返回示例
JSON
格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
"Params": [
"无"
],
"Data": {
"Extension": "8032****",
"WorkMode": "ON_SITE",
"DeviceId": "ACC-YUNBS-1.0.10-****\n",
"JobId": "无",
"UserId": "agent@ccc-test",
"BreakCode": "Warm-up",
"InstanceId": "ccc-test",
"OutboundScenario": false,
"UserState": "READY",
"SignedSkillGroupIdList": [
"skillgroup1@ccc-test"
],
"ChatDeviceId": "4c51c9116c36537cb850dc1081d745df"
}
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心实例不存在。 |
404 | NotExists.UserId | The user %s does not exist in instance %s. | 呼叫中心实例中不存在指定的用户。 |
访问错误中心查看更多错误码。