从外部群添加联系人：群成员转好友的 API 实现
/contact/addRoomContact在私域转化链路中的位置与用法
本文介绍如何通过 API 向外部群成员发起好友申请，完成群成员到私域联系人的转化。
功能说明
许多业务希望将外部群内的潜在客户转为一对一好友，便于后续精细化运营。
平台提供/contact/addRoomContact接口，传入 guid、roomId、userId 及 verifyText（验证消息），由执行节点向目标群成员发起好友申请。该能力依赖 RPA 模拟客户端操作，适合在用户已表现出意向（如参与活动、填写表单）后触发，而非无差别批量添加。
快速上手
步骤 | 操作 | 预期结果 |
|---|---|---|
1 | 通过群详情接口获取目标 userId | 获得成员 ID |
2 | 准备简短、明确的 verifyText | 验证文案就绪 |
3 | 调用 addRoomContact 发起申请 | 接口返回成功 |
4 | 在客户端确认申请已发出 | 「新的联系人」中有记录 |
5 | 对方通过后做标签或备注 | 完成私域沉淀 |
代码示例
curl -X POST http://manager.qiweapi.com/qiwe/api/qw/doApi \ -H "X-QIWEI-TOKEN: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "/contact/addRoomContact", "params": { "guid": "你的设备ID", "roomId": "1081449970753", "userId": "168873249850", "verifyText": "您好，我是本次活动助理，方便加您好友发送资料吗？" } }'字段说明
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
guid | string | 是 | 执行节点 ID |
roomId | string | 是 | 外部群 ID |
userId | string | 是 | 目标群成员 ID |
verifyText | string | 是 | 好友申请验证消息 |
落地场景
直播/活动群结束后向活跃成员发起好友申请
用户群内咨询后，销售确认再 API 触发加好友
将群成员导入 SCRM 私域池的前置步骤
与表单提交联动：留资成功后自动申请好友
答疑
问：对方不通过申请怎么办？
API 仅发起申请，是否通过取决于对方；可设置重试策略但避免频繁骚扰。
问：每天申请数量有限制吗？
企业微信对好友申请有风控，建议业务侧控制频率并个性化 verifyText。
问：能否跳过验证直接成为好友？
不能，需对方确认；若已是好友，接口可能返回相应提示。
问：roomId 和 userId 从哪里获取？
群详情、消息 Webhook 事件或联系人查询接口均可提供。
延伸链接
想继续往下做，可以从这里开始：
查看 API 文档 — 完整接口说明、Webhook 配置与快速开始
访问官网平台 — 注册账号、扫码登录节点、在线调试