module WeixinAuthorize::Api::Mass

Constants

MSG_TYPE

Public Instance Methods

mass_delete_with_msgid(msg_id) click to toggle source

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

# File lib/weixin_authorize/api/mass.rb, line 30
def mass_delete_with_msgid(msg_id)
  mass_url = "#{mass_base_url}/delete"
  http_post(mass_url, {msg_id: msg_id})
end
mass_get_status(msg_id) click to toggle source

查询群发消息发送状态【订阅号与服务号认证后均可用】

# File lib/weixin_authorize/api/mass.rb, line 44
def mass_get_status(msg_id)
  mass_url = "#{mass_base_url}/get"
  http_post(mass_url, {"msg_id" => msg_id})
end
mass_preview(openid, media_info, msg_type="mpnews") click to toggle source

预览接口【订阅号与服务号认证后均可用】

# File lib/weixin_authorize/api/mass.rb, line 36
def mass_preview(openid, media_info, msg_type="mpnews")
  openid_option = {touser: openid}
  media = generate_media(msg_type, media_info, openid_option)
  mass_url = "#{mass_base_url}/preview"
  http_post(mass_url, media)
end
mass_with_group(group_id, media_info, msgtype="mpnews", is_to_all=false) click to toggle source

media_info= {“media_id” media_id} api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN

# File lib/weixin_authorize/api/mass.rb, line 10
def mass_with_group(group_id, media_info, msgtype="mpnews", is_to_all=false)
  group_option = {filter: {group_id: group_id, is_to_all: is_to_all}}
  media = generate_media(msgtype, media_info, group_option)

  mass_url = "#{mass_base_url}/sendall"
  http_post(mass_url, media)
end
mass_with_openids(openids, media_info, msgtype="mpnews") click to toggle source

api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN if mpvideo, media_info= {“media_id” => media_id, “title” => “title”, “description” => “description”}

# File lib/weixin_authorize/api/mass.rb, line 21
def mass_with_openids(openids, media_info, msgtype="mpnews")
  openid_option = {touser: openids}
  media = generate_media(msgtype, media_info, openid_option)
  mass_url = "#{mass_base_url}/send"
  http_post(mass_url, media)
end

Private Instance Methods

convert_media_info(msg_type, media_info) click to toggle source

如果用户填写的media信息,是字符串,则转换来符合的数据结构,如果 是hash,则直接使用用户的结构。

# File lib/weixin_authorize/api/mass.rb, line 67
def convert_media_info(msg_type, media_info)
  if media_info.is_a?(String)
    if msg_type == "text"
      return {content: media_info}
    else
      return {media_id: media_info}
    end
  end
  media_info
end
generate_media(msg_type, media_info, option) click to toggle source
# File lib/weixin_authorize/api/mass.rb, line 55
def generate_media(msg_type, media_info, option)
  msg_type = msg_type.to_s
  if not MSG_TYPE.include?(msg_type)
    raise MediaTypeException, "#{msg_type} is a invalid msg_type"
  end
  {
    msg_type  => convert_media_info(msg_type, media_info),
    "msgtype" => msg_type
  }.merge(option)
end
mass_base_url() click to toggle source
# File lib/weixin_authorize/api/mass.rb, line 51
def mass_base_url
  "/message/mass"
end