1. 引言
企微二次开发里，坐席回复、欢迎语、SOP 触达最后都落在发消息。高频搜索是「企业微信发消息接口」「企业微信发图片API」「企业微信发文件接口」。
2. 企微出站消息
企业微信侧通常覆盖文本、图片、文件等类型，统一走 REST 入口，用method区分操作。发送通道用QIWe API。不要把外部联系人 ID 和群 ID 填错字段。
3. 文本消息
defqiwe_send_text(guid:str,to_id:str,content:str)->dict:returnrequests.post("http://manager.qiweapi.com/qiwe/api/qw/doApi",headers={"X-QIWEI-TOKEN":TOKEN,"Content-Type":"application/json"},json={"method":"/msg/sendText","params":{"guid":guid,"told":to_id,"content":content}},timeout=10,).json()Header 为X-QIWEI-TOKEN。测试对象用内部测试客户，不要直接打正式客户。
4. 图片与文件
先确保资源可被通道访问（上传或合法 URL），再调对应 method。业务层拦截超大文件；发送成功落msgId；失败要区分掉线、不是好友、内容拦截。
5. 发送保护
- 单客户最短间隔
- 单
guid每分钟上限 - 坐席手动发送与 SOP 自动发送共用配额
- OFFLINE 熔断，禁止继续群发
消息模块的 method 名称与字段，以 QiWe API文档（https://doc.qiweapi.com/）为准。先文本、再图片文件，对照文档比抄第三方博客更不容易发失败。
6. 发送字段
QIWe API用guid+ 外部联系人/群 ID。业务做成send(to, msg_type, payload)，企微工作台只走这一套字段。
7. 总结
企业微信发消息对齐三件事：Token、设备 guid、目标客户 ID。发送层把限速和掉线当成基础设施，SOP 才敢自动跑。
