企业微信外部群主动推送消息：跨渠道自动化触达核心功能：向外部联系人分群（客户群）主动投递消息能力介绍外部群主动推送（

核心功能：向外部联系人分群（客户群）主动投递消息

能力介绍

外部群主动推送（Groupchat Send）是企业私域运营中实现“大规模自动化”的核心接口。与传统的群机器人 Webhook 不同，该接口由企业自建应用或第三方应用发起，支持更丰富的消息类型，并能与企业的 CRM 系统深度绑定。其核心价值在于打破人工操作瓶颈：系统可以根据业务逻辑（如会员等级变更、物流更新、活动触达）主动向指定的 chat_id 发送信息，实现真正的数智化经营。

10 分钟接入 Demo

权限准备：确保应用已开通“客户联系”权限，且发送者在应用的“可见范围”内。
获取 ChatID：通过 externalcontact/groupchat/list 接口获取目标外部群的唯一标识。
获取 AccessToken：调用鉴权接口获取当前有效的调用凭证。
构造报文：选择消息类型（text, image, link, miniprogram 等）并填入 chat_id。
调用发送：通过 POST 请求访问发送接口，并根据返回结果记录发送日志。

API 示例代码

以下为通用的 Python 推送示例，涵盖了基础的文本发送逻辑：

import requests
import json

def send_active_group_msg(access_token, chat_id, content):
    # 接口终点：外部群发送专用
    url = f"https://api.qiweapi.com/cgi-bin/externalcontact/groupchat/send?access_token={access_token}"
    
    payload = {
        "chat_id": chat_id,   # 目标客户群ID
        "msgtype": "text",
        "text": {
            "content": content
        },
        "safe": 0             # 0表示不保密，1表示保密
    }
    
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# res = send_active_group_msg("YOUR_TOKEN", "wrOgQhDgAAxxxxxxxx", "【系统提醒】您的社群服务已续费成功！")

使用场景说明

精细化 SOP 触达：根据客户入群天数，自动推送第 1 天的欢迎语、第 3 天的产品教程、第 7 天的优惠券。
业务状态实时同步：电商场景中，当某个客户在群内下单后，系统自动在群内发送“感谢 XX 下单”的激励消息。
突发状况紧急通知：如线下门店临时调整营业时间，通过 API 快速同步至所有关联的社区群。

FAQ

Q：为什么提示 errcode: 48002 (no permission)？
- A：请检查该群是否属于“外部群”（即群内必须有外部客户），且应用是否被授权管理该群主所在的部门。
Q：主动推送有频率限制吗？
- A：有。企业微信对每个外部群接收的应用消息频率有上限（通常为单群每日限额），建议仅用于高价值通知。
Q：可以 @ 所有人吗？
- A：在文本消息的 content 中拼入 @all 即可，但需注意频繁使用可能导致客户反感。

引导入口

查看完整文档：QiWe API 文档 - 外部群主动推送详解
企微官网：QiWe 官网