一、核心概念界定

1. 企业微信 API：企业微信开放平台提供的应用程序接口，允许企业通过自定义开发，实现与企业微信原生功能的对接、扩展，满足个性化的内部管理与外部连接需求。

1. 外部群主动推送消息：借助企业微信 API 开发能力，企业在合规前提下，向由员工创建并添加外部联系人（客户、合作伙伴等）组成的外部群，主动发送预设或实时生成的消息内容，属于企业微信外部运营的重要功能之一。

二、主动推送消息的功能逻辑

1. 权限前提：

• • 企业需完成企业微信开放平台的开发者资质认证，创建应用并获取对应的 CorpID、Secret 等核心凭证。

• • 操作员工需具备对应外部群的管理权限，且企业微信后台已开启 “外部群消息推送” 相关权限配置（路径：企业微信管理后台 - 应用管理 - 自定义应用 - 权限设置）。

1. 技术流转流程：

• • 第一步：通过 API 调用获取外部群列表及群 ID（接口示例：GET /cgi-bin/externalcontact/groupchat/list），需传入员工 userid 等参数筛选目标群。

• • 第二步：构建符合企业微信消息格式要求的推送内容（支持文本、图片、文件、小程序、图文等类型，格式需遵循官方 API 文档规范）。

• • 第三步：调用外部群消息发送 API（接口示例：POST /cgi-bin/externalcontact/groupchat/send），传入群 ID、消息类型、消息内容等参数，发起推送请求。

• • 第四步：企业微信服务器校验权限与格式无误后，将消息分发至目标外部群，开发者可通过返回的 msgid 查询发送状态。

1. 限制规则：

• • 频率限制：单个应用对单个外部群的主动推送消息，每日有固定次数上限（具体以企业微信开放平台最新规则为准，通常为单日 10-20 条 / 群），避免过度推送骚扰联系人。

• • 内容限制：不得包含违法违规、广告营销、恶意诱导等违规内容，需符合《企业微信外部联系管理规范》及相关法律法规。

• • 格式限制：消息内容需严格遵循 API 文档规定的字段格式，例如文本消息不得超过 2000 字，图片需满足尺寸与大小要求（≤2MB）。

三、操作规范与注意事项

1. 合规操作要求：

• • 需明确告知外部联系人消息推送规则，在添加外部群时通过群公告等形式公示推送频率、内容类型，保障联系人知情权。

• • 不得利用推送功能收集联系人隐私信息，不得发送与企业业务无关的无关内容，禁止批量骚扰、诱导消费等违规行为。

• • 留存推送记录（包括消息内容、发送时间、接收群 ID 等），留存期限建议不少于 6 个月，以备核查。

1. 技术操作要点：

• • 开发前需仔细查阅企业微信开放平台最新 API 文档，确认接口参数、返回码含义及格式要求，避免因版本更新导致调用失败。

• • 建议添加异常处理机制，针对接口调用失败（如权限不足、频率超限、格式错误）返回的错误码（如 40001token 失效、45047 频率超限），设置重试或告警逻辑。

• • 推送内容需进行合规性校验，避免包含敏感词、违规链接等，可对接企业微信敏感词校验 API 提前筛选。

四、典型应用场景

1. 客户服务场景：向外部客户群推送产品使用指南、常见问题解答、服务升级通知等，提升服务响应效率，降低重复咨询成本。例如，教育机构向学员群推送课程安排调整、作业提醒等。

1. 业务通知场景：企业向合作伙伴群推送合作进度更新、会议通知、资料同步等内容，保障协作信息及时触达。例如，供应商群推送订单发货通知、对账提醒等。

1. 合规运营场景：金融机构、医疗机构等需合规告知的行业，向客户群推送政策解读、风险提示、权益告知等内容，确保信息传递的规范性与可追溯性。

五、常见问题排查

1. 推送失败提示 “40031 无权限”：检查应用是否已获取 “外部群消息发送” 权限，员工是否为目标群的创建者或管理员。

1. 消息发送成功但群内未显示：确认消息格式是否符合要求（如图片尺寸、文件格式），或该外部群是否已解散、员工是否已退出群聊。

1. 触发频率限制：优化推送策略，合理分配每日推送次数，避免集中在同一时段向多个群批量推送。