从外部群添加联系人：群成员转好友的 API 实现

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