1.模板消息解释说明
1)说明:服务号订阅通知功能开启灰度测试,模板消息能力可正常使用
模板消息仅用于公众号向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。
2)关于使用规则,请注意:
- 所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口,但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限;
- 需要选择公众账号服务所处的2个行业,每月可更改1次所选行业;
- 在所选择行业的模板库中选用已有的模板进行调用;
- 每个账号可以同时使用25个模板。
- 当前每个账号的模板消息的日调用上限为10万次,单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次,可在 MP 登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时,模板消息的日调用上限会相应提升,以公众号 MP 后台开发者中心页面中标明的数字为准。
3)关于接口文档,请注意:
- 模板消息调用时主要需要模板 ID 和模板中各参数的赋值内容;
- 模板中参数内容必须以".DATA"结尾,否则视为保留字;
- 模板保留符号""。
2.Unionid/Openid机制解释说明
1)获取用户基本信息(UnionID机制)
在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID(加密后的微信号,每个用户对每个公众号的 OpenID 是唯一的。对于不同公众号,同一用户的 openid 不同)。公众号可通过本接口来根据 OpenID 获取用户基本信息,包括语言和关注时间。
请注意,如果开发者有在多个公众号,或在公众号、移动应用之间统一用户帐号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才可利用 UnionID 机制来满足上述需求。
2)UnionID机制说明:
开发者可通过 OpenID 来获取用户基本信息。特别需要注意的是,如果开发者拥有多个移动应用、网站应用和公众帐号,可通过获取用户基本信息中的 unionid 来区分用户的唯一性,因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号,用户的 unionid 是唯一的。换句话说,同一用户,对同一个微信开放平台下的不同应用,unionid是相同的。
请注意: 20年6月8日起,用户关注来源“微信广告(ADD_SCENE_WECHAT_ADVERTISEMENT)”从“其他(ADD_SCENE_OTHERS)”中拆分给出,2021年12月27日之后,不再输出头像、昵称信息。
3.“function category of API need be confirmed by component rid”错误
是由于使用未认证的微信公众号或者个人微信公众号没有此动作的接口权限导致, 也有可能是授权时未勾选对于的授权权限所致
【解决方法】:
1 此接口必须使用企业认证的微信公众号,未认证公众号或者个人公众号无法使用,请尝试使用其他动作。如果您不确认您的公众号状态,可以登录公众号管理后台,https://mp.weixin.qq.com/, 在右上方查看:

2 如果您的微信公众号已经是“企业认证”状态,在微信公众号管理界面,点击 设置与开发/公众号设置/授权管理 中是否给与了集简云足够的授权。

