群发接口

高级群发接口

在公众平台网站上，为订阅号提供了每天一条的群发权限，为服务号提供每月（自然月）4条的群发权限。

请注意：

1. 对于认证订阅号，群发接口每天可成功调用1次，此次群发可选择发送给全部用户或某个分组；
2. 对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次，但是用户每月只能接收4条，无论在公众平台网站上，还是使用接口群发，用户每月只能接收4条群发消息，多于4条的群发将对该用户发送失败。

群发图文消息的过程如下：

1. 首先，预先将图文消息中需要用到的图片，使用上传图文消息内图片接口，上传成功并获得图片URL。
2. 上传图文消息素材，需要用到图片时，请使用上一步获取的图片URL。
3. 使用对用户分组的群发，或对OpenID列表的群发，将图文消息群发出去。
4. 在上述过程中，如果需要，还可以预览图文消息、查询群发状态，或删除已群发的消息等。

群发图片、文本等其他消息类型的过程如下：

1. 如果是群发文本消息，则直接根据下面的接口说明进行群发即可。
2. 如果是群发图片、视频等消息，则需要预先通过素材管理接口准备好mediaID。

上传图文消息内的图片获取URL【订阅号与服务号认证后均可用】

请注意，本接口所上传的图片不占用公众号的素材库中图片数量的5000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下。

• http请求方式: POST
• 接口地址：https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
• 调用示例（使用curl命令，用FORM表单方式上传一个图片）：
  curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"

开发要点补充：

• 群发接口主要包含：上传图文内图片（uploadimg）、新增图文素材（material/add_news）、按分组/OpenID列表群发（message/mass/sendall 或 message/mass/send）、预览（message/mass/preview）、查询状态（message/mass/get）等。
• 图文消息中的图片必须使用 uploadimg 获取的内部 URL，不能使用外部链接；而群发图片/视频消息需先通过素材管理接口（material/add_material）获取 media_id。
• 群发限制核心在于“用户接收频次”（订阅号每日1条，服务号每月4条），开发时需做好频次控制与失败重试逻辑。