企业官网建设流程全解析

首次接入可在 官网平台 完成注册与实例扫码，再回来对照本文发第一条测试消息。

适用场景

外部群主动发文本，是最基础、最高频的能力：告警一句话、工单状态一行字、会议提醒一段 plain text。文本消息结构简单、RPA 执行路径短，适合作为接入验证的第一条用例。

请求结构

统一走doApi网关，发文本常用method为/msg/sendText（以文档为准）：

{"method":"/msg/sendText","params":{"guid":"8f3a2b1c-xxxx-xxxx","told":"wrOgQhDgAAMmXxxxxxx","content":"【监控】CPU 使用率连续 5 分钟超过 85%，请值班同学关注。"}}

/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 文档 对应章节。