調(diào)用SignInGroup使坐席簽入指定實(shí)例下的指定技能組,即坐席上線操作。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無授權(quán)信息透出。
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 實(shí)例 ID。 | ccc-test |
UserId | string | 否 | 坐席 ID,不填默認(rèn)使用當(dāng)前 RAM 賬號(hào)映射的坐席。 | agent@ccc-test |
DeviceId | string | 是 | 語音設(shè)備 ID。當(dāng)有多個(gè)語音設(shè)備可用時(shí),通過此參數(shù)指定其中一個(gè)語音設(shè)備,比如瀏覽器 WebRTC 或者 SIP 話機(jī)等。 | CCC-xx.xx.xx.xx-chrome119-bse1b618bff3xxxxd |
SignedSkillGroupIdList | string | 是 | 想要簽入的技能組 ID 列表,格式為 JSON 數(shù)組字符串,數(shù)組元素是技能組 ID。 | ["skillgroup1@ccc-test","skillgroup2@ccc-test"] |
ChatDeviceId | string | 否 | Chat 設(shè)備 ID。 | 4c51c9116c36537cb850dc1081d745df |
Additivity | boolean | 否 | 座席已經(jīng)簽入一些技能組后,如果指定此參數(shù)為 True, 則可以簽入更多新技能組。 | false |
返回參數(shù)
示例
正常返回示例
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"
}
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
404 | NotExists.InstanceId | The specified instance %s does not exist. | 指定的呼叫中心實(shí)例不存在。 |
404 | NotExists.UserId | The user %s does not exist in instance %s. | 呼叫中心實(shí)例中不存在指定的用戶。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。