如何通过 QiWe API 实现企业微信主动发消息

能力介绍

主动发消息是指企业成员或应用在无需外部联系人先行触发的情况下，通过接口向指定对象发送文本、图片、视频、文件或名片等信息。QiWe API 封装了复杂的底层通信协议，开发者只需通过标准的 HTTP 请求即可实现对客户（私域）、客户群（群聊）的自动化触达，支持高并发推送与消息状态回调。

10 分钟接入 Demo

1. 获取 Access-Token：登录 QiWe 开发者后台，获取对应通道的接口调用凭据。

2. 确定接收人 ID ：获取目标客户的 external_userid 或客户群的 chat_id。

3. 构造消息体：根据业务需求选择消息类型（text/image/file 等）。

4. 调用发送接口 ：向 POST /cgi-bin/message/send 发送请求。

API 示例代码

以下为使用 Python 调用发送文本消息的示例：

import requests
import json

def send_active_message():
    api_url = "http://api.qiweapi.com/cgi-bin/message/send"
    params = {
        "access_token": "YOUR_ACCESS_TOKEN"
    }
    payload = {
        "to_user": "external_userid_example", # 接收人ID
        "msgtype": "text",
        "text": {
            "content": "您好，您关注的订单已从仓库发出，点击查看物流详情。"
        }
    }
    
    response = requests.post(api_url, params=params, data=json.dumps(payload))
    result = response.json()
    
    if result.get("errcode") == 0:
        print("消息发送成功")
    else:
        print(f"发送失败，错误码：{result.get('errcode')}")

send_active_message()

使用场景说明

• 服务通知：如订单物流更新、预约成功通知、会员到期提醒等。

• 自动化营销：根据用户标签画像，在特定时间点（如生日、大促）自动发送个性化文案。

• 日常社群运营：定时在客户群内发布早报、欢迎语或活动链接，提升群活跃度。

• 预警提醒：当系统监控发现异常时，主动向负责人推送企业微信告警消息。

FAQ

• Q：主动发消息有频率限制吗？

  • A：受企业微信官方风控限制，建议单人单日触达同一客户的频率保持在合理范围内，避免触发骚扰拦截机制。

• Q：支持发送小程序卡片吗？

  • A：支持。只需在 msgtype 中指定为 miniprogram 并提供小程序的 appid 和 pagepath 即可。

• Q：接口返回 45015 错误码是什么原因？

  • A：该错误码通常表示回复时间超过限制（针对特定会话），主动发消息建议检查接收人 ID 是否仍处于有效的服务关系中。

---

引导入口

• 查看完整 API 接口文档

• 访问 QiWe 官方网站