查询企微消息任务目标列表

根据任务 ID 查询企业微信消息任务的目标群体列表。需权限索引 4020。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
taskId	string	否	任务 ID	task_123456

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	提示信息	success
data	object[]	任务目标列表	[{"taskId":"12345","targetId":"wmxxxx001","status":3}]
└id	int64	任务目标记录 ID	987654
└ysfTenantGuid	string	云商租户 GUID	tenant-guid-001
└taskId	string	任务 ID	12345
└targetId	string	任务对象 ID，即客户或客户群 ID	wmxxxx001
└targetSerialNo	string	聊天对象序列号	target-serial-001
└resultJson	string	原始发送结果 JSON 字符串	[{"sendStatus":3,"sendStatusName":"发送成功"}]
└status	int32	任务目标状态	3
└createTime	int64	创建时间，毫秒时间戳	1720085400000
└updateTime	int64	更新时间，毫秒时间戳	1720087200000
└results	object[]	发送结果明细列表	[{"msgId":"msg_123456","msgNum":1,"contentId":"material_001","sendStatus":3}]
└msgId	string	消息 ID	msg_123456
└msgNum	int32	消息在任务内容中的序号	1
└contentId	string	内容 ID，即素材库素材 ID	material_001
└sendStatus	int32	发送状态：0-未发送、1-已发送、2-发送失败、3-发送成功	3
└failReason	string	失败原因，sendStatus=2 时返回	客户不是好友
└sendStatusName	string	发送状态名称	发送成功
└sendTime	int64	发送时间，毫秒时间戳	1720087200000

错误码

状态码	描述
14001	AppKey 不存在
14002	checksum 校验失败
14003	请求时间戳与服务器时间误差超过 10 分钟
14004	请求体 JSON 格式错误；无权限
14500	服务内部异常

postEndpoint

/openapi/wxwork/queryWxworkMsgTaskTargets

curl -X POST "https://qiyukf.com/openapi/wxwork/queryWxworkMsgTaskTargets?appKey=string&time=0&checksum=string" \  -H "Content-Type: application/json" \  -d '{}'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "taskId": "12345",
      "targetId": "wmxxxx001",
      "status": 3
    }
  ]
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体 JSON 格式错误；无权限"
}

{
  "code": 14500,
  "message": "服务内部异常"
}