mass

Documentation

Overview

群发消息.

Index

• Constants
• func Delete(clt *core.Client, msgid int64, article_idx int) (err error)
• type MassSendJobFinishEvent
  • func GetMassSendJobFinishEvent(msg *core.MixedMsg) *MassSendJobFinishEvent
• type Result
• type Status
  • func GetStatus(clt *core.Client, msgid int64) (status *Status, err error)

Constants

const (
	EventTypeMassSendJobFinish core.EventType = "MASSSENDJOBFINISH"
)

Functions

func Delete

func Delete(clt *core.Client, msgid int64, article_idx int) (err error)

Delete 删除群发. msgid 发送出去的消息ID article_idx 要删除的文章在图文消息中的位置，第一篇编号为1，该字段不填或填0会删除全部文章

Types

type MassSendJobFinishEvent

type MassSendJobFinishEvent struct {
	XMLName struct{} `xml:"xml" json:"-"`
	core.MsgHeader
	EventType core.EventType `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 *core.MixedMsg) *MassSendJobFinishEvent

type Result

type Result struct {
	MsgId int64 `json:"msg_id"` // 消息发送任务的ID

	// 消息的数据ID，该字段只有在群发图文消息时，才会出现。可以用于在图文分析数据接口中，获取到对应的图文消息的数据，
	// 是图文分析数据接口中的msgid字段中的前半部分，详见图文分析数据接口中的msgid字段的介绍。
	MsgDataId int64 `json:"msg_data_id"`
}

群发结果

type Status

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

func GetStatus

func GetStatus(clt *core.Client, msgid int64) (status *Status, err error)

GetStatus 查询群发消息发送状态.