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	发消息成功人次