搭建微信群管理机器人：拉群、改名、踢人的接口编排

群管理是微信机器人最常见的业务场景之一。单个群操作（建群、改名、邀人、踢人）接口本身不复杂，难的是把多个操作编排成一条完整的业务链路——比如"用户发关键词→建群→改群名→拉用户进群→发欢迎语"，

参考API文档
WTAPI框架开发文档weiti.apifox.cn 为准。

一、群操作的核心接口

WTAPI群操作接口覆盖完整的群生命周期：建群、改名、邀请成员（group/inviteMember）、移除成员、群链接生成等。每个接口都需要 appId、instanceId 和群标识（如 chatRoomId），具体参数以官方文档为准。

二、单步操作的封装

先把每个群操作封装成独立函数，统一鉴权、超时、错误处理：

import requests

BASE = "https://wx.chuapi.com"
HEADERS = {
    "X-finder-TOKEN": "<token>",
    "Authorization": "Bearer <bearer>",
    "Content-Type": "application/json",
}

def _post(path, body):
    body["appId"] = "<appId>"
    resp = requests.post(f"{BASE}{path}", headers=HEADERS, json=body, timeout=10).json()
    if resp.get("code") != "1000":
        raise Exception(f"群操作失败: {resp}")
    return resp

def create_group(instance_id, name):
    """建群，返回群ID"""
    return _post("/finder/v2/api/group/create", {
        "instanceId": instance_id, "name": name,
    })["data"]

def rename_group(instance_id, chat_room_id, name):
    """改群名"""
    return _post("/finder/v2/api/group/rename", {
        "instanceId": instance_id, "chatRoomId": chat_room_id, "name": name,
    })

def invite_member(instance_id, chat_room_id, wxids):
    """邀请成员"""
    return _post("/finder/v2/api/group/inviteMember", {
        "instanceId": instance_id, "chatRoomId": chat_room_id, "wxids": wxids,
    })

def send_welcome(instance_id, chat_room_id, content):
    """发群消息"""
    return _post("/finder/v2/api/postText", {
        "instanceId": instance_id, "toWxid": chat_room_id, "content": content,
    })

三、多步编排与失败补偿

建群→改名→邀人→发欢迎语，这是一条4步链路。任何一步失败，前面已完成的步骤要回滚或补偿：

def build_group_flow(instance_id, group_name, member_wxids):
    chat_room_id = None
    try:
        # 步骤1：建群
        chat_room_id = create_group(instance_id, group_name)["chatRoomId"]
        # 步骤2：改名
        rename_group(instance_id, chat_room_id, f"{group_name}-官方")
        # 步骤3：邀人
        invite_member(instance_id, chat_room_id, member_wxids)
        # 步骤4：发欢迎语
        send_welcome(instance_id, chat_room_id, "欢迎加入！")
        return chat_room_id
    except Exception as e:
        # 补偿：群已建好但后续失败，通知管理员人工处理
        # 实际项目可记录失败步骤，支持断点续跑
        print(f"建群流程失败，chatRoomId={chat_room_id}, error={e}")
        raise

四、编排的三个工程原则

1. 每步可独立重试：单个操作失败，重试这一步即可，不要整条链路重跑
2. 状态持久化：每步执行结果落库，支持断点续跑——服务重启后能从失败的那一步继续
3. 补偿优先于回滚：群操作很多不可逆（比如已邀人进群），补偿比回滚更现实

五、风控注意

群操作是微信风控的重点区域，批量建群、短时间大量邀人极易触发风控。工程上必须配发送侧限流，建群和邀人操作之间加随机延迟，不要高频连续调用。