七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
企微管理

查询任务下某个客服的发送详情

查询指定员工在企业微信群发任务中的发送详情。msgId 和 sendUserId 必填,limit 取值范围 1-100。

请求参数

名称类型必填描述示例值
appKeystring是应用 AppKey
timeint64是请求时间戳(秒)
checksumstring是请求签名校验和
checksumAlgorithmint32否签名算法:0 - 默认(SHA1),1 - SHA256

请求体

名称类型必填描述示例值
selfCorpIdstring否企微企业主体 ID,没有则取默认主体wx1234567890
msgIdstring是消息任务 IDmsg_123456
sendUserIdstring是发送者用户 IDuser_abc
limitint32是每页数量,1-10050
cursorstring否分页游标,首次查询不传cursor_token_abc

返回参数

名称类型描述示例值
codeint32状态码,200 表示成功200
messagestring提示信息success
dataobject[]员工发送详情列表[{"targetId":"wmxxxx001","targetName":"李四","status":1}]
└targetIdstring目标客户或客户群 IDwmxxxx001
└targetNamestring目标客户名称李四
└sendUserIdstring发送者企微用户 IDzhangsan
└statusint32发送状态:0-未发送、1-已发送、2-客户不是好友、3-客户已收到其他群发消息1
└sendTimestring发送时间字符串2026-08-09 14:30:00
nextCursorstring分页游标,用于获取下一页cursor_next_abc

错误码

状态码描述
14001AppKey 不存在
14002checksum 校验失败
14003请求时间戳与服务器时间误差超过 10 分钟
14004请求体 JSON 格式错误;参数无效(缺少 msgId/sendUserId 或 limit 超出范围)
14500服务内部异常
postEndpoint
/openapi/wxwork/queryWxworkMsgTaskStaffDetail
POST
/openapi/wxwork/queryWxworkMsgTaskStaffDetail
curl -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": "服务内部异常"
}

这篇文档有帮助吗?