企业微信应用消息推送：实现高效信息触达

核心功能：发送文本消息

---

能力介绍

发送文本消息 是 QiWe API 中最基础且最高频使用的接口。它允许开发者通过自建应用或代开发应用，向企业成员发送纯文本通知。其核心价值在于低延迟 与高送达率，支持指定成员、部门或标签进行精准推送。

10 分钟接入 Demo

1. 获取凭证 ：登录企微后台或 QiWe 管理面板，获取 AppID 和 AppSecret。

2. 获取 Token ：调用鉴权接口获取 access_token（有效期 2 小时）。

3. 确定接收者 ：获取目标用户的 UserId（如 ZhongGong）。

4. 调用接口 ：构建 JSON 报文，向 POST /message/send 终点发送请求。

5. 验证结果 ：检查返回码 errcode 是否为 0。

API 示例代码

以下为基于 Python 的标准调用示例：

import requests
import json

def send_text_message(access_token, user_id, content):
    url = f"https://api.qiweapi.com/cgi-bin/message/send?access_token={access_token}"
    
    payload = {
        "touser": user_id,        # 成员ID列表，多个用|分隔
        "msgtype": "text",       # 消息类型
        "agentid": 1000002,      # 企业应用的id
        "text": {
            "content": content   # 消息内容，最长2048字节
        },
        "safe": 0                # 表示是否保密消息，0表示否
    }
    
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# res = send_text_message("YOUR_TOKEN", "UserID_1", "您好，这是来自系统的技术通知。")
# print(res)

使用场景说明

• 系统告警通知：当服务器负载过高或接口异常时，即时推送文本信息给运维人员。

• 流程审批提醒：OA 系统中有新待办事项时，自动通知相关负责人处理。

• 会议通知：在会议开始前 15 分钟，向参会人员发送地点与时间提醒。

FAQ

• Q：消息发送成功了，但手机端没收到？

  • A：请检查该成员是否在应用的"可见范围"内，且未开启"消息免打扰"。

• Q：文本内容支持换行吗？

  • A：支持。在 content 字符串中使用 \n 即可实现换行。

• Q：限制频率是多少？

  • A：每分钟频率限制较高，但建议大批量推送时采用异步队列，避免触发瞬时限流。

---

引导入口

• 查看完整文档 ：QiWe API 文档 - 发送应用消息

• 企微官网 ：QiWe 官网