如何通过 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 调用发送文本消息的示例:

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 是否仍处于有效的服务关系中。

引导入口

相关推荐
wuyk5552 小时前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
高洁013 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
ComPDFKit3 小时前
RAG 回答只显示 PDF 文件名?用 Python 保留引用页码
开发语言·python·pdf·rag
FRing033 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
yz_aiks4 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
琳少_5 小时前
java程序开发笔记
java·开发语言·数据库·笔记
七夜zippoe5 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
2601_967980116 小时前
Flask Web 应用
python·flask·web开发·环境变量·虚拟环境
aifannihao6 小时前
ß 大写变 SS:用 Python 算清 Ruby2Shell 的缓冲区账本
python·安全·标准库·缓冲区溢出·字符串编码
liwulin05067 小时前
【OLLAMA】调用SKILL的通用ReAct
python