4.用户关注微信公众号后,是否可以同步用户相关信息到第三方系统内?
微信公众号个人隐私保护,现在不支持获取用户的昵称、头像等信 息,但可以获取到关注用户的openID。
5.怎样查看微信公众号是否有接口权限?
如果想要查看微信公众号”接口权限“相关问题,点击下方链接,请参考【权限说明】文档
6.微信公众号接口调用超限了怎么办?
公众号调用接口并不是无限制的。为了防止公众号的程序错误而引发微信服务器负载异常,默认情况下,每个公众号调用接口都不能超过一定限制,当超过一定限制时,调用对应接口会收到如下错误返回码:
{"errcode":45009,"errmsg":"api freq out of limit"}
开发者可以登录微信公众平台,在帐号后台开发者中心接口权限模板查看帐号各接口当前的日调用上限和实时调用量,对于认证帐号可以对实时调用量清零,说明如下:
1、由于指标计算方法或统计时间差异,实时调用量数据可能会出现误差,一般在1%以内。
2、每个帐号每月共10次清零操作机会,清零生效一次即用掉一次机会(10次包括了平台上的清零和调用接口 API 的清零)。
3、第三方帮助公众号调用时,实际上是在消耗公众号自身的quota。
4、每个有接口调用限额的接口都可以进行清零操作。
新注册帐号各接口调用频率限制如下:
| 接口 | 每日限额 |
|---|---|
| 获取access_token | 2000 |
| 自定义菜单创建 | 1000 |
| 自定义菜单查询 | 10000 |
| 自定义菜单删除 | 1000 |
| 创建分组 | 1000 |
| 获取分组 | 1000 |
| 修改分组名 | 1000 |
| 移动用户分组 | 100000 |
| 上传多媒体文件 | 100000 |
| 下载多媒体文件 | 200000 |
| 发送客服消息 | 500000 |
| 高级群发接口 | 100 |
| 上传图文消息接口 | 10 |
| 删除图文消息接口 | 10 |
| 获取带参数的二维码 | 100000 |
| 获取关注者列表 | 500 |
| 获取用户基本信息 | 5000000 |
| 获取网页授权access_token | 无 |
| 刷新网页授权access_token | 无 |
| 网页授权获取用户信息 | 无 |
| 设置用户备注名 | 10000 |
| 草稿箱 - 新建草稿 | 1000 |
| 草稿箱 - 获取草稿 | 500 |
| 草稿箱 - 删除草稿 | 1000 |
| 草稿箱 - 修改草稿 | 1000 |
| 草稿箱 - 获取草稿总数 | 1000 |
| 草稿箱 - 获取草稿列表 | 1000 |
| 发布能力 - 发布接口 | 100 |
| 发布能力 - 发布状态轮询接口 | 100 |
| 发布能力 - 删除发布 | 10 |
| 发布能力 - 通过 article_id 获取已发布文章 | 100 |
| 发布能力 - 获取成功发布列表 | 100 |
请注意,在测试号申请页中申请的测试号,接口调用频率限制如下:
| 接口 | 每日限额 |
|---|---|
| 获取access_token | 200 |
| 自定义菜单创建 | 100 |
| 自定义菜单查询 | 1000 |
| 自定义菜单删除 | 100 |
| 创建分组 | 100 |
| 获取分组 | 100 |
| 修改分组名 | 100 |
| 移动用户分组 | 1000 |
| 素材管理 - 临时素材上传 | 500 |
| 素材管理 - 临时素材下载 | 1000 |
| 发送客服消息 | 50000 |
| 获取带参数的二维码 | 10000 |
| 获取关注者列表 | 100 |
| 获取用户基本信息 | 500000 |
| 获取网页授权access_token | 无 |
| 刷新网页授权access_token | 无 |
| 网页授权获取用户信息 | 无 |
公众号调用或第三方平台帮公众号调用对公众号的所有 api 调用(包括第三方帮其调用)次数进行清零:
接口详情可查看https://developers.weixin.qq.com/doc/offiaccount/openApi/clear_quota.html
7.微信公众号出现错误码了怎么办?
公众号每次调用接口时,可能获得正确或错误的返回码,开发者可以根据返回码信息调试接口,排查错误。
全局返回码说明如下:
| 返回码 | 说明 |
|---|---|
| -1 | 系统繁忙,此时请开发者稍候再试 |
| 0 | 请求成功 |
| 40001 | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
| 40002 | 不合法的凭证类型 |
| 40003 | 不合法的 OpenID ,请开发者确认 OpenID (该用户)是否已关注公众号,或是否是其他公众号的 OpenID |
| 40004 | 不合法的媒体文件类型 |
| 40005 | 不合法的文件类型 |
| 40006 | 不合法的文件大小 |
| 40007 | 不合法的媒体文件 id |
| 40008 | 不合法的消息类型 |
| 40009 | 不合法的图片文件大小 |
| 40010 | 不合法的语音文件大小 |
| 40011 | 不合法的视频文件大小 |
| 40012 | 不合法的缩略图文件大小 |
| 40013 | 不合法的 AppID ,请开发者检查 AppID 的正确性,避免异常字符,注意大小写 |
| 40014 | 不合法的 access_token ,请开发者认真比对 access_token 的有效性(如是否过期),或查看是否正在为恰当的公众号调用接口 |
| 40015 | 不合法的菜单类型 |
| 40016 | 不合法的按钮个数 |
| 40017 | 不合法的按钮类型 |
| 40018 | 不合法的按钮名字长度 |
| 40019 | 不合法的按钮 KEY 长度 |
| 40020 | 不合法的按钮 URL 长度 |
| 40021 | 不合法的菜单版本号 |
| 40022 | 不合法的子菜单级数 |
| 40023 | 不合法的子菜单按钮个数 |
| 40024 | 不合法的子菜单按钮类型 |
| 40025 | 不合法的子菜单按钮名字长度 |
| 40026 | 不合法的子菜单按钮 KEY 长度 |
| 40027 | 不合法的子菜单按钮 URL 长度 |
| 40028 | 不合法的自定义菜单使用用户 |
| 40029 | 无效的 oauth_code |
| 40030 | 不合法的 refresh_token |
| 40031 | 不合法的 openid 列表 |
| 40032 | 不合法的 openid 列表长度 |
| 40033 | 不合法的请求字符,不能包含 \uxxxx 格式的字符 |
| 40035 | 不合法的参数 |
| 40038 | 不合法的请求格式 |
| 40039 | 不合法的 URL 长度 |
| 40048 | 无效的url |
| 40050 | 不合法的分组 id |
| 40051 | 分组名字不合法 |
| 40060 | 删除单篇图文时,指定的 article_idx 不合法 |
| 40117 | 分组名字不合法 |
| 40118 | media_id 大小不合法 |
| 40119 | button 类型错误 |
| 40120 | 子 button 类型错误 |
| 40121 | 不合法的 media_id 类型 |
| 40125 | 无效的appsecret |
| 40132 | 微信号不合法 |
| 40137 | 不支持的图片格式 |
| 40155 | 请勿添加其他公众号的主页链接 |
| 40163 | oauth_code已使用 |
| 41001 | 缺少 access_token 参数 |
| 41002 | 缺少 appid 参数 |
| 41003 | 缺少 refresh_token 参数 |
| 41004 | 缺少 secret 参数 |
| 41005 | 缺少多媒体文件数据 |
| 41006 | 缺少 media_id 参数 |
| 41007 | 缺少子菜单数据 |
| 41008 | 缺少 oauth code |
| 41009 | 缺少 openid |
| 42001 | access_token 超时,请检查 access_token 的有效期,请参考基础支持 - 获取 access_token 中,对 access_token 的详细机制说明 |
| 42002 | refresh_token 超时 |
| 42003 | oauth_code 超时 |
| 42007 | 用户修改微信密码, accesstoken 和 refreshtoken 失效,需要重新授权 |
| 42010 | 相同 media_id 群发过快,请重试 |
| 43001 | 需要 GET 请求 |
| 43002 | 需要 POST 请求 |
| 43003 | 需要 HTTPS 请求 |
| 43004 | 需要接收者关注 |
| 43005 | 需要好友关系 |
| 43019 | 需要将接收者从黑名单中移除 |
| 44001 | 多媒体文件为空 |
| 44002 | POST 的数据包为空 |
| 44003 | 图文消息内容为空 |
| 44004 | 文本消息内容为空 |
| 45001 | 多媒体文件大小超过限制 |
| 45002 | 消息内容超过限制 |
| 45003 | 标题字段超过限制 |
| 45004 | 描述字段超过限制 |
| 45005 | 链接字段超过限制 |
| 45006 | 图片链接字段超过限制 |
| 45007 | 语音播放时间超过限制 |
| 45008 | 图文消息超过限制 |
| 45009 | 接口调用超过限制 |
| 45010 | 创建菜单个数超过限制 |
| 45011 | API 调用太频繁,请稍候再试 |
| 45015 | 回复时间超过限制 |
| 45016 | 系统分组,不允许修改 |
| 45017 | 分组名字过长 |
| 45018 | 分组数量超过上限 |
| 45047 | 客服接口下行条数超过上限 |
| 45064 | 创建菜单包含未关联的小程序 |
| 45065 | 相同 clientmsgid 已存在群发记录,返回数据中带有已存在的群发任务的 msgid |
| 45066 | 相同 clientmsgid 重试速度过快,请间隔1分钟重试 |
| 45067 | clientmsgid 长度超过限制 |
| 46001 | 不存在媒体数据 |
| 46002 | 不存在的菜单版本 |
| 46003 | 不存在的菜单数据 |
| 46004 | 不存在的用户 |
| 47001 | 解析 JSON/XML 内容错误 |
| 48001 | api 功能未授权,请确认公众号已获得该接口,可以在公众平台官网 - 开发者中心页中查看接口权限 |
| 48002 | 粉丝拒收消息(粉丝在公众号选项中,关闭了 “ 接收消息 ” ) |
| 48004 | api 接口被封禁,请登录 mp.weixin.qq.com 查看详情 |
| 48005 | api 禁止删除被自动回复和自定义菜单引用的素材 |
| 48006 | api 禁止清零调用次数,因为清零次数达到上限 |
| 48008 | 没有该类型消息的发送权限 |
| 50001 | 用户未授权该 api |
| 50002 | 用户受限,可能是违规后接口被封禁 |
| 50005 | 用户未关注公众号 |
| 53500 | 发布功能被封禁 |
| 53501 | 频繁请求发布 |
| 53502 | Publish ID 无效 |
| 53600 | Article ID 无效 |
| 61451 | 参数错误 (invalid parameter) |
| 61452 | 无效客服账号 (invalid kf_account) |
| 61453 | 客服帐号已存在 (kf_account exsited) |
| 61454 | 客服帐号名长度超过限制 ( 仅允许 10 个英文字符,不包括 @ 及 @ 后的公众号的微信号 )(invalid kf_acount length) |
| 61455 | 客服帐号名包含非法字符 ( 仅允许英文 + 数字 )(illegal character in kf_account) |
| 61456 | 客服帐号个数超过限制 (10 个客服账号 )(kf_account count exceeded) |
| 61457 | 无效头像文件类型 (invalid file type) |
| 61450 | 系统错误 (system error) |
| 61500 | 日期格式错误 |
| 63001 | 部分参数为空 |
| 63002 | 无效的签名 |
| 65301 | 不存在此 menuid 对应的个性化菜单 |
| 65302 | 没有相应的用户 |
| 65303 | 没有默认菜单,不能创建个性化菜单 |
| 65304 | MatchRule 信息为空 |
| 65305 | 个性化菜单数量受限 |
| 65306 | 不支持个性化菜单的帐号 |
| 65307 | 个性化菜单信息为空 |
| 65308 | 包含没有响应类型的 button |
| 65309 | 个性化菜单开关处于关闭状态 |
| 65310 | 填写了省份或城市信息,国家信息不能为空 |
| 65311 | 填写了城市信息,省份信息不能为空 |
| 65312 | 不合法的国家信息 |
| 65313 | 不合法的省份信息 |
| 65314 | 不合法的城市信息 |
| 65316 | 该公众号的菜单设置了过多的域名外跳(最多跳转到 3 个域名的链接) |
| 65317 | 不合法的 URL |
| 87009 | 无效的签名 |
| 9001001 | POST 数据参数不合法 |
| 9001002 | 远端服务不可用 |
| 9001003 | Ticket 不合法 |
| 9001004 | 获取摇周边用户信息失败 |
| 9001005 | 获取商户信息失败 |
| 9001006 | 获取 OpenID 失败 |
| 9001007 | 上传文件缺失 |
| 9001008 | 上传素材的文件类型不合法 |
| 9001009 | 上传素材的文件尺寸不合法 |
| 9001010 | 上传失败 |
| 9001020 | 帐号不合法 |
| 9001021 | 已有设备激活率低于 50% ,不能新增设备 |
| 9001022 | 设备申请数不合法,必须为大于 0 的数字 |
| 9001023 | 已存在审核中的设备 ID 申请 |
| 9001024 | 一次查询设备 ID 数量不能超过 50 |
| 9001025 | 设备 ID 不合法 |
| 9001026 | 页面 ID 不合法 |
| 9001027 | 页面参数不合法 |
| 9001028 | 一次删除页面 ID 数量不能超过 10 |
| 9001029 | 页面已应用在设备中,请先解除应用关系再删除 |
| 9001030 | 一次查询页面 ID 数量不能超过 50 |
| 9001031 | 时间区间不合法 |
| 9001032 | 保存设备与页面的绑定关系参数错误 |
| 9001033 | 门店 ID 不合法 |
| 9001034 | 设备备注信息过长 |
| 9001035 | 设备申请参数不合法 |
| 9001036 | 查询起始值 begin 不合法 |
微信公众号是可以是企业或者个人注册的认证过的公众号,可以是服务号也可以是订阅号。不同认证和类型的微信公众号权限不同,我们建议使用企业已认证的服务号在集简云的数据流程中以使用全部功能。