1. 能力介绍
在私域运营中，手动搜索并加入外部群聊效率极低。企微主动加群接口为企业提供了批量化、自动化的入群方案，打破了人工操作的瓶颈：
- 链接/二维码解析：支持通过解析群聊邀请链接或扫描群二维码实现自动申请。
- 批量入群：支持单账号或多账号批量执行入群动作，适用于大规模社群矩阵建设。
- 实时状态反馈：接口实时返回申请状态（待审核、已加入、链接失效等），方便业务系统记录。
- 规避人工繁琐：无需在手机端反复点击，由后台指令驱动机器人实例完成操作。
2. 10分钟接入 Demo
实现自动加群的核心逻辑如下：
- 准备素材：收集目标群聊的邀请链接或二维码图片 Base64 编码。
- 调用接口：向
qiweapi的加群专用 Endpoint 发送入群指令。 - 结果处理：通过回调（Callback）或轮询获取入群结果，并触发后续的群内欢迎语动作。
3. API 示例代码
以下是调用主动加群接口的典型逻辑：
import requests
import json
# 接口地址
url = "http://api.qiweapi.com/v1/group/join_by_link"
headers = {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
}
# 提交加群申请
data = {
"instance_id": "main_robot_01",
"url": "https://work.weixin.qq.com/gm/xxxxxxxx", # 企微群邀请链接
"remark": "申请加入行业交流群" # 验证信息（如需）
}
response = requests.post(url, headers=headers, data=json.dumps(data))
# 返回示例：{"code": 200, "msg": "申请已提交", "data": {"task_id": "join_99821"}}
print(response.json())
4. 使用场景说明
- 竞品/行业群调研：自动化加入行业公开群聊，实时接收行业动态与市场反馈。
- 社群裂变承接：当用户在小程序端触发“入群”需求时，系统自动指派机器人实例扫码进入对应群组进行后续服务。
- 多群协同管理：企业员工离职或账号变更时，利用接口快速让新账号继承并进入原有群组，确保业务不中断。
- 关键词监听部署：机器人入群后，配合“消息回调”接口，实现对特定群聊内关键词的实时监控与自动回复。
5. FAQ
Q：主动加群会有频率限制吗？
A：有的。为了保护账号权重，建议单个账号每天主动入群数量控制在合理范围内（如 10-20 个）。建议通过多个机器人实例分摊加群任务。
Q：支持加入外部扫描二维码的群吗？
A：支持。接口支持识别群二维码图片并模拟扫码入群动作，只要该群未开启“群主确认”或未达到人数上限。
Q：加入群聊后能立刻发消息吗？
A：入群成功后，接口会返回 chat_id。获取该 ID 后，即可调用“发送群消息”接口进行互动。
6. 开发者资源
- 查看完整 API 文档：doc.qiweapi.com/
- 访问官方网站：www.qiweapi.com/
