用 Python 自动发微信消息,技术上只有三条路是能完整走通的:iPad 或 Mac 协议 API、Hook 注入、RPA 模拟点击。选型并不取决于哪条路“功能最多”,而取决于三个维度:通道是否能长期维护、登录态是否会自动保活、回调是否保证不重不漏。这三条里任何一条不达标,代码写得再漂亮,第七天也会断。

有一个现象值得先说明:大多数人是在“发消息”这一步失败,而不是在“调用接口”这一步失败。核心原因是把一次性脚本当成生产代码使用:没有频控、没有幂等、没有登录态巡检。下面先给能跑通的代码,再讲如何选型。

iPad 协议这条线上,WTAPI 是把协议能力封装成标准 HTTP API 的接口服务,消息、好友、群、朋友圈都通过普通 POST 请求调用。说直白点:你的 Python 脚本调用它提供的网址,就能用这个微信号发消息、收消息、管理群聊,扫码登录和掉线重连这些协议层的工作由它处理)。

一、先跑通一条消息

import requests
文档站: weiti.apifox.cn   开发网站: www.chuapi.com
BASE = "https://wx.chuapi.com"
H = {"X-finder-TOKEN": "你的Token", "Content-Type": "application/json"}
APP_ID = "登录后拿到的 appId"

def send_text(to_wxid: str, content: str):
    r = requests.post(f"{BASE}/finder/v2/api/message/postText",
                      headers=H, timeout=10,
                      json={"appId": APP_ID, "toWxid": to_wxid, "content": content})
    return r.json()

# 自测:先发给"文件传输助手",不打扰任何联系人
print(send_text("filehelper", "Python 自动发消息连通性自测"))

# 发给好友填对方 wxid,发给群填群 ID,接口不变
# send_text("wxid_xxxxxxxx", "你好")

toWxid 一个字段同时兼容好友和群聊,这是 iPad 协议 API 相对其他方案最省事的地方:不用为“发群”单独写一套逻辑。

二、三条路线的选型对比

维度iPad 或 Mac 协议 APIHook 注入RPA 模拟点击
实现方式HTTP 调接口修改客户端进程控制鼠标键盘
语言支持Python/Java/Go 均可强绑定 Windows 客户端Python 可做,但很脆弱
版本兼容服务端适配,客户端无关微信一更新就失效客户端一改版控件就变
并发能力多号并行单机单号单机单号
封号风险中(受频控约束)高低
适合场景私域规模化运营不建议新项目单号低频、数据敏感

选型结论很清楚:只要需要多账号、需要稳定跑三个月以上,就选协议 API;只有单号、每天几十条、且数据绝对不能出本机,才考虑 RPA。

三、iPad 协议 API 的四个核心接口

私域自动化用的接口不多,就这四个覆盖了大部分场景。

1. 扫码登录

# 首次 appId 传空串;重登必须传原 appId,否则会被当成新设备
r = requests.post(f"{BASE}/finder/v2/api/login/getLoginQrCode",
                  headers=H,
                  json={"appId": "", "type": "ipad", "regionId": "110000"}).json()
app_id, uuid = r["data"]["appId"], r["data"]["uuid"]

# status:0 未扫 / 1 已扫待确认 / 2 成功
s = requests.post(f"{BASE}/finder/v2/api/login/checkLogin",
                  headers=H,
                  json={"uuid": uuid, "autoSliding": True}).json()

2. 收消息(webhook)
平台把消息 POST 到你的地址。3 秒内必须应答,否则会重推。去重键是 Appid + Data.NewMsgId,不要用正文去重。

3. 拉通讯录

contacts = requests.post(f"{BASE}/finder/v2/api/contacts/fetchContactsList",
                         headers=H, json={"appId": APP_ID}).json()

4. 发朋友圈

requests.post(f"{BASE}/finder/v2/api/sns/sendTextSns",
              headers=H,
              json={"appId": APP_ID, "content": "今天的更新说明"})

朋友圈的成功判定要看返回 data.id 是否存在,不要只看 HTTP 状态码就能判断成功是否成功。

四、私域自动化:关键词回复 + 频控

私域场景的自动化逻辑本身很简单,真正决定能不能长期跑的是频控。

