企业微信通知小技巧

发表于 更新于

在日常工作和生活中，我们经常需要一个能够即时通知的工具，帮助我们实时监控某些事件或任务的状态，确保及时收到提醒。然而，许多通知工具都存在通知权限受限或功能单一无法定制化的问题。本文介绍一种通过企业微信实现几乎无限次的通知方法。此方法无需下载企业微信APP，只需借助微信插件，即可通过接口进行定制化通知。

企业微信通知实现

企业微信结合微信插件，用户无需额外下载企业微信客户端，就能通过该插件接收企业通知。只要你是企业微信的成员，就可以通过直接关注企业微信插件接收通知。这个方法不仅方便，还能保证通知的及时性和灵活性，适用于多种场景。

接口介绍

要通过接口实现通知，首先需要注册企业微信账号并获取API的访问权限。以下是常用的接口与操作步骤：

  • API文档地址: 企业微信API文档，即https://developer.work.weixin.qq.com/document/path/90236

企业微信的API支持多种通知类型，如文本、图片、文件、视频等。最常见的是文本通知，以下是一个通知发送的请求示例：

请求示例：

1
2
3
4
5
6
7
8
9
{
   "touser" : "UserID1|UserID2",
   "msgtype" : "text",
   "agentid" : 1,
   "text" : {
       "content" : "订单已确认，请尽快处理。"
   },
   "safe": 0
}

返回示例：

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

在接口参数中，touser 是指接收通知的企业微信成员ID。可以在企业微信管理后台的“通讯录”中找到各成员的唯一标识 UserID。

获取 ACCESS_TOKEN

所有的企业微信API接口调用都需要依赖 ACCESS_TOKEN，它相当于一个授权令牌，用于验证调用者的身份。获取该令牌的步骤如下：

请求地址：
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

  • corpid 是企业的唯一标识，可以在企业微信后台“我的企业”下查看。
  • corpsecret 是企业应用的密钥，确保企业数据安全，只有管理员才能获取。

python代码示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
def get_access_token():
    url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
    params = {
        "corpid": "your_corpid",
        "corpsecret": "your_corpsecret"
    }
    response = requests.get(url, params=params)
    token_data = response.json()
    return token_data.get("access_token")

def send_message_to_wechat(corp_id, corp_secret, user, title, description, url="https://example.com"):
    """发送企业微信通知消息"""
    access_token = get_access_token()
    
    if not access_token:
        print("无法获取有效的 access_token")
        return

    # 发送消息的 API URL
    api_url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}"

    # 消息内容定义
    message_data = {
        "touser": user,  # 接收消息的用户
        "msgtype": "textcard",  # 消息类型，这里使用 textcard（文本卡片）
        "agentid": 1,  # 企业应用的 agentid，需根据实际情况设置
        "textcard": {
            "title": title,  # 消息的标题
            "description": f"<div class='normal'>{description}</div>",  # 消息内容支持HTML格式
            "url": url  # 点击卡片后跳转的链接
        },
        "enable_id_trans": 0,
        "enable_duplicate_check": 1,  # 开启重复消息检查
        "duplicate_check_interval": 1800  # 重复消息检查的时间间隔，单位：秒
    }

    # 消息发送请求的重试机制，最多重试三次
    max_retries = 3
    for attempt in range(max_retries):
        try:
            response = requests.post(api_url, data=json.dumps(message_data), headers={"Content-Type": "application/json"})
            result = response.json()

            if result.get("errcode") == 0:
                print("消息发送成功")
                return result
            else:
                print(f"消息发送失败: {result.get('errmsg')}")
                if attempt < max_retries - 1:
                    print(f"重试 {attempt + 1} 次...")
                else:
                    print("已达最大重试次数，发送失败")
        except requests.RequestException as e:
            print(f"发送消息时出现网络错误: {e}")

通过这个 ACCESS_TOKEN，你就可以调用企业微信的相关接口来发送消息。

如何在微信中接收通知

企业微信注册后，系统会自动开通“微信插件”，这个插件是企业成员在微信中接收通知的载体。用户只需通过微信扫描企业提供的二维码，即可绑定插件，接收企业微信应用的消息通知。

在企业微信管理后台中，进入【管理后台 -> 我的企业 -> 微信插件】，你可以生成一个“邀请二维码”，让成员通过微信扫码关注插件。


使用场景与实用性

通过企业微信通知接口，用户可以实现几乎无限次的通知。以下是一些典型的应用场景：

  1. 订单提醒：当用户在电商平台下单时，系统可以通过接口直接调用微信通知接口，将订单信息第一时间推送到相关处理人员的微信上，帮助他们快速处理订单。

  2. 监控数据变动：如果你需要监控某个网站或系统的数据（如商品价格变动、库存变化、重要公告等），可以通过企业微信通知及时收到提醒，避免错过关键信息。

  3. 任务管理与提醒：企业内部可以通过此工具构建定制化的任务提醒系统，让员工及时处理待办任务，提高工作效率。

小结

通过企业微信与微信插件的结合，可以实现灵活、几乎无限次的通知功能。无论是个人用户，还是企业管理者，都可以根据自己的需求定制通知流程，确保任何关键事件都不会被遗漏。同时，该方法操作简单，用户无需下载额外应用，只需在微信中关注插件即可接收通知。希望本文的内容能够帮助你更好地利用企业微信来提升工作和生活效率。