首页 云呼叫中心 API参考 API目录 话务 SignInGroup - 签入技能组

SignInGroup - 签入技能组

调用SignInGroup使坐席签入指定实例下的指定技能组，即坐席上线操作。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring是

实例ID。

ccc-test
UserIdstring否

坐席ID，不填默认使用当前RAM账号映射的坐席。

agent@ccc-test
DeviceIdstring是

设备ID，无意义，可以随便填写。

device
SignedSkillGroupIdListstring是

想要签入的技能组ID列表，格式为JSON数组字符串，数组元素是技能组ID。

["skillgroup1@ccc-test","skillgroup2@ccc-test"]

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP状态码。

200
Messagestring

响应信息。

无
RequestIdstring

请求ID。

EEEE671A-3E24-4A04-81E6-6C4F5B39DF75
Paramsarray

响应参数列表。

string

响应参数。

无
Dataobject

数据。

Extensionstring

坐席分机号。

8032****
WorkModestring

工作模式。

枚举值：
  • ON_SITE：场内模式。
  • OFF_SITE：场外模式。
  • OFFICE_PHONE：办公电话模式。
ON_SITE
DeviceIdstring

设备ID，浏览器WebRTC软电话或实体话机设备的标识ID，同一时间只允许一种设备注册。

ACC-YUNBS-1.0.10-****
JobIdstring

通话ID。

无
UserIdstring

坐席ID。

agent@ccc-test
BreakCodestring

小休状态码，分为系统定义的和客户定义的两种，系统定义的小休吗包括：Warm-up （坐席上线后置闲前的临时小休状态）、RingingTimeout（坐席振铃超时导致的小休）、RejectCall（坐席拒接导致的小休）。客户自定义状态码没有限制，客户可以根据业务需要自行定义。

Warm-up
InstanceIdstring

实例ID。

ccc-test
OutboundScenarioboolean

坐席是否处于仅外呼模式。

false
UserStatestring

座席状态。

枚举值：
  • READY：空闲。
  • WORKING：话后处理中。
  • DIALING：拨号中。
  • BREAK：小休。
  • OFFLINE：离线。
  • TALKING：通话中。
  • RINGING：振铃中。
READY
SignedSkillGroupIdListarray

坐席签入的技能组ID列表。

string

技能组ID。

skillgroup1@ccc-test

示例

正常返回示例

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": true,
    "UserState": "READY",
    "SignedSkillGroupIdList": [
      "skillgroup1@ccc-test"
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
404NotExists.InstanceIdThe specified instance %s does not exist.指定的呼叫中心实例不存在。
404NotExists.UserIdThe user %s does not exist in instance %s.呼叫中心实例中不存在指定的用户。

访问错误中心查看更多错误码。
阿里云首页 云呼叫中心 相关技术圈