企微管理
查询任务下某个客服的发送详情
查询指定员工在企业微信群发任务中的发送详情。msgId 和 sendUserId 必填,limit 取值范围 1-100。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| selfCorpId | string | 否 | 企微企业主体 ID,没有则取默认主体 | wx1234567890 |
| msgId | string | 是 | 消息任务 ID | msg_123456 |
| sendUserId | string | 是 | 发送者用户 ID | user_abc |
| limit | int32 | 是 | 每页数量,1-100 | 50 |
| cursor | string | 否 | 分页游标,首次查询不传 | cursor_token_abc |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | string | 提示信息 | success |
| data | object[] | 员工发送详情列表 | [{"targetId":"wmxxxx001","targetName":"李四","status":1}] |
| └targetId | string | 目标客户或客户群 ID | wmxxxx001 |
| └targetName | string | 目标客户名称 | 李四 |
| └sendUserId | string | 发送者企微用户 ID | zhangsan |
| └status | int32 | 发送状态:0-未发送、1-已发送、2-客户不是好友、3-客户已收到其他群发消息 | 1 |
| └sendTime | string | 发送时间字符串 | 2026-08-09 14:30:00 |
| nextCursor | string | 分页游标,用于获取下一页 | cursor_next_abc |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体 JSON 格式错误;参数无效(缺少 msgId/sendUserId 或 limit 超出范围) |
| 14500 | 服务内部异常 |
postEndpoint
/openapi/wxwork/queryWxworkMsgTaskStaffDetailcurl -X POST "https://qiyukf.com/openapi/wxwork/queryWxworkMsgTaskStaffDetail?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "msgId": "msg_123456", "sendUserId": "user_abc", "limit": 50 }'{
"code": 200,
"message": "success",
"data": [
{
"targetId": "wmxxxx001",
"targetName": "李四",
"status": 1
}
],
"nextCursor": "cursor_next_abc"
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体 JSON 格式错误;参数无效(缺少 msgId/sendUserId 或 limit 超出范围)"
}{
"code": 14500,
"message": "服务内部异常"
}这篇文档有帮助吗?