当前位置：首页 > news >正文

企业微信开发：外部群消息推送的“三步走”逻辑

news 2026/5/11 21:05:50

在企业微信中，向外部群推送消息主要通过“自建应用”调用“群聊会话（Appchat）”接口来实现。

第一步：身份准入（拿到通行证）

在调用任何接口前，你的程序必须证明自己是合法的。

核心参数：你需要企业后台的Corpid和自建应用的Secret。
技术动作：通过这两个参数向服务器请求access_token。
通俗理解：就像去办事大厅领一张“临时准入证”，这张证有效期通常是2小时，过期需要重新领。

第二步：定位群聊（找到门牌号）

你想往哪个群发消息？在代码世界里，群的名字（如“VIP客户交流群”）是不作数的，你需要它的chatid。

如何获取： 1. 如果是通过 API 创建的群，接口会直接返回 chatid。
2. 如果是已有的群，需要配置“接收消息服务器”，当群里有变动时，企业微信会将包含 chatid 的信息推送到你的服务器。
通俗理解：即使群名天天改，chatid也是唯一的身份证号，必须先在数据库里存好它。

第三步：构造内容并投递（发送信件）

有了准入证和门牌号，就可以发送消息了。

接口地址：https://qyapi.weixin.qq.com/cgi-bin/appchat/send
支持类型：文字、图片、语音、视频、文件，以及更好看的“图文卡片”。
通俗理解：把你要说的话打包成 JSON 格式的“包裹”，发给接口。如果返回errcode: 0，就说明发送成功了。

开发者必须避开的三个“坑”

1. 频率限制（不要做复读机）

外部群推送有严格的频率限制。如果你的程序短时间内疯狂发消息，接口会报错（错误码45009）。

建议：在代码中加入“发送队列”，比如每秒只发 1-2 条，细水长流。

2. 外部联系人权限

只有当群聊中包含“由当前应用建立联系的外部联系人”或者群是由该应用创建时，推送才更稳定。如果应用和群完全没关系，消息是发不进去的。

3. 内容合法性

推送的消息如果包含敏感词、诱导分享等内容，可能会被系统拦截。虽然接口返回成功，但群里可能看不见。

为什么推荐使用“文本卡片（Textcard）”？

在做二次开发时，相比普通的纯文字，文本卡片更适合业务场景：

结构清晰：有标题、描述和链接。
直接交互：用户点击卡片可以直接跳转到你的 H5 页面或小程序，处理业务流程更顺畅

// 一个典型的卡片消息结构 { "chatid": "WRKxxxxx", "msgtype": "textcard", "textcard": { "title": "待办任务提醒", "description": "您有一个新的客户咨询需要处理，请点击查看", "url": "https://your.domain.com/task", "btntxt": "点击处理" } }