私域里「进群自动欢迎」看起来简单，落到企业微信外部群，要先能稳定收到群事件，再决定何时主动发。官方群机器人加不进外部群，欢迎语只能由已入群账号发出——这又是官方做不到、要用企微 API 补的一环。

群事件与回调结构见 QiWe 文档。

欢迎语依赖的是系统事件，不是聊天文本

客户进群时，平台会推系统类回调（cmd / msgType 以文档为准；群相关包括成员新增、移除、自退、改名、解散、转让等）。业务上常见挂接：

• 入群欢迎：成员新增 → 延迟发送欢迎语 / 规则说明

• 退群审计：成员移除或自退 → 记 CRM；营销话术要慎发

• 群名变更：同步到工单标题或项目映射表

• 解散 / 转让：告警，避免继续往失效 roomId 发消息

解析建议：先看 cmd 定大类，再看 msgType 定细类，最后读 msgData。所有回调都应带 guid，多设备时务必原样带回发送侧，写死单设备极易发错群。

推荐处理顺序

1. Webhook 入队并立刻 200（约 3 秒超时）

2. Worker 识别「进群」类事件（具体码以文档为准）

3. 查配置：该群是否开启欢迎、模板、静默时段

4. 延迟数秒再发，避开进群瞬间刷屏

5. 用「群 + 成员 + 当日」做幂等，防止重复欢迎

发送仍走统一 doApi，文本可用 /msg/sendText，toId 填外部群 roomId。批量拉人可能短时间多条成员新增，可考虑合并成一条说明，或只欢迎外部客户。

产品细节比接口更决定体验

欢迎是主动推的一种；进群后客户的第一句提问，再走关键词 / AI 自动回链路，两套不要抢同一条幂等账本。业务库维护 roomId ↔ 项目 / 客户成功负责人，欢迎失败时知道该人工跟谁。

群管理类动作（改名、拉人、移除、改公告）也有对应群模块接口，方法名以文档为准。欢迎场景优先把「收事件 + 发一条文本」跑稳，再扩展建群拉人。更多说明见 qiweapi.com。

欢迎文案建议可配置、可按群类型区分：交付群强调协作节奏，售前群强调资料索取路径，售后群强调工单入口。同一套硬编码欢迎语打进所有企业微信外部群，很快会被客户当成骚扰。把文案放配置中心，比把文案写进代码更符合私域运营节奏。

小结

入群欢迎不是再配一个官方机器人，而是：企微 Webhook 收群事件 → 队列与幂等 → API 主动发。企业微信外部群上，先延迟、先去重，比欢迎文案华丽更重要。