能力介绍

企业微信官方对外部群（包含微信用户的群）的消息发送频率有严格的风控限制。该能力通过对接高性能 API 接口，配合后端分布式队列（如 Redis 令牌桶），实现向多个企业微信外部群主动、批量、无延迟感知地投递文本、图片及链接消息。核心价值在于解决人工群发效率低、多线程并发调用易触发企微官方高频截断（如错误码 45009）的痛点。

10 分钟接入 Demo

1. 获取凭证：登录管理后台，获取应用的 DeveloperKey 与 Secret。

2. 群 ID 收集：通过群变更回调或列表接口，获取目标外部群的内部唯一标识 chat_id。

3. 限流配置：在本地代码中初始化速率限制器（建议单外部群发送间隔不低于 2 秒）。

4. 接口调用：组装 JSON 体，向群消息发送端点发起 POST 请求。

API 示例代码（Python 3）

import requests
import time

def send_group_msg(api_url, developer_key, chat_id, content):
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {developer_key}"
    }
    
    payload = {
        "chat_id": chat_id,
        "msgtype": "text",
        "text": {
            "content": content
        }
    }
    
    try:
        response = requests.post(f"{api_url}/cgi-bin/externalchat/send", json=payload, headers=headers)
        result = response.json()
        if result.get("errcode") == 0:
            print(f"群 {chat_id} 消息发送成功")
            return True
        else:
            print(f"发送失败，错误码: {result.get('errcode')}, 原因: {result.get('errmsg')}")
            return False
    except Exception as e:
        print(f"请求异常: {e}")
        return False

# 模拟批量发送与平滑限流
if __name__ == "__main__":
    API_URL = "https://api.qiweapi.com"  # 替换为实际 API 域名
    KEY = "your_developer_key"
    target_chats = ["chat_id_001", "chat_id_002", "chat_id_003"]
    
    for chat in target_chats:
        send_group_msg(API_URL, KEY, chat, "测试自动化消息投递")
        time.sleep(2)  # 强制平滑延迟，规避风控

使用场景说明

• 系统监控自动化告警：当内部运维系统检测到核心业务指标异常时，自动向指定的外部客户服务群 / 互联技术支持群发送告警详情。

• 定时业务数据同步：每日固定时间向大客户交付群主动投递昨日的运营数据报表或项目进度日报。

FAQ

• Q: 为什么接口返回 errcode: 0，但群内微信用户没有收到消息？ A: 大概率触发了企业微信底层的敏感词拦截机制或群发风控。建议检查发送内容是否包含高频营销词汇，或降低单个群的发送频率。

• Q: 单个应用每天最多可以向外部群发送多少条消息？ A: 频率受限于企业主体的信用权重及群内微信用户活跃度。标准自建应用建议单群日投递量控制在 50 条以内以确保送达率。

引导入口

• 查看完整技术文档

• 前往技术官网