企业官网建设流程全解析

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

能力介绍

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

10 分钟接入 Demo

1. 权限准备：在企微后台获取应用的AgentId和Secret。

2. 获取 AccessToken：调用/cgi-bin/gettoken接口换取调用凭证。

3. 确定接收人：

   • 内部员工使用userid。

   • 外部客户使用external_userid。

4. 封装消息体：构建符合 JSON 规范的文本消息包。

5. 发送请求：通过 POST 方式提交数据至消息发送接口。

API 示例代码

以下为向企业内部成员发送文本消息的 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 文档

访问企微官网