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 开头的外部联系人 IDcontent文本正文支持\n换行控制长度过长改链接消息/msg/sendText的完整请求/响应示例 → API 文档 · 消息发送响应处理典型成功响应{code:0,msg:success,data:{}}业务侧应封装defsend_text_to_external_group(guid:str,chat_id:str,content:str)-None:datagateway.call(/msg/sendText,{guid:guid,told:chat_id,content:content,})outbox.mark_sent(chat_id,content_hashsha256(content),rawdata)失败时根据code区分参数错误不重试超时/实例离线可有限重试。发送前检查清单chat_id 来自群目录缓存非手工输入群名guid 对应实例状态为 online本条内容对应业务事件未发送过幂等键测试环境先用专用测试外部群验证与群发接口的区别单群sendText适合事件驱动、一对一群的即时通知某工单对应某客户群。msgListtoIdList的群发接口适合同一模板广播到多个外部群。两者不要混用紧急单群告警用 sendText周报广播用群发。文本排版建议【来源】工单系统 【单号】WO-20240610-001 【状态】已分配工程师 【说明】预计 2 小时内首次响应固定前缀便于群成员识别为系统消息降低被当成垃圾信息的概率。小结外部群主动发文本 三个参数说清楚「谁发、发给哪个群、说什么」。把这条链路跑通并加上幂等与实例校验就完成了主动发消息能力的地基。下一步多群同一模板发送时改用群发接口字段差异见 API 文档 对应章节。