3 个参数搞定企业微信外部群主动发文本（doApi 实战）
首次接入可在 官网平台 完成注册与实例扫码，再回来对照本文发第一条测试消息。
适用场景
外部群主动发文本，是最基础、最高频的能力：告警一句话、工单状态一行字、会议提醒一段 plain text。文本消息结构简单、RPA 执行路径短，适合作为接入验证的第一条用例。
请求结构
统一走doApi网关，发文本常用method为/msg/sendText（以文档为准）：
{"method":"/msg/sendText","params":{"guid":"8f3a2b1c-xxxx-xxxx","told":"wrOgQhDgAAMmXxxxxxx","content":"【监控】CPU 使用率连续 5 分钟超过 85%，请值班同学关注。"}}| 字段 | 含义 | 外部群注意点 |
|---|---|---|
| guid | 执行实例 ID | 选可见该群且有权发言的实例 |
| told | 目标会话 ID | 填外部群 chat_id，不是 wm 开头的外部联系人 ID |
| content | 文本正文 | 支持\n换行；控制长度，过长改链接消息 |
/msg/sendText的完整请求/响应示例 → API 文档 · 消息发送
响应处理
典型成功响应：
{"code":0,"msg":"success","data":{}}业务侧应封装：
defsend_text_to_external_group(guid:str,chat_id:str,content:str)->None:data=gateway.call("/msg/sendText",{"guid":guid,"told":chat_id,"content":content,})outbox.mark_sent(chat_id,content_hash=sha256(content),raw=data)失败时根据code区分：参数错误不重试，超时/实例离线可有限重试。
发送前检查清单
- chat_id 来自群目录缓存，非手工输入群名
- guid 对应实例状态为 online
- 本条内容对应业务事件未发送过（幂等键）
- 测试环境先用专用测试外部群验证
与群发接口的区别
单群sendText适合事件驱动、一对一群的即时通知（某工单对应某客户群）。
msgList+toIdList的群发接口适合同一模板广播到多个外部群。两者不要混用：紧急单群告警用 sendText，周报广播用群发。
文本排版建议
【来源】工单系统 【单号】WO-20240610-001 【状态】已分配工程师 【说明】预计 2 小时内首次响应固定前缀便于群成员识别为系统消息，降低被当成垃圾信息的概率。
小结
外部群主动发文本 = 三个参数说清楚「谁发、发给哪个群、说什么」。把这条链路跑通并加上幂等与实例校验，就完成了主动发消息能力的地基。
下一步：多群同一模板发送时改用群发接口，字段差异见 API 文档 对应章节。