# 用户管理

# UnionID 机制说明

在关注者与服务号产生消息交互后,服务号可获得关注者的OpenID(加密后的微信号,每个用户对每个服务号的OpenID是唯一的。对于不同服务号,同一用户的openid不同)。服务号可通过获取用户基本信息来根据OpenID获取用户基本信息,包括语言和关注时间。

请注意,如果开发者有在多个服务号,或在服务号、移动应用、小程序、小店、带货助手、网站应用之间统一用户账号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定服务号后,才可利用 UnionID 机制来满足上述需求。

# 用户身份说明

用户身份标记有两种,openid 和 unionid

openid 是微信用户对于一个应用(服务号)的身份标记,同一个微信用户对不同应用(服务号)有不同的 openid

unionid 是微信用户对于一个开放平台的身份标记。如果开发者拥有多个移动应用、网站应用和小程序、小店、带货助手等,可通过获取用户基本信息中的unionid来区分用户的唯一性,因为只要是同一个微信开放平台账号下的移动应用、网站应用和小程序、小店、带货助手,用户的 unionid 是唯一的。

速记公式:

微信用户 + 服务号 AppID = openid
微信用户 + 开放平台账号 = unionid

即,只要服务号 AppID 不变化,openid 不会变。只要服务号绑定的开放平台账号不变,unionid 也不会变。

请注意:

20年6月8日起,用户关注来源“微信广告(ADD_SCENE_WECHAT_ADVERTISEMENT)”从“其他(ADD_SCENE_OTHERS)”中拆分给出,2021年12月27日之后,不再输出头像、昵称信息。

接口列表:

1.获取用户基本信息:点此查看接口文档

2.批量获取用户基本信息:点此查看接口文档

# 接口列表

# 标签管理

接口名称 请求路径 描述
获取标签下粉丝列表 /cgi-bin/user/tag/get 本接口用于获取标签下粉丝列表
获取标签 /cgi-bin/tags/get 本接口用于获取公众号已创建的标签列表
创建标签 /cgi-bin/tags/create 本接口用于创建公众号标签
编辑标签 /cgi-bin/tags/update 本接口用于修改已存在的标签信息
删除标签 /cgi-bin/tags/delete 本接口用于删除已存在的标签信息
批量为用户取消标签 /cgi-bin/tags/members/batchuntagging 本接口用于批量为多个用户取消标签
批量为用户打标签 /cgi-bin/tags/members/batchtagging 本接口用于批量为多个用户打标签
获取用户的标签列表 /cgi-bin/tags/getidlist 本接口用于获取粉丝用户的标签列表

# 用户信息

接口名称 请求路径 描述
取消拉黑用户 /cgi-bin/tags/members/batchunblacklist 本接口用来取消拉黑一批用户,黑名单列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成
获取公众号的黑名单列表 /cgi-bin/tags/members/getblacklist 本接口用来获取账号的黑名单列表,黑名单列表由一串 OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成
获取用户基本信息 /cgi-bin/user/info 在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的
批量获取用户基本信息 /cgi-bin/user/info/batchget 本接口用于批量获取用户基本信息
获取关注用户列表 /cgi-bin/user/get 本接口用来获取账号的关注者列表,关注者列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成
拉黑用户 /cgi-bin/tags/members/batchblacklist 本接口用于拉黑一批用户,黑名单列表由一串 OpenID (加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成
设置用户备注名 /cgi-bin/user/info/updateremark 本接口用于对指定用户设置备注名,该接口暂时开放给微信认证的服务号