企业微信自建应用通知教程：把应用管理做成消息渠道

首页图片#

一、先说它适合做什么#

企业微信自建应用，最适合拿来做这类通知：

• 服务器运行结果通知
• 定时任务成功 / 失败提醒
• 域名、证书、监控告警
• 面板后台消息推送
• 订单、工单、审批类内部通知

它的好处是比较稳定，因为本质上走的是企业微信官方应用消息接口，不是靠网页硬跳某个个人号。

二、后台入口在哪里#

先登录企业微信管理后台：

• 企业微信后台：https://work.weixin.qq.com/

然后按下面路径进入：

1
应用管理 → 自建 → 创建应用

创建时一般会让你填写：

• 应用名称
• 应用 Logo
• 可见范围

这里有一个很关键的点：

你后面要接收通知的人，必须在这个应用的可见范围里。

否则程序消息是发不进去的。

三、创建完以后要记住哪几个值#

创建好自建应用后，后面最常用的是这 3 个：

• CorpID：企业 ID
• AgentID：应用 ID
• Secret：这个自建应用自己的密钥

这 3 个里最容易拿错的是 Secret。

注意：

• 不是随便拿一个企业级密钥
• 不是通讯录同步 secret
• 必须是这个自建应用自己的 Secret

四、接收通知的人怎么确定#

程序发消息时，通常还需要一个接收人标识，也就是：

• UserID

这里不要直接写成员姓名。

要用的是企业微信成员对应的 UserID。
如果你不确定，可以在通讯录里查看成员详情，或者通过接口读取成员信息。

官方成员读取文档：

• 读取成员：https://work.weixin.qq.com/api/doc/90000/90135/90196

五、程序发送通知的基本流程#

整个流程其实很简单，就两步：

1
GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CorpID&corpsecret=你的Secret

1
POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

1
{
2
  "touser": "zhangsan",
3
  "msgtype": "text",
4
  "agentid": 1000002,
5
  "text": {
6
    "content": "这是一条测试通知"
7
  },
8
  "safe": 0
9
}

六、用 curl 测试一遍#

如果你想最快确认通不通，先直接用 curl。

1
curl "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=你的CorpID&corpsecret=你的Secret"

1
{
2
  "errcode": 0,
3
  "errmsg": "ok",
4
  "access_token": "xxxxx",
5
  "expires_in": 7200
6
}

1
curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=你的ACCESS_TOKEN" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
    "touser": "zhangsan",
5
    "msgtype": "text",
6
    "agentid": 1000002,
7
    "text": {
8
      "content": "企业微信通知测试成功"
9
    },
10
    "safe": 0
11
  }'

1
{
2
  "errcode": 0,
3
  "errmsg": "ok"
4
}

七、Node.js 示例#

如果你是自己写后台，下面这个 Node.js 示例基本就够用了。

1
const axios = require("axios");
2

3
async function sendWecomText() {
4
  const corpId = "你的CorpID";
5
  const secret = "你的Secret";
6
  const agentId = 1000002;
7
  const toUser = "zhangsan";
8

9
  const tokenResp = await axios.get(
10
    "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
11
    {
12
      params: {
13
        corpid: corpId,
14
        corpsecret: secret,
15
      },
16
    }
17
  );
18

19
  const accessToken = tokenResp.data.access_token;
20

21
  const sendResp = await axios.post(
22
    `https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=${accessToken}`,
23
    {
24
      touser: toUser,
25
      msgtype: "text",
26
      agentid: agentId,
27
      text: {
28
        content: "这是一条来自自建应用的通知",
29
      },
30
      safe: 0,
31
    }
32
  );
33

34
  console.log(sendResp.data);
35
}
36

37
sendWecomText().catch(console.error);

八、做成“通知渠道”时怎么理解#

如果你是在做自己的项目后台，其实可以把企业微信自建应用理解成一个标准通知渠道：

• 配置区保存 CorpID
• 配置区保存 AgentID
• 配置区保存 Secret
• 配置区保存默认接收人 UserID
• 发送通知时先获取 token，再发消息

也就是说，它和邮箱通知、Telegram Bot 通知、本质上是同一类东西：

都是你系统里的一个消息出口。

九、最容易踩坑的地方#

这里我把最常见的问题直接列出来。

十、适合接到哪些项目里#

如果你手里有这些项目，都很适合直接接企业微信通知：

• 面板项目
• 域名监控
• 备份脚本
• 定时抓取任务
• Docker 容器巡检
• 证书到期提醒

尤其是内部项目、自己团队用的项目，这种方式会比个人微信方案稳定很多。

官方参考#

• 企业微信后台：https://work.weixin.qq.com/
• 企业微信开发者中心：https://developer.work.weixin.qq.com/document
• 获取 access_token：https://work.weixin.qq.com/api/doc/90000/90135/91039
• 发送应用消息：https://work.weixin.qq.com/api/doc/90000/90135/90236
• 读取成员：https://work.weixin.qq.com/api/doc/90000/90135/90196