如何用Python脚本调用企业微信API实现自动化接收与回复消息?

雨强小哥_6104

雨强小哥_6104

2026-09-10

789人浏览

原创

Webhook仅支持单向发送,无法接收消息;真正实现“接收+回复”闭环需用企业微信客服API或第三方网关。因其官方Webhook地址(/send?key=xxx)是纯推送通道,无回调入口,监听该URL会返回405或超时;而客服API的/callback路径才支持带签名验证的消息接收与响应。

如何用python脚本调用企业微信api实现自动化接收与回复消息?

不能只靠 Webhook 实现“接收 + 回复”闭环,必须用企业微信客服 API 或第三方网关(如企销宝)才能真正收消息;纯 Webhook 只能发,不能收。

为什么 requests.post + Webhook 地址只能发、不能收?

企业微信的官方 Webhook(https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx)是单向推送通道,仅支持机器人主动发送消息。它不接收任何回调,也不暴露消息入口。试图监听这个 URL 的 POST 请求,永远收不到用户消息——那是 HTTP 405 错误或超时。

真正能“接收”消息的路径只有两类:

  • 企业微信「客服」应用配置的 /cgi-bin/message/callback 回调地址(需公网可访问 + 签名验证)
  • 第三方服务(如企销宝、NTWork)封装的消息接收网关,底层仍走客服 API 或长连接

本地开发调试时,用 ngroklocaltunnel 暴露 localhost 是常见做法,但必须确保企业微信后台已填写该回调 URL 并完成 Token 验证。

用 Flask + 客服 API 实现接收与回复的关键三步

核心流程:用户发消息 → 企业微信 POST 到你的回调 URL → Flask 解析并验签 → 调用 message/send 接口回复。

必须做对以下三点,否则收不到或回复失败:

  • 验签逻辑不能省:企业微信每次回调都带 msg_signaturetimestampnonce,需用 TOKEN + EncodingAESKey + 原始 XML/JSON 体重新计算签名比对
  • access_token 必须缓存gettoken 接口有调用频率限制(2000次/天),且返回的 token 有效期 2 小时,硬编码或每次请求都重取会导致限流或过期失败
  • 回复必须用客服接口,不是 Webhook:回复目标是具体用户(touser),不是群;要填 agentid 和有效 access_token,不是 Webhook 的 key

示例关键片段(非完整):

python全能编程助手
python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能,主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ,专为学生、算法学习者和开发者设计;✅ 一个技能,两种用途 :;核心要点📝 题解模式 :输入题目/题号,自动生成完整 Python 题解(含详细注释、解题思路、复杂度分析);💬 注释模式 :输入 Python 代码,自动添加详细中。它将相关步骤、

下载
from flask import Flask, request
import hashlib
import time
import json
import requests
<p>app = Flask(<strong>name</strong>)
TOKEN = "your_token"
ENCODING_AES_KEY = "your_encoding_aes_key"  # 32位base64字符串
CORP_ID = "wwxxxxxx"
AGENT_ID = 1000002</p><p>def verify_signature(msg_signature, timestamp, nonce, data):
tmp_list = [TOKEN, timestamp, nonce, data]
tmp_list.sort()
tmp_str = "".join(tmp_list)
return hashlib.sha1(tmp_str.encode()).hexdigest() == msg_signature</p><p>@app.route("/wechat", methods=["POST"])
def receive_message():
msg_signature = request.args.get("msg_signature")
timestamp = request.args.get("timestamp")
nonce = request.args.get("nonce")
data = request.data.decode()</p><pre class="brush:php;toolbar:false;">if not verify_signature(msg_signature, timestamp, nonce, data):
    return "invalid signature", 403

# 解析XML或JSON(取决于后台配置)
# ... 提取 FromUserName, Content ...
user_id = "w123456789"
content = "你好"

# 回复(调用客服消息接口)
access_token = get_cached_access_token()  # 自行实现缓存逻辑
url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}"
payload = {
    "touser": user_id,
    "msgtype": "text",
    "agentid": AGENT_ID,
    "text": {"content": "收到,正在处理中"},
    "safe": 0
}
requests.post(url, json=payload)
return "success"

用 NTWork 或企销宝能绕过哪些坑?

NTWork 封装了底层长连接和事件循环,企销宝提供 HTTP Push/WebSocket 接入,它们共同规避了以下硬伤:

  • 不用自己写验签、解密、XML 解析 —— NTWork 直接抛出 on_text_message 事件,content 已是明文字符串
  • 自动管理 access_token 生命周期,send_text() 内部完成刷新
  • 支持外部群、客户会话、多实例并发,而原生客服 API 默认只支持内部成员和已添加客户
  • 企销宝还内置上下文存储(Redis)、意图识别钩子,适合做 FAQ 或订单查询类机器人

但代价是引入新依赖:NTWork 需要 Windows/macOS 本地客户端注入,企销宝需注册账号并对接其 SDK;若仅需简单内部群提醒,Webhook + 定时任务反而更轻量。

最容易被忽略的权限与配置点

90% 的“收不到消息”问题,根因不在代码,而在后台配置缺失:

  • 「客服」应用未开启「接收消息」权限(管理后台 → 应用 → 权限管理)
  • 服务器公网 IP 未加入企业微信「可信域名/IP 白名单」(否则回调直接被拦截)
  • 回调 URL 填的是 http://localhost:5000 —— 企业微信服务器根本无法访问,必须是公网地址或隧道地址
  • Token 和 EncodingAESKey 在代码里硬编码,且没加进 .gitignore,导致密钥泄露
  • 测试时用个人微信扫码进群,但企业微信客服 API 只认「已添加为客户」的用户,外部群成员需先通过「联系我」二维码添加

真正跑通的第一条消息,往往卡在第 2 步或第 4 步。先确认后台配置全开,再查日志里有没有 403 或空 body,比反复改 Python 逻辑更高效。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

企业微信
企业微信

企业微信是腾讯微信团队为企业打造的专业办公管理工具。与微信一致的沟通体验,丰富免费的OA应用,并与微信消息、小程序、微信支付等互通,助力企业高效办公和管理。有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1551

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

3624

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1549

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

20697

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2567

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2627

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1063

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

576

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2023

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程