企业微信自动发送文本消息的实现与配置

实现业务系统与企微成员或客户的即时文字触达

能力介绍

发送文本消息是企微 API 中最基础且应用最广泛的能力。通过该接口，企业应用可以向指定的内部成员、部门或外部联系人下发纯文字信息。其核心价值在于实现业务通知的自动化，支持在文本中嵌入超链接、换行符以及特殊格式，确保关键信息能够以最轻量化的方式触达目标对象。

10 分钟接入 Demo

权限准备 ：在企微后台获取应用的 AgentId 和 Secret。
获取 AccessToken ：调用 /cgi-bin/gettoken 接口换取调用凭证。
确定接收人：
- 内部员工使用 userid。
- 外部客户使用 external_userid。
封装消息体：构建符合 JSON 规范的文本消息包。
发送请求：通过 POST 方式提交数据至消息发送接口。

API 示例代码

以下为向企业内部成员发送文本消息的 Python 示例：

python 复制代码

import requests
import json

def send_text_msg(access_token, to_user, content):
    url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}"
    payload = {
        "touser": to_user,          # 成员ID，多个用|分隔
        "msgtype": "text",
        "agentid": 1000002,         # 替换为实际应用的AgentId
        "text": {
            "content": content      # 消息内容，最长2048字节
        },
        "safe": 0                   # 是否保密消息
    }
    
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# result = send_text_msg("ACCESS_TOKEN", "ZhangSan", "您的差旅申请已审批通过。")

使用场景说明

系统监控通知：当后台服务出现异常或指标超过阈值时，自动向技术负责人发送纯文本告警。
办公协同提醒：在 OA 系统中，当有待办任务、会议邀请或合同签署节点时，即时触达相关责任人。
客户服务话术推送：当外部客户触发特定咨询关键词时，系统自动调取预设的标准文本回复。
业务状态更新：实时向用户推送订单发货、支付成功或物流变动的文字摘要。

FAQ

Q：文本消息支持换行吗？
- A：支持。在 content 字段中使用 \n 即可实现消息内容的换行显示。
Q：发送文本消息有字数限制吗？
- A：有。单个文本消息的最大长度为 2048 个字节（超过后建议拆分发送或使用图文消息）。
Q：为什么调用接口成功但手机端没提醒？
- A：请检查接收人是否在应用的可见范围内，以及该成员是否在手机端开启了该应用的通知权限。

引导入口

查看 API 文档

访问企微官网