Name
QQ::weixin::work::message
DESCRIPTION
消息推送
FUNCTION
send(access_token, hash);
发送应用消息
SYNOPSIS
https://work.weixin.qq.com/api/doc/90000/90135/90236
请求说明:
请求包结构体为:
参数说明:
权限说明
如果部分接收人无权限或不存在,发送仍然执行,但会返回无效的部分(即invaliduser或invalidparty或invalidtag),常见的原因是接收人不在应用的可见范围内。
如果全部接收人无权限或不存在,则本次调用返回失败,errcode为81013。
返回包中的userid,不区分大小写,统一转为小写
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"invaliduser" : "userid1|userid2",
"invalidparty" : "partyid1|partyid2",
"invalidtag": "tagid1|tagid2"
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
update_taskcard(access_token, hash);
更新任务卡片消息状态
SYNOPSIS
https://work.weixin.qq.com/api/doc/90000/90135/91579
请求说明:
请求包结构体为:
{
"userids" : ["userid1","userid2"],
"agentid" : 1,
"task_id": "taskid122",
"clicked_key": "btn_key123"
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
userids 是 企业的成员ID列表(消息接收者,最多支持1000个)。
agentid 是 应用的agentid
task_id 是 发送任务卡片消息时指定的task_id
clicked_key 是 设置指定的按钮为选择状态,需要与发送消息时指定的btn:key一致
权限说明
系统应用须拥有邮件群组的写管理权限。
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"invaliduser" : ["userid1","userid2"], // 不区分大小写,返回的列表都统一转为小写
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
如果部分指定的用户无权限或不存在,更新仍然执行,但会返回无效的部分(即invaliduser),常见的原因是用户不在应用的可见范围内或者不在消息的接收范围内。
get_statistics(access_token, hash);
查询应用消息发送统计
SYNOPSIS
https://work.weixin.qq.com/api/doc/90000/90135/92369
请求说明:
请求包结构体为:
{
"time_type": 0
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
time_type 否 查询哪天的数据,0:当天;1:昨天。默认为0。
权限说明
无
RETURN 返回结果
{
"errcode": 0,
"errmsg": "ok",
"statistics": [
{
"agentid": 1000002,
"app_name": "应用1",
"count": 101
},
{
"agentid": 1000003,
"app_name": "应用2",
"count": 102
}
]
}
RETURN 参数说明
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
statistics.agentid 应用id
statistics.app_name 应用名
statistics.count 发消息成功人次