私域里最常见的动作之一，不是发广告，而是把客户拉进对应的服务群、项目群、区域群。
手工拉人问题很明显：
- 客服手速跟不上
- 容易拉错群
- 没记录，事后对不上是谁拉的
所以会有人直接搜：企业微信拉人进群 API。
调用前先满足这 3 个条件
- 执行账号已经在目标群里，并且有邀请权限
- 被拉的人，一般需要是好友或满足企微邀请规则
- 你已经有群的
roomId、成员的userId
缺任何一个，接口都会失败，看起来像「API 不能用」，其实是前置条件没齐。
推荐流程
客户加好友 → 打标签 / 填资料 → 按规则匹配目标群 → 调用邀请成员接口 → 成功后发一条入群欢迎语不要一加好友就拉所有群。按地区、产品、订单状态分流，客户体验更好，也更安全。
拉人进群的请求示例在文档里可以直接复制：查看 API 文档
接口怎么理解
QiWe API 的群模块提供「邀请/添加成员」能力，向已有群聊补充新成员。
统一还是这个入口：
- 地址：
POST http://manager.qiweapi.com/qiwe/api/qw/doApi - Header：
X-QIWEI-TOKEN - Body：
method+params
params里通常要带：
guid：哪个账号去拉人- 群 ID
- 成员 ID 列表
具体字段名以文档最新示例为准，复制过去改 ID 即可。
拉人成功后补两条消息
建议固定做成模板：
给客户私聊
「已邀请您进入【XX 服务群】，请留意群通知。」
给群里
「欢迎 @客户 ，后续售后请直接在本群反馈。」
私聊和群消息都走/msg/sendText，只是toId分别填人 ID 和群 ID。
失败时先查这几项
| 现象 | 先检查 |
|---|---|
| 一直失败 | 账号是不是群成员、有没有邀请权限 |
| 部分人失败 | 是不是还不是好友、对方是否限制加群 |
| 拉进错群 | 业务映射是不是用了群名而不是 roomId |
| 偶发超时 | 设备是否在线、是否刚掉线重登 |
群如果开启了「群邀请确认」，被邀请人还要点同意，接口成功不等于已经进群。这一点做售后群时特别常见。
和官方客户群能力的区别
官方客户群也有邀请、群发等能力，但依赖应用权限、可见范围，而且很多运营动作还是要员工在手机上点。
QiWe API 是账号级操作，适合客服系统、SCRM 把「加好友 → 打标签 → 拉群 → 欢迎语」串成自动流程。模块说明也可看 QiWe API 官网。
总结
企业微信拉人进群 API，核心是「对的账号 + 对的群 ID + 对的人 ID」。
QiWe API 把邀请成员和发送欢迎语都收成 HTTP 调用，客户群也可以按规则自动拉人。
