企业微信外部群消息推送实战指南

核心逻辑:外部群消息推送的两种方式

  1. Webhook 机器人方式(最简单):

    • 场景:手动在群里添加机器人,获取 Webhook 地址。

    • 限制:需要群主开启机器人权限,且外部群可能不支持直接添加(需开启"外部群插件")。

  2. 应用 API 方式(最专业):

    • 场景 :通过自建应用,利用 chat_id 主动推送。

    • 限制 :需要先通过接口获取 chat_id,且该应用必须在客户联系的业务范围内。


代码实现示例

以下均以 应用 API 方式 (/cgi-bin/appchat/send) 为例:

1. Python 实现 (使用 requests)

Python 代码最为简洁,适合做脚本或快速验证。

python 复制代码
import requests
import json

def send_to_external_group(token, chat_id, text):
    url = f"https://qyapi.weixin.qq.com/cgi-bin/appchat/send?access_token={token}"
    data = {
        "chatid": chat_id,
        "msgtype": "text",
        "text": { "content": text },
        "safe": 0
    }
    res = requests.post(url, data=json.dumps(data))
    return res.json()

2. Go 实现 (使用标准库)

Go 适合追求性能的中间件推送服务。

java 复制代码
func SendGroupMsg(token string, chatId string, content string) {
    url := "https://qyapi.weixin.qq.com/cgi-bin/appchat/send?access_token=" + token
    body := map[string]interface{}{
        "chatid":  chatId,
        "msgtype": "text",
        "text":    map[string]string{"content": content},
    }
    jsonBody, _ := json.Marshal(body)
    http.Post(url, "application/json", bytes.NewBuffer(jsonBody))
}

3. Java 实现 (使用 RestTemplate)

Java 方案通常集成在 Spring Boot 项目中。

java 复制代码
public void sendMsg(String token, String chatId, String text) {
    String url = "https://qyapi.weixin.qq.com/cgi-bin/appchat/send?access_token=" + token;
    Map<String, Object> params = new HashMap<>();
    params.put("chatid", chatId);
    params.put("msgtype", "text");
    params.put("text", Collections.singletonMap("content", text));
    
    restTemplate.postForEntity(url, params, String.class);
}

⚠️ 开发者必看的三个"坑"

  • 获取 ChatID 的前置条件:

    你不能通过群名发消息。必须先调用 externalcontact/groupchat/list 获取群列表,再通过 get 接口获取具体的 chat_id。

  • 应用可见性:

    发送消息的应用,必须在企业微信后台配置的"可调用接口的应用"列表中,且群主必须在应用的可见范围内。

  • 发送频率:

    外部群对自动化消息有严格限制。如果短时间内发送频率过高,会导致接口返回 81013 错误或直接封禁应用发送功能。

QiWe开放平台提供了后台直登功能,登录成功后获取相关参数,快速Apifox在线测试,所有登录功能都是基于QiWe平台API自定义开发。

相关推荐
星落梦生9 小时前
SpringAOP基础笔记(7)
java·开发语言
金銀銅鐵10 小时前
带您看懂字节码指令(四):一条指令里有什么
java·jvm
最强小杰10 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
Flynn Liang11 小时前
流量治理不是限流那么简单:I/O 密集型 Java 服务的 6 层防线
java·微服务·高并发·限流·熔断·系统稳定性·resilience4j
学长毕设11 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
曹牧11 小时前
Java:“刷新雪崩”
java·开发语言
秋天的怀念_David11 小时前
算法一千零一夜 · 第三十三夜 · 跳表
java·程序人生·算法
Forget the Dream13 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
黑十14 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
神明不懂浪漫15 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记