1.创建分组
1.1.接口说明
一个公众账号,最多支持创建100个分组。
1.2.调用接口(post方法)
https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
1.3.调用实例
{"group":{"name":"test"}}
1.4.参数说明
access_token: 调用接口凭证
name: 分组名字(30个字符以内)
1.5.返回说明
{ "group": { "id": 107, "name": "test" } }
1.6.返回参数说明
id:分组id,由微信分配
name:分组名字,UTF8编码
1.7.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}
2.查询所有分组
2.1.调用接口(get方法)
https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN
2.2.参数说明
access_token: 调用接口凭证
2.3.返回说明
{ "groups": [ { "id": 0, "name": "未分组", "count": 72596 }, { "id": 1, "name": "黑名单", "count": 36 }, { "id": 2, "name": "星标组", "count": 8 }, { "id": 104, "name": "华东媒", "count": 4 }, { "id": 106, "name": "★不测试组★", "count": 1 } ] }
2.4.返回参数说明
groups:公众平台分组信息列表
id:分组id,由微信分配
name:分组名字,UTF8编码
count: 分组内用户数量
2.5.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}
3.查询用户所在分组
3.1.接口说明
通过用户的OpenID查询其所在的GroupID。
3.2.调用接口(post方法,https协议)
https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN
3.3.调用实例
{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}
3.4.参数说明
access_token: 调用接口凭证
openid:用户的OpenID
3.5.返回说明
{"groupid": 102}
3.6.返回参数说明
groupid: 用户所属的groupid
3.7.返回错误说明
{"errcode":40003,"errmsg":"invalid openid"}
4.修改分组名
4.1.调用接口(post方法)
https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN
4.2.调用实例
{"group":{"id":108,"name":"test2_modify2"}}
4.3.参数说明
access_token:调用接口凭证
id:分组id,由微信分配
name: 分组名字(30个字符以内)
4.4.返回正确说明
{"errcode": 0, "errmsg": "ok"}
4.5.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}
5.移动用户分组
5.1.调用接口(post方法)
https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN
5.2.调用实例
{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}
5.3.参数说明
access_token: 调用接口凭证
openid:用户唯一标识符
to_groupid:分组id
5.4.返回正确说明
{"errcode": 0, "errmsg": "ok"}
5.5.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}
6.批量移除用户分组
6.1.调用接口
https://api.weixin.qq.com/cgi-bin/groups/members/batchupdate?access_token=ACCESS_TOKEN
6.2.调用实例
{"openid_list":["oDF3iYx0ro3_7jD4HFRDfrjdCM58","oDF3iY9FGSSRHom3B-0w5j4jlEyY"],"to_groupid":108}
6.3.参数说明
access_token:调用接口凭证
openid_list:用户唯一标识符openid的列表(size不能超过50)
to_groupid: 分组id
6.4.返回正确说明
{"errcode": 0, "errmsg": "ok"}
6.5.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}
7.删除分组
7.1.接口说明
注意本接口是删除一个用户分组,删除分组后,所有该分组内的用户自动进入默认分组。
7.2.调用接口
https://api.weixin.qq.com/cgi-bin/groups/delete?access_token=ACCESS_TOKEN
7.3.调用实例
{"group":{"id":108}}
7.4.参数说明
access_token: 调用接口凭证
group: 分组
id:分组的id
7.5.返回正确说明
{"errcode": 0, "errmsg": "ok"}
7.6.返回错误说明
{"errcode":40013,"errmsg":"invalid appid"}