企业微信外部群：解决新客群漏查问题

梦想的旅途22026-08-23 11:07

销售刚建「杭州经销商-2026」。工单要往这个群发开通说明。脚本只打了列表接口一次，返回 20 个旧群，新群不在里面。开发以为「接口不支持新群」，其实后面还有分页。

对照群模块字段，可以从这里开始翻：查看 API 文档

拉全量列表后再绑定新群，不要只取首页。

翻完再绑定

QiWe API 群模块列出当前 guid 所在的群。用游标或 page 直到空页。绑定当天可用精确群名，命中必须唯一，然后把 roomId 写入工单，以后不再搜名字。

python 复制代码

import requests

API = "http://manager.qiweapi.com/qiwe/api/qw/doApi"
HEADERS = {
    "X-QIWEI-TOKEN": "YOUR_API_KEY",
    "Content-Type": "application/json",
}


def do_api(method, params):
    body = requests.post(
        API, headers=HEADERS,
        json={"method": method, "params": params}, timeout=30,
    ).json()
    if body.get("code") != 0:
        raise RuntimeError(body)
    return body


def list_all_rooms(guid):
    rooms, cursor = [], ""
    for _ in range(50):
        data = do_api("/room/list", {
            "guid": guid, "cursor": cursor,
        }).get("data") or {}
        batch = data.get("rooms") or data.get("list") or []
        rooms.extend(batch)
        cursor = data.get("cursor") or data.get("next")
        if not batch or not cursor:
            break
    return rooms


def bind_by_exact_name(guid, exact_name):
    hits = [r for r in list_all_rooms(guid)
            if (r.get("name") or r.get("nickname")) == exact_name]
    if len(hits) != 1:
        raise ValueError(f"未唯一命中: {exact_name}, n={len(hits)}")
    return hits[0].get("roomId") or hits[0].get("id")

执行账号必须已在新群。不在群的 roomId 即使手填也对发失败。两个群重名时绑定应失败，让人肉眼挑，不要 contains("杭州")。

模块说明也可看 QiWe API 官网。

收口

新客群当天要发开通说明，先分页拉全量再精确绑定 roomId。测试：建群后列表总数加一，绑定 ID 能发进该群。