企业微信应用推送消息

以下是企业微信应用推送消息的完整技术解析：

一、核心机制

应用权限需在企业微信后台创建自建应用，配置消息发送权限（范围精确到成员/部门）

凭证体系

CorpID（企业唯一标识）

Secret（应用密钥）

AccessToken（动态凭证，2小时有效期）

API接口统一使用 https://qyapi.weixin.qq.com/cgi-bin/message/send 接口

二、消息类型详解

文本消息支持@全员功能（需添加”@all”标签）和换行符

图文卡片

标题限制128字节

描述512字节

支持跳转URL和按钮文案自定义

文件消息需先通过素材接口上传获取media_id

模板卡片（交互增强型）

任务进度展示

按钮交互（支持回传参数）

二级文本区域

三、发送流程

图表代码下载9000201获取AccessToken构造消息体HTTPS POST请求返回码判断更新Token重试消息唯一ID记录

图表代码下载

图表代码下载

图表代码下载

图表代码

图表代码

图表

代码

下载

下载

下载

9000201获取AccessToken构造消息体HTTPS POST请求返回码判断更新Token重试消息唯一ID记录

9000201

9000201

获取AccessToken

获取AccessToken

构造消息体

构造消息体

HTTPS POST请求

HTTPS POST请求

返回码判断

返回码判断

更新Token重试

更新Token重试

消息唯一ID记录

消息唯一ID记录

四、关键限制

频率控制

应用上限：2000次/分钟

成员接收上限：30条/分钟

内容安全自动触发敏感词过滤（触发后返回码：60020）

回执机制可通过enable_id_trans开启已读未读状态跟踪

五、最佳实践

Token缓存推荐服务端维护Token池，避免频繁刷新

错误处理

40001（无效Token）：强制刷新凭证

41048（超出频率）：启用队列降级策略

移动端适配图文消息封面图尺寸建议：1068*455像素

六、典型场景

审批流程通知（带操作按钮）

服务器告警（支持多级@通知）

日程提醒（卡片式交互）

数据报表推送（定时发送）

七、调试工具

企业微信官方API调试工具

Postman脚本模板库

消息发送记录实时查询（管理后台）

注意：接收方未安装应用时，消息自动转为企业微信通知（非应用内消息）。跨企业通信需使用互联应用架构，需额外配置白名单。