Python调用企业微信API发送告警通知实战

Ruby

发布时间：2026-10-15 | 6人浏览过

原创

本文详解如何利用Python调用企业微信API实现自动告警通知。内容涵盖在企业微信后台创建应用、获取CorpID与Secret密钥，并通过gettoken接口获取Access Token，最终调用message/send接口向指定成员或部门发送结构化消息。

前言

常见的系统通知渠道包括邮件、电话、短信及微信等。其中，短信和电话通常涉及费用，使用频率相对较低；邮件适合发送附带文件的正式通知，便于归档保存；而微信通知则因其便捷性，更适用于即时告警场景。本文所指的微信特指企业微信。

这里说的微信，是企业微信。

本文目的：通过企业微信应用给企业成员发消息。

如何实现企业微信通知？

1、新建应用

登录网页版企业微信 (https://work.weixin.qq.com)，点击应用管理 → 应用 → 创建应用

上传应用的 logo，输入应用名称（债券打新），再选择可见范围，成功创建一个告警应用

2、获取Secret

使用 Python 发送告警请求，其实就只使用到两个接口：

获取 Token ：

https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={secret}

发送请求：

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={token}

可以看到，最重要的是 corpid 和 secret：

corpid：唯一标识你的企业

secret：应用级的密钥，有了它程序才知道你要发送该企业的哪个应用

corpid 可以通过我的企业 → 企业信息 → 企业id 获取

secret 可以通过点击新创建的应用（债券打新） → 查看 secret → 发送来获取

最后将 corpid 和 secret 填入下面的常量中。

3、代码实现

import json
import time
import requests
'''
本文件主要实现通过企业微信应用给企业成员发消息

CORP_ID = "xxxx"
SECRET = "xxxx"

class WeChatPub:
    s = requests.session()

    def __init__(self):
        self.token = self.get_token()

    def get_token(self):
        url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CORP_ID}&corpsecret={SECRET}"
        rep = self.s.get(url)
        if rep.status_code != 200:
            print("request failed.")
            return
        return json.loads(rep.content)['access_token']

    def send_msg(self, content):
        url = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=" + self.token
        header = {
            "Content-Type": "application/json"
        }
        form_data = {
            "touser": "FengXianMei",#接收人
            "toparty": "1",#接收部门
            "totag": " TagID1 | TagID2 ",#通讯录标签id
            "msgtype": "textcard",
            "agentid": 1000002,#应用ID
            "textcard": {
                "title": "债券打新提醒",
                "description": content,
                "url": "URL",
                "btntxt": "更多"
            },
            "safe": 0
        rep = self.s.post(url, data=json.dumps(form_data).encode('utf-8'), headers=header)
        return json.loads(rep.content)

if __name__ == "__main__":
    wechat = WeChatPub()
    timenow = time.strftime("%Y-%m-%d %H:%M:%S",time.localtime())
    wechat.send_msg(f"<div class=\"gray\">{timenow}</div> <div class=\"normal\">注意！</div><div class=\"highlight\">今日有新债，坚持打新！</div>")
    print('消息已发送！')