首页 > 建站资源 > 微信营销 > 微信公众平台用户分组管理开发文档详解

微信公众平台用户分组管理开发文档详解

时间:2014-02-09    来源:互联网

开发者可以使用接口,对公众平台的分组进行查询、创建、修改操作,也可以使用接口在需要时移动用户到某个分组。

创建分组

一个公众账号,最多支持创建500个分组。 接口调用请求说明

http请求方式: POST(请使用https协议)
https://api.weixin.qq.com/cgi-bin/groups/create?access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:{"group":{"name":"test"}}

参数说明

参数 说明
access_token 调用接口凭证
name 分组名字(30个字符以内)

返回说明 正常时的返回JSON数据包示例:

{
    "group": {
        "id": 107, 
        "name": "test"
    }
}

参数说明

参数 说明
id 分组id,由微信分配
name 分组名字,UTF8编码

错误时的JSON数据包示例(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

全局返回码说明

使用网页调试工具调试该接口

查询所有分组

接口调用请求说明

http请求方式: GET(请使用https协议) https://api.weixin.qq.com/cgi-bin/groups/get?access_token=ACCESS_TOKEN

参数说明

参数 说明
access_token 调用接口凭证

返回说明 正常时的返回JSON数据包示例:

{
    "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
        }
    ]
}

参数说明

参数 说明
groups 公众平台分组信息列表
id 分组id,由微信分配
name 分组名字,UTF8编码
count 分组内用户数量

错误时的JSON数据包示例(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

全局返回码说明

使用网页调试工具调试该接口

查询用户所在分组

通过用户的OpenID查询其所在的GroupID。 接口调用请求说明

http请求方式: POST(请使用https协议)
https://api.weixin.qq.com/cgi-bin/groups/getid?access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:{"openid":"od8XIjsmk6QdVTETa9jLtGWA6KBc"}

参数说明

参数 说明
access_token 调用接口凭证
openid 用户的OpenID

返回说明 正常时的返回JSON数据包示例:

{
    "groupid": 102
}

参数说明

参数 说明
groupid 用户所属的groupid

错误时的JSON数据包示例(该示例为OpenID无效错误):

{"errcode":40003,"errmsg":"invalid openid"}

全局返回码说明

使用网页调试工具调试该接口

修改分组名

接口调用请求说明

http请求方式: POST(请使用https协议)
https://api.weixin.qq.com/cgi-bin/groups/update?access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:{"group":{"id":108,"name":"test2_modify2"}}

参数说明

参数 说明
access_token 调用接口凭证
id 分组id,由微信分配
name 分组名字(30个字符以内)

返回说明 正常时的返回JSON数据包示例:

{"errcode": 0, "errmsg": "ok"}

错误时的JSON数据包示例(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

全局返回码说明

使用网页调试工具调试该接口

移动用户分组

接口调用请求说明

http请求方式: POST(请使用https协议)
https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:{"openid":"oDF3iYx0ro3_7jD4HFRDfrjdCM58","to_groupid":108}

参数说明

参数 说明
access_token 调用接口凭证
openid 用户唯一标识符
to_groupid 分组id

返回说明 正常时的返回JSON数据包示例:

{"errcode": 0, "errmsg": "ok"}

错误时的JSON数据包示例(该示例为AppID无效错误):

{"errcode":40013,"errmsg":"invalid appid"}

全局返回码说明

使用网页调试工具调试该接口

相关推荐
微信公众平台获取关注者列表之开发文档详解
微信公众平台获取用户基本信息之开发文档详解
微信公众平台获取用户地理位置之开发文档详解
微信公众平台生成带参数的二维码之开发文档详解
微信公众平台客服接口之开发文档详解
微信公众平台上传下载多媒体文件之开发文档详解
微信公众平台教程:没有正确响应Token验证的解决方法
微信公众平台消息接口开发教程之语音触发应用
微信公众平台接口开发教程之人脸识别应用
微信公众平台消息接口开发之小黄鸡机器人应用
微信公众号自定义菜单申请与使用问题解答
拆解微信公众平台接口:CRM六大模块真容
微信公众平台自定义菜单开发文档详解
iWork365:微信第三方如何打造移动协作平台
微信开发教程:用户账号绑定到微信公众号的方法分享
微信小程序开发:微信放出公众平台小程序文档和工具
微信公众平台注册与认证图文教程分享
微信公众平台消息管理与群发图文教程
微信公众平台素材编辑与自动回复图文教程
微信公众平台开发模式详解图文教程
微信公众平台公众会议帐号使用详解
10条微信公众平台运营建议分享
微信公众平台消息接口开发教程 附PHP源码
微信公众平台运营十大要诀分享
微信公众平台编辑模式与开发模式详解
36条微信公众平台运营经验分享
商家微信公众号到底能做什么?
初识微信公众平台的在线支付功能
成功运营微信公众账号的四大要点
微信5.0上线 自定义菜单申请将重新开启

精彩推荐

热门教程