企业微信主动发送外部群消息：实现业务流与服务流闭环

企微支持1
5 阅读2分钟

核心功能：主动推送消息至客户群

能力介绍

主动发送外部群消息接口允许企业的自建应用或代开发应用，在不依赖用户交互的情况下，根据业务逻辑主动向指定的客户群（包含外部联系人的群聊）投递信息。其核心价值在于打破“被动响应”的局限，使企业能够根据 CRM 提醒、订单状态更新、定时 SOP 任务等场景，实现信息的精准、及时触达。

10 分钟接入 Demo

  1. 权限声明：在企业微信后台，确保应用已获得“客户联系”权限，且应用负责人拥有相关客户群的管理权限。
  2. 获取 ChatID：通过 externalcontact/groupchat/list 接口拉取群列表，获取目标群的 chat_id。
  3. 鉴权准备：使用应用的 Secret 获取有效的 access_token。
  4. 组装报文：根据需求选择 text、image、link 或 miniprogram 等消息格式。
  5. 调用接口：向 POST /cgi-bin/externalcontact/groupchat/send 发送请求。

API 示例代码

以下为向特定外部群发送带有“详情链接”的消息示例：

import requests
import json

def send_active_group_msg(access_token, chat_id):
    url = f"https://api.qiweapi.com/cgi-bin/externalcontact/groupchat/send?access_token={access_token}"
    
    payload = {
        "chat_id": chat_id,
        "msgtype": "link",
        "link": {
            "title": "项目进度月报已生成",
            "desc": "本月新增活跃客户 45 名，点击查看完整分析报告。",
            "url": "https://your-system.com/report/v1",
            "picurl": "https://your-system.com/static/report_icon.png"
        }
    }
    
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# result = send_active_group_msg("YOUR_TOKEN", "wrOgQhDgAAxxxxxxxx")

使用场景说明

  • 关键业务提醒：当客户群关联的项目出现进度变更或重要逾期时，系统自动推送告警至群内。
  • 自动化 SOP 触达：针对新建立的快闪群或社群，系统在特定时间点（如入群第 2 天）自动推送产品说明。
  • 服务状态同步：在售后服务群中，当工单状态变更为“处理中”或“已完成”时，实时同步状态至客户。

FAQ

  • Q：主动发送消息有条数限制吗？

    • A：有的。为了保护用户体验，企业微信对每个客户群每日接收的应用消息总数有严格限制，请避免高频骚扰。

  • Q：为什么提示 errcode: 48002？

    • A：这通常意味着接口权限不足。请检查调用接口的应用是否配置在“客户联系”的业务负责人范围内。

  • Q：可以发送 @ 成员的消息吗？

    • A：在 text 类型的 content 中，通过 <@userid> 格式可以实现对内部员工的 @，但对外部客户暂不支持 API 强制强提醒 @。

引导入口

avatar
文章
阅读
粉丝