通过好友→拉进群→发欢迎语这条链路单看每一步都是一次接口调用连起来就有两个经典问题拉群失败时已经通过的好友怎么办、群满了之后新来的人往哪放。这篇把链路的事务性和群容量管理讲清楚。一、链路的三个动作与依赖关系三个动作有严格顺序先通过好友拿到好友关系才能拉群只有好友才能被拉进群最后发欢迎语确认进群后才有意义。顺序反了就会报错——没通过好友就拉群接口直接返回失败。动作之间的间隔也要有通过后等 3 秒再拉拉完等 2 秒再发欢迎语。连续无间隔调用容易触发限流而且真人操作本来就有节奏。三个接口的参数结构在 Eyun 开发文档 中有对应说明。二、拉群失败不回滚进补偿队列拉群失败最常见的原因是群满500 人上限或对方设置了需要确认才能被拉群。这时候不要把已通过的好友关系回滚掉——好友关系留着有价值只是群暂时进不去。正确做法是把拉群任务放进补偿队列标记失败原因定期重试。群满类的失败等开了新群再批量补拉需要确认类的失败改为私聊发送入群邀请链接让用户自己点。三、群满裂变自动开新群并迁移策略运营群迟早会满。裂变策略主群人数到阈值比如 450就自动创建新群新成员统一拉进新群旧群停止进人但保留服务。新群创建后要把群名、群公告、机器人配置一并初始化别只建个空群。两个群的编号规则要提前定好——比如福利 1 群福利 2 群欢迎语里带上群编号用户转述时不混乱。四、欢迎语发在哪群里还是私聊两种做法各有场景。群里发并 新人——公开透明老成员看到会觉得群活跃适合运营群。私聊发——内容可以更长更个性化比如发资料包链接不打扰群成员适合服务群。也可以两者结合群里发一句简短的xxx 欢迎加入详细的指引走私聊。欢迎语模板按来源渠道配置扫码渠道 A 的和渠道 B 的内容不同方便后续统计渠道效果。链路动作对照动作前置条件间隔失败处理通过好友申请事件-重试3次转人工拉群已是好友3秒进补偿队列发欢迎语已在群2秒私聊补发群满裂变人数≥450-建群初始化配置完整链路实现import time class GroupOnboarder: THRESHOLD 450 # 裂变阈值 def __init__(self, api, store): self.api api self.store store self.compensation [] # 补偿队列 def current_group(self): # 取当前活跃群满了自动裂变 gid self.store.get(active_group) members self.api.get(f/group/{gid}/members).json() if len(members[items]) self.THRESHOLD: gid self._spawn_new_group() self.store.set(active_group, gid) return gid def _spawn_new_group(self): idx self.store.incr(group_index) r self.api.post(/group/create, { name: f福利 {idx} 群, }).json() gid r[group_id] self.api.post(/group/announce, { group_id: gid, content: self.store.get(notice_tpl)}) return gid def onboard(self, req): # 1. 通过好友 self.api.post(/friend/accept, {req_id: req[req_id]}) time.sleep(3) # 2. 拉群失败进补偿队列 gid self.current_group() r self.api.post(/group/add, { group_id: gid, members: [req[wxid]]}).json() if r.get(code) ! 0: self.compensation.append({ wxid: req[wxid], reason: r.get(msg), next_retry: time.time() 300}) return pending time.sleep(2) # 3. 群内欢迎 私聊发详细指引 self.api.post(/send, { group_id: gid, content: f{req[nickname]} 欢迎加入福利群}) time.sleep(3) self.api.post(/send, { wxid: req[wxid], content: self.store.get(guide_tpl)}) return done落地建议链路顺序必须是通过好友→拉群→欢迎语反了接口直接报错。拉群失败不回滚好友关系进补偿队列标记原因定期重试群满到阈值自动建新群群名公告机器人一并初始化。欢迎语分两层——群里一句 简短欢迎详细指引走私聊模板按来源渠道配置。微信侧的好友、群管理接口由Eyun这类个人微信API平台 提供链路与裂变逻辑在自建服务实现具体字段以平台开发文档为准。