Appearance
邀请群成员(40 人以上)
通过邀请卡片邀请好友加入微信群聊。
接口地址: POST /inviteChatRoomMember
前置条件
- 微信实例已登录,并已获得可用的
wId。 - 当前微信实例仍在目标群聊中,并具备邀请成员权限。
- 群人数在 40 人以上且未开启群聊邀请确认时,适合使用本接口。
- 如果群人数在 40 人以下且未开启群聊邀请确认,可使用 添加群成员。
- 如果群开启了群聊邀请确认,请使用 邀请群成员(开启群验证)。
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
wId | 是 | string | 登录实例标识 |
chatRoomId | 是 | string | 群 ID |
userList | 是 | string | 群成员微信 ID,多个用英文逗号分隔 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
code | string | 1000 成功,1001 失败 |
message | string | 反馈信息 |
data | null | 成功或失败时通常为空 |
请求示例
json
{
"wId": "349be9b5-8734-45ce-811d-4e10ca568c67",
"chatRoomId": "24187765053@chatroom",
"userList": "wxid_ew6i9qdxlinu12,wxid_nqo37ves8w5t22"
}成功响应
json
{
"message": "成功",
"code": "1000",
"data": null
}错误响应
json
{
"message": "失败",
"code": "1001",
"data": null
}使用建议
- 本接口会向被邀请人发送入群邀请卡片,是否入群取决于对方操作和微信侧规则。
- 业务系统应区分“邀请已发出”和“成员已入群”两个状态,不要把接口成功等同于最终入群。
- 邀请后可通过 获取群成员 判断成员是否已经加入。
