微信企业消息推送

• 企业微信/企业 注册
• • 微信认证
  • 消息推送
  • • 服务
    • 企业微信数据接口
  • 后台开发

在软件程序实际应用中，在软件中推送可能还不能满足实际需求，需要把消息推送到用户手机，目前比较好的方式，可能是微信消息推送。因此做一个记录

企业微信/企业 注册

微信消息推送需要配合 企业微信 做消息推送

微信认证

消息推送

服务

1. text消息
2. image消息
3. voice消息
4. video消息
5. file消息
6. news消息
7. mpnews消息

text消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：text （支持消息型应用跟主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
content 是 消息内容，最长不超过2048个字节，注意：主页型应用推送的文本消息在微信端最多只显示20个字（包含中英文）
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

image消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：image（不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 图片媒体文件id，可以调用上传临时素材或者永久素材接口获取,永久素材media_id必须由发消息的应用创建
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

voice消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：voice （不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 语音文件id，可以调用上传临时素材或者永久素材接口获取
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

video消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：video （不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 视频媒体文件id，可以调用上传临时素材或者永久素材接口获取
title 否 视频消息的标题，不超过128个字节，超过会自动截断
description 否 视频消息的描述，不超过512个字节，超过会自动截断
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

file消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：file （不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 媒体文件id，可以调用上传临时素材或者永久素材接口获取
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

news消息

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：news （不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
articles 是 图文消息，一个图文消息支持1到8条图文
title 否 标题，不超过128个字节，超过会自动截断
description 否 描述，不超过512个字节，超过会自动截断
url 否 点击后跳转的链接。
picurl 否 图文消息的图片链接，支持JPG、PNG格式，较好的效果为大图640320，小图8080。如不填，在客户端不显示图片

mpnews消息

注：mpnews消息与news消息类似，不同的是图文消息内容存储在微信后台，并且支持保密选项。每个应用每天最多可以发送100次。

a)发送时直接带上mpnews内容：

b)发送时使用永久图文素材ID：

参数 必须 说明
touser 否 成员ID列表（消息接收者，多个接收者用‘|’分隔，最多支持1000个）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 部门ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
totag 否 标签ID列表，多个接收者用‘|’分隔，最多支持100个。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：mpnews （不支持主页型应用）
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 素材资源标识ID，通过上传永久图文素材接口获得。注：必须是在该agent下创建的。
safe 否 表示是否是保密消息，0表示否，1表示是，默认0

企业微信数据接口

消息类型
文本消息
图片消息
语音消息
视频消息
文件消息
文本卡片消息
图文消息
图文消息（mpnews）

应用支持推送文本、图片、视频、文件、图文等类型。

请求方式：POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/message/sendcess_token=ACCESS_TOKEN

参数说明：

参数 是否必须 说明
access_token 是 调用接口凭证
各个消息类型的具体POST格式请阅后续“消息类型”部分。
如果有在管理端对应用设置“在微工作台中始终进入主页”，应用在微信端只能接收到文本消息，并且文本消息的长度限制为20字节，超过20字节会被截断。同时其他消息类型也会转换为文本消息，提示用户到企业微信查看。
支持id转译，将userid/部门id转成对应的用户名/部门名，目前仅文本/文本卡片/图文/图文（mpnews）这四种消息类型的部分字段支持。具体支持的范围和语法，请查看附录id转译说明。
支持重复消息检查，当指定 “enable_duplicate_check”: 1开启: 表示在一定时间间隔内，同样内容（请求json）的消息，不会重复收到；时间间隔可通过duplicate_check_interval指定，默认1800秒。
返回示例：

如果部分接收人无权限或不存在，发送仍然执行，但会返回无效的部分（即invaliduser或invalidparty或invalidtag），常见的原因是接收人不在应用的可见范围内。
如果全部接收人无权限或不存在，则本次调用返回失败，errcode为81013。

后台开发

选择第三方推送工具或者自己开发消息推送后台

开发实现案例
1、微信企业 下的消息推送
2、微信企业 开发:主动发送消息