public interface WxMpMassMessageService
提供微信公众号群发消息的功能，包括图文消息、视频消息的群发， 支持按分组群发、按openid列表群发、消息预览、群发状态查询等功能。
详情请见：群发消息开发文档
Created by Binary Wang on 2017-8-16.| 限定符和类型 | 方法和说明 |
|---|---|
void |
delete(Long msgId,
Integer articleIndex)
删除群发
群发之后，随时可以通过该接口删除群发。
|
WxMpMassSendResult |
massGroupMessageSend(WxMpMassTagMessage message)
分组群发消息
如果发送图文消息，必须先使用
massNewsUpload(WxMpMassNews) 获得media_id，然后再发送
如果发送视频消息，必须先使用 massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
|
WxMpMassSendResult |
massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage)
群发消息预览接口
开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。
|
WxMpMassUploadResult |
massNewsUpload(WxMpMassNews news)
上传群发用的图文消息，上传后才能群发图文消息
|
WxMpMassSendResult |
massOpenIdsMessageSend(WxMpMassOpenIdsMessage message)
按openId列表群发消息
如果发送图文消息，必须先使用
massNewsUpload(WxMpMassNews) 获得media_id，然后再发送
如果发送视频消息，必须先使用 massVideoUpload(WxMpMassVideo) 获得media_id，然后再发送
|
WxMpMassUploadResult |
massVideoUpload(WxMpMassVideo video)
上传群发用的视频，上传后才能群发视频消息
|
WxMpMassGetResult |
messageMassGet(Long msgId)
查询群发消息发送状态【订阅号与服务号认证后均可用】
|
WxMpMassSpeedGetResult |
messageMassSpeedGet()
获取群发速度
|
void |
messageMassSpeedSet(Integer speed)
设置群发速度
|
WxMpMassUploadResult massNewsUpload(WxMpMassNews news) throws WxErrorException
上传群发用的图文消息，上传后才能群发图文消息
news - 图文消息对象WxErrorException - 微信API调用异常，可能包括：
massGroupMessageSend(WxMpMassTagMessage),
massOpenIdsMessageSend(WxMpMassOpenIdsMessage),
上传群发用的图文消息WxMpMassUploadResult massVideoUpload(WxMpMassVideo video) throws WxErrorException
上传群发用的视频，上传后才能群发视频消息
video - 视频消息对象WxErrorException - 微信API调用异常，可能包括：
massGroupMessageSend(WxMpMassTagMessage),
massOpenIdsMessageSend(WxMpMassOpenIdsMessage),
上传群发用的视频WxMpMassSendResult massGroupMessageSend(WxMpMassTagMessage message) throws WxErrorException
分组群发消息 如果发送图文消息，必须先使用massNewsUpload(WxMpMassNews)获得media_id，然后再发送 如果发送视频消息，必须先使用massVideoUpload(WxMpMassVideo)获得media_id，然后再发送
message - 分组群发消息对象WxErrorException - 微信API调用异常，可能包括：
WxMpMassSendResult massOpenIdsMessageSend(WxMpMassOpenIdsMessage message) throws WxErrorException
按openId列表群发消息 如果发送图文消息，必须先使用massNewsUpload(WxMpMassNews)获得media_id，然后再发送 如果发送视频消息，必须先使用massVideoUpload(WxMpMassVideo)获得media_id，然后再发送
message - 按openid列表群发消息对象WxErrorException - 微信API调用异常，可能包括：
WxMpMassSendResult massMessagePreview(WxMpMassPreviewMessage wxMpMassPreviewMessage) throws WxErrorException
群发消息预览接口 开发者可通过该接口发送消息给指定用户，在手机端查看消息的样式和排版。为了满足第三方平台开发者的需求， 在保留对openID预览能力的同时，增加了对指定微信号发送预览的能力，但该能力每日调用次数有限制（100次），请勿滥用。
wxMpMassPreviewMessage - 预览消息对象WxErrorException - 微信API调用异常，可能包括：
void delete(Long msgId, Integer articleIndex) throws WxErrorException
删除群发 群发之后，随时可以通过该接口删除群发。 请注意： 1、只有已经发送成功的消息才能删除 2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。 3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。 4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效
msgId - 发送出去的消息IDarticleIndex - 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章WxErrorException - 微信API调用异常，可能包括：
WxMpMassSpeedGetResult messageMassSpeedGet() throws WxErrorException
获取群发速度
WxErrorException - 微信API调用异常，可能包括：
void messageMassSpeedSet(Integer speed) throws WxErrorException
设置群发速度
speed - 群发速度的级别，是一个0到4的整数，数字越大表示群发速度越慢。
speed realspeed
0 80w/分钟
1 60w/分钟
2 45w/分钟
3 30w/分钟
4 10w/分钟WxErrorException - 微信API调用异常，可能包括：
WxMpMassGetResult messageMassGet(Long msgId) throws WxErrorException
查询群发消息发送状态【订阅号与服务号认证后均可用】
msgId - 群发消息后返回的消息idWxErrorException - 微信API调用异常，可能包括：
Copyright © 2026. All rights reserved.