企业微信群开发实战指南

做了几年独立开发，我越来越觉得：企业微信群不是一个可选项，而是很多B端产品的刚需基础设施。无论是告警通知、审批流转、日报推送，还是把小程序的能力嵌进团队协作流里，企业微信群都提供了成本最低、触达最快的通道。这篇文章聊聊我踩过的坑和实战经验。

为什么企业微信群开发如此重要

先讲结论：企业微信群的价值，在于它把「消息」和「人」放进了同一个已经活跃的容器里。

• 触达率高：相比邮件、短信、App推送，群消息几乎不会被忽略，团队成员本来就在里面协作。
• 开发成本低：一个 Webhook 地址就能发消息，不需要申请复杂的权限，不需要用户授权。
• 可交互：群机器人支持文本、Markdown、图文卡片、文件，甚至能通过回调实现双向交互。
• 场景天然：告警、审批、日报、监控、客服，几乎所有B端场景都能落到群里。

对企业客户来说，你的产品能不能「进群」，直接决定了它能不能融入他们的工作流。这就是我说它是刚需的原因。

群机器人：最快上手的方式

企业微信群机器人本质上就是一个 Webhook。你在群设置里添加机器人，拿到一个 URL，然后 POST 数据即可。

下面是一个最简的 Node.js 发送文本消息的例子：

const axios = require('axios');

const WEBHOOK = 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY';

async function sendText(content) {
  await axios.post(WEBHOOK, {
    msgtype: 'text',
    text: { content }
  });
}

sendText('部署完成，版本 v1.2.3 已上线');

如果要发 Markdown，把 msgtype 改成 markdown，内容放在 markdown.content 里就行。注意企业微信的 Markdown 语法是子集，不支持表格和部分标签，别照搬 GitHub 的写法。

常见消息类型

• text：纯文本，支持 @ 成员（用 mentioned_list）。
• markdown：富文本，适合告警和日报。
• news：图文卡片，适合推送文章或链接。
• file：先上传素材拿 media_id，再发送文件。
• template_card：交互卡片，可带按钮，做审批流很香。

@ 人和消息分片

告警场景里，@ 对应负责人是刚需。文本消息里可以这样写：

{
  "msgtype": "text",
  "text": {
    "content": "服务器 CPU 超过 90%",
    "mentioned_list": ["zhangsan", "@all"]
  }
}

注意 mentioned_list 填的是企业微信的 userid，不是昵称。另外，单条消息有长度限制（文本约 2048 字节），长内容要分片发送，否则会直接报错。

双向交互：回调与小程序

群机器人只能单向推送。如果你想让用户点按钮触发操作，就得用企业微信应用 + 回调，或者把小程序卡片发到群里。

我的做法是：机器人负责通知，卡片里挂一个小程序页面，用户点击后跳进小程序完成操作，操作结果再通过 Webhook 回推到群里。这样既绕开了复杂的回调配置，又保留了交互能力。

经验之谈：能用小程序卡片解决的，就别硬上回调。回调的验签、加解密、超时重试，维护成本比你想的高。

几个容易踩的坑

• 频率限制：每个机器人每分钟最多 20 条消息，超了会被限流。
• Webhook 泄露：key 一旦泄露，任何人都能往群里发消息。务必放在服务端，不要写进前端代码。
• Markdown 颜色：只支持 info、comment、warning 三种颜色，别指望自定义。
• 图片外链：图文消息的图片必须是公网可访问的 URL，本地路径无效。

总结

企业微信群开发的门槛很低，但要做好并不简单。它的重要性不在于技术难度，而在于它是连接你的产品和用户工作流的桥梁。先把群机器人用起来，跑通通知链路，再逐步加上卡片和小程序交互，你的B端产品会立刻显得「懂业务」很多。