微信回调解析不是难点，难的是把群聊和自发消息判断做对

关注

原创最新推荐文章于 2026-09-18 11:24:56 发布 463 阅读 AI 写同款· GEO 优化 ›

拌合楼软件开发（24）接收微信消息生成车辆计划【摘要】针对拌合站客户群体文化程度不高、习惯微信群沟通的业务场景，提出通过企业微信机器人实现微信对话下单的解决方案。核心是利用WorkTool工具的消息回调机制：1）配置接收消息的API接口；2）解析JSON格式的对话数据，筛选@机器人的有效消息；3）采用*号分隔符提取订单信息并进行校验；4）建立微信昵称与客户系统的映射关系。方案解决了传统系统登录门槛高的问题，但需注意群名唯一性、多系统对接及客户身份识别等关键问题。全文重点阐述技术实现逻辑而非具体代码。阅读详情

技术支持 wechatapi.net

做微信机器人这件事，最容易低估的往往不是“接回调”，而是“回调到底该怎么正确解释”。

在这里插入图片描述

我最近把微信接到了 OpenClaw，上线前我以为最麻烦的是：

回调地址配置
token 校验
发消息接口

真正做起来以后才发现，最容易踩坑的地方其实是：

这是不是自己发的消息
这是不是群消息
群里真正发消息的人到底是谁

如果这三件事处理不对，后面不管你接什么大模型，逻辑都会不稳定。

很多人一开始会写成这样

raw_content = data["Data"]["Content"]["string"]
from_user = data["Data"]["FromUserName"]["string"]

text = raw_content.strip()
sender = from_user

看起来没问题，但在群聊场景下，这种写法经常会直接把群 ID 当成发送人。

为什么会这样

根据实际回调文档，微信群消息并不是一个“字段天然就分好了”的结构。

你至少要分清楚这几个角色：

Wxid：归属微信，也就是当前登录账号
Data.FromUserName.string：消息发送方
Data.ToUserName.string：消息接收方
Data.Content.string：消息内容
Data.MsgType：消息类型

重点在这里：

判断是不是自己发的

文档给得很清楚：

可通过消息发送人 $.Data.FromUserName.string 与所属微信 $.Wxid 是否一致进行判断。

所以判断自己发送应该是：

is_self = bool(wxid and from_user == wxid)

判断是不是群消息

文档里也明确区分了两种情况：

别人发群：FromUserName.string 以 @chatroom 结尾
自己发群：ToUserName.string 以 @chatroom 结尾

所以不能只看一个字段。

is_group = from_user.endswith("@chatroom") or to_user.endswith("@chatroom")

判断群里真正是谁发的

这一步最关键。

群聊里，真正的发言人经常藏在 Content.string 前半段：

wxid_xxx:
消息内容

所以还要再拆一次。

我后来用的是这套解析方式

def parse_wechat_payload(data):
    wxid = str(data.get("Wxid", "") or "").strip()
    msg_data = data.get("Data", {}) or {}

    from_user = (msg_data.get("FromUserName", {}) or {}).get("string", "")
    to_user = (msg_data.get("ToUserName", {}) or {}).get("string", "")
    raw_content = (msg_data.get("Content", {}) or {}).get("string", "")
    msg_type = msg_data.get("MsgType")

    is_self = bool(wxid and from_user == wxid)
    is_group = from_user.endswith("@chatroom") or to_user.endswith("@chatroom")

    if from_user.endswith("@chatroom"):
        chat_id = from_user
    elif to_user.endswith("@chatroom"):
        chat_id = to_user
    else:
        chat_id = from_user if not is_self else to_user

    sender_wxid = from_user
    actual_text = (raw_content or "").strip()

    if is_group and raw_content and ":\n" in raw_content:
        possible_sender, possible_text = raw_content.split(":\n", 1)
        possible_sender = possible_sender.strip()
        if possible_sender.startswith("wxid_") or possible_sender.startswith("v1_") or possible_sender.startswith("gh_"):
            sender_wxid = possible_sender
            actual_text = possible_text.strip()

    return {
        "wxid": wxid,
        "msg_type": msg_type,
        "chat_id": chat_id,
        "sender_wxid": sender_wxid,
        "actual_text": actual_text,
        "is_group": is_group,
        "is_self": is_self,
    }

这段逻辑看起来比简单脚本复杂不少，但它的好处是：

私聊和群聊都能统一得到 chat_id
群里真正说话的人能拆出来
机器人自己发出去的消息能直接过滤
后面 session 设计会清晰很多

自发消息不过滤，后果会很严重

这一点一定要单独说。

如果不忽略自己发出的消息，就很容易形成：

机器人收到用户消息
生成回复
把回复发到微信
微信又把这条回复回调回来
程序把自己的消息再送进 AI
最后循环

所以我后面在入口层直接做了：

if parsed.get("is_self"):
    logger.info("忽略自己发送的消息: %s", parsed.get("msg_id"))
    return {"status": "ignored_self"}

这是一个很小的判断，但实际价值非常大。

群聊和私聊的 session 也不能一样

如果回调解析错了，session 就一定跟着错。

我现在的 session 规则是这样的：

私聊

wechat_dm_{chat_id}

群共享上下文

wechat_group_{chat_id}

群成员独立上下文

wechat_group_{chat_id}_user_{sender_wxid}

代码长这样：

def build_session_id(chat_id: str, sender_wxid: str, is_group: bool, config: dict) -> str:
    def norm(s: str) -> str:
        return re.sub(r"[^a-zA-Z0-9_-]", "_", str(s or "").strip())

    if not is_group:
        return f"wechat_dm_{norm(chat_id)}"

    if config["GROUP_SESSION_MODE"] == "per_user":
        return f"wechat_group_{norm(chat_id)}_user_{norm(sender_wxid)}"

    return f"wechat_group_{norm(chat_id)}"