mass

Documentation

Overview

群发消息.

Index

• Constants
• type Client
  • func NewClient(AccessTokenServer mp.AccessTokenServer, httpClient *http.Client) Client
  • func (clt Client) DeleteMass(msgid int64) (err error)
  • func (clt Client) GetMassStatus(msgid int64) (status *MassStatus, err error)
• type MassSendJobFinishEvent
  • func GetMassSendJobFinishEvent(msg *mp.MixedMessage) *MassSendJobFinishEvent
• type MassStatus

Constants

const (
	EventTypeMassSendJobFinish = "MASSSENDJOBFINISH"
)

Types

type Client

type Client struct {
	*mp.WechatClient
}

func NewClient

func NewClient(AccessTokenServer mp.AccessTokenServer, httpClient *http.Client) Client

兼容保留, 建議實際項目全局維護一個 *mp.WechatClient

func (Client) DeleteMass

func (clt Client) DeleteMass(msgid int64) (err error)

删除群发.

请注意:
只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效，已经收到的用户，
还是能在其本地看到消息卡片。 另外，删除群发消息只能删除图文消息和视频消息，
其他类型的消息一经发送，无法删除。

func (Client) GetMassStatus

func (clt Client) GetMassStatus(msgid int64) (status *MassStatus, err error)

查询群发消息发送状态

type MassSendJobFinishEvent

type MassSendJobFinishEvent struct {
	XMLName struct{} `xml:"xml" json:"-"`
	mp.CommonMessageHeader

	Event string `xml:"Event" json:"Event"` // 事件信息，此处为 MASSSENDJOBFINISH

	MsgId int64 `xml:"MsgId" json:"MsgId"` // 群发的消息ID, 64位整型

	// 群发的结构, 为 "send success" 或 "send fail" 或 "err(num)".
	// 但 send success 时, 也有可能因用户拒收公众号的消息, 系统错误等原因造成少量用户接收失败.
	// err(num) 是审核失败的具体原因, 可能的情况如下:
	// err(10001), //涉嫌广告
	// err(20001), //涉嫌政治
	// err(20004), //涉嫌社会
	// err(20002), //涉嫌色情
	// err(20006), //涉嫌违法犯罪
	// err(20008), //涉嫌欺诈
	// err(20013), //涉嫌版权
	// err(22000), //涉嫌互推(互相宣传)
	// err(21000), //涉嫌其他
	Status string `xml:"Status" json:"Status"`

	TotalCount int `xml:"TotalCount" json:"TotalCount"` // group_id 下粉丝数, 或者 openid_list 中的粉丝数

	// 过滤(过滤是指特定地区, 性别的过滤, 用户设置拒收的过滤; 用户接收已超4条的过滤）后,
	// 准备发送的粉丝数, 原则上, FilterCount = SentCount + ErrorCount
	FilterCount int `xml:"FilterCount" json:"FilterCount"`
	SentCount   int `xml:"SentCount"   json:"SentCount"`  // 发送成功的粉丝数
	ErrorCount  int `xml:"ErrorCount"  json:"ErrorCount"` // 发送失败的粉丝数
}

高级群发消息, 事件推送群发结果

func GetMassSendJobFinishEvent

func GetMassSendJobFinishEvent(msg *mp.MixedMessage) *MassSendJobFinishEvent

type MassStatus

type MassStatus struct {
	MsgId  int64  `json:"msg_id"`
	Status string `json:"msg_status"` // 消息发送后的状态，SEND_SUCCESS表示发送成功
}