企业微信外部群发送消息API：文本、图片、文件接口怎么接

梦想的旅途22026-08-28 8:21

1. 引言

企微二次开发里，坐席回复、欢迎语、SOP 触达最后都落在发消息。高频搜索是「企业微信发消息接口」「企业微信发图片API」「企业微信发文件接口」。

2. 企微出站消息

企业微信侧通常覆盖文本、图片、文件等类型，统一走 REST 入口，用 method 区分操作。发送通道用 QIWe API。不要把外部联系人 ID 和群 ID 填错字段。

3. 文本消息

python 复制代码

def qiwe_send_text(guid: str, to_id: str, content: str) -> dict:
    return requests.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 才敢自动跑。