ListWaitingChats - 获取队列中的聊天_云联络中心(Cloud Contact Center)-阿里云帮助中心

坐席通过ListWaitingChats获取队列中等待分配或认领的聊天。

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	ccc-test
SkillGroupIdList	string	是	技能组 ID 列表。	["skillgroup1@ccc-test", "skillgroup2@ccc-test"]

返回参数

名称	类型	描述	示例值
	object
Code	string	响应码。	OK
HttpStatusCode	integer	HTTP 状态码。	200
Message	string	响应信息。	无
RequestId	string	请求 ID。	03C67DAD-EB26-41D8-949D-9B0C470FB716
Data	array<object>	返回数据。
Chat	object	会话信息。
ChatConversationId	string	聊天会话 ID。	$23086709$EAUNIT
BeingAssigned	boolean	会话是否已分配坐席。	false
JobId	string	话务 ID。	chat-434537064047960064
EnqueueTime	long	进入队列时刻，格式为 Unix 时间戳，单位毫秒。	1718868572094
AccessChannelId	string	网络业务渠道 ID。	843073c2-*****-49fb-a616-738ddddfebdc
AccessChannelType	string	网络业务渠道类型。	Web
UserList	array<object>	用户列表。
User	object	用户。
UserName	string	用户姓名。	访客-1c***
UserId	string	用户 ID。	c361765f-******-4e07-b81c-4b5d9183fac6
UserType	string	用户类型。	CUSTOMER
AvatarUrl	string	头像链接。	无
Messages	array<object>	消息列表。
Message	object
SenderId	string	消息发送用户 ID。	c361765f-******-4e07-b81c-4b5d9183fac6
Content	string	内容信息。	测试消息
SenderType	string	发送方类型。取值： CUSTOMER：访客 AGENT：坐席	{"variables":{},"text":"<p>这种的名片选单面还是双面</p>"}
SkillGroupId	string	技能组信息。	skill@ccc-test

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "03C67DAD-EB26-41D8-949D-9B0C470FB716",
  "Data": [
    {
      "ChatConversationId": "$23086709$EAUNIT",
      "BeingAssigned": false,
      "JobId": "chat-434537064047960064",
      "EnqueueTime": 1718868572094,
      "AccessChannelId": "843073c2-*****-49fb-a616-738ddddfebdc",
      "AccessChannelType": "Web",
      "UserList": [
        {
          "UserName": "访客-1c***",
          "UserId": "c361765f-******-4e07-b81c-4b5d9183fac6\n",
          "UserType": "CUSTOMER",
          "AvatarUrl": "无"
        }
      ],
      "Messages": [
        {
          "SenderId": "c361765f-******-4e07-b81c-4b5d9183fac6",
          "Content": "测试消息",
          "SenderType": "{\"variables\":{},\"text\":\"<p>这种的名片选单面还是双面</p>\"}"
        }
      ],
      "SkillGroupId": "skill@ccc-test"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	Parameter.Maximum	The parameter %s must be less than or equal to %s.	参数必须小于或等于系统规定的最大值。
400	Parameter.Minimum	The parameter %s must be greater than or equal to %s.	参数必须大于或等于系统规定的最小值。
400	Parameter.Blank	The parameter %s must not be null or empty.	该参数不能为null值。
400	Parameter.Null	The parameter %s may not be null.	该参数不能为null值.
404	NotExists.InstanceId	The specified instance %s does not exist.	指定的呼叫中心实例不存在。

访问错误中心查看更多错误码。