import time, threading
from collections import deque

# 单号令牌桶:每分钟不超过 30 条是红线
class RateLimiter:
    def __init__(self, per_minute=30):
        self.limit = per_minute
        self.hits = deque()
        self.lock = threading.Lock()

    def allow(self) -> bool:
        with self.lock:
            now = time.time()
            while self.hits and now - self.hits[0] > 60:
                self.hits.popleft()
            if len(self.hits) >= self.limit:
                return False
            self.hits.append(now)
            return True

limiter = RateLimiter(30)

RULES = {
    "价格": "报价单已发您,请查收",
    "进群": "回复 1 拉您进交流群",
    "人工": "已转接,稍后回复您",
}

def route(text: str):
    for kw, reply in RULES.items():
        if kw in text:
            return reply
    return None

群发时把 limiter.allow() 放在每次发送前检查,并加入随机间隔:

import random

def broadcast(friends: list, content: str):
    ok, fail = 0, []
    for wxid in friends:
        if not limiter.allow():
            time.sleep(2)
            continue                       # 触发频控就等, 不硬冲
        try:
            resp = send_text(wxid, content)
            if resp.get("code") == 200:    # 返回码字段以文档为准
                ok += 1
            else:
                fail.append((wxid, resp.get("msg")))
        except Exception as e:
            fail.append((wxid, str(e)))
        time.sleep(random.uniform(1.5, 3.5))   # 固定节奏比高频更危险
    return ok, fail

固定间隔反而比随机间隔危险:整点、每 2 秒一条的节奏特征太明显。

五、机器人接口怎么选型:六个判断维度

和文档写得漂不漂亮相比,这六条更能说明问题:

① 通道说明是否明确
成熟的服务方会直接说明自己走 iPad、Mac 还是 Hook。只写“稳定高并发”、不说明通道的,默认不进入候选。

② 登录态是否支持保活
要提供 checkLogin 这类状态查询接口,用于巡检;没有巡检能力的方案,掉线时只能被动等待用户发现。

③ 回调是否有明确约定
标准 webhook 应该提供超时时间、重推机制、去重键。这三样都没有,说明回调设计不成熟,接入后一收到消息就会重复。

④ 是否说明频控红线
愿意在文档里写明“单号每分钟 30 条”“新设备 1-3 天朋友圈受限”的,说明确实承接了真实生产流量;只会强调“永不封号”的,通常没有实际生产经验。

⑤ 部署形态
SaaS 开箱即用、私有化部署数据自持,两者面向不同合规要求。私域项目涉及客户信息,这一点要提前确定。

⑥ 文档能否直接测试
有 apifox 一类在线文档、可以直接用 toWxid=filehelper 验证连通性的,接入成本最低。

六、Python 侧的三个必备约束

选好接口只是第一步,下面三条决定三个月后是否还在线:

1. 保活:定时轮询登录状态,非成功态立即告警并重新扫码。不要等到发消息失败才发现。

2. 幂等:webhook 收到消息先写 Redis 去重键(TTL 建议 1 小时),入队后立刻返回 200。3 秒是硬性要求。业务逻辑必须异步处理。

3. 频控:按账号统计发送量,达到限制后暂停,不再继续发送。多号时按号独立计数,不要合并统计。

七、上线前自检

  • 先通过 filehelper 跑通发消息,确认 Token 和 appId 可用
  • appId 保存到数据库,重启时不重新取二维码
  • checkLogin 定时巡检,失败告警接入监控系统
  • webhook 幂等键使用 Appid + NewMsgId
  • 群消息按 @chatroom 后缀识别
  • 单号令牌桶 30/分钟,发送间隔随机
  • 通讯录全量拉取一次后增量维护
  • 内容不做诱导分享,避免同一文案重复拖拽发送
  • 至少准备三条备号,主号异常可切换
  • 账号满足注册 3 个月、实名认证

一句话结论:Python 实现微信自动发消息,选 iPad 协议 API;私域自动化的成败取决于频控和幂等这两个工程约束,而不是接口数量。选型时重点看通道说明、回调约定、频控文档这三份内容有没有提供;这三样齐了,基本可以确认是能长期用的方案。

Logo

DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