微信公众号开发（九）群发消息接口

订阅号每日可以群发一条，服务号每个自然月可以群发4条。

1、根据标签进行群发【订阅号与服务号认证后均可用】

群发文本

sendall_text.php

返回：

{
    "errcode": 0,
    "errmsg": "send job submission success",
    "msg_id": 1000000001
}

推送给index.php的XML文件

<xml>
    <ToUserName>
        <![CDATA[gh_6b9aa8a6f1e2]]>
    </ToUserName>
    <FromUserName>
        <![CDATA[o4WmZ0qcNsoRiDW9LEi1X1gWVBZ0]]>
    </FromUserName>
    <CreateTime>1505397941</CreateTime>
    <MsgType>
        <![CDATA[event]]>
    </MsgType>
    <Event>
        <![CDATA[MASSSENDJOBFINISH]]>
    </Event>
    <MsgID>1000000001</MsgID>
    <Status>
        <![CDATA[send success]]>
    </Status>
    <TotalCount>1</TotalCount>
    <FilterCount>1</FilterCount>
    <SentCount>1</SentCount>
    <ErrorCount>0</ErrorCount>
    <CopyrightCheckResult>
        <Count>0</Count>
        <ResultList></ResultList>
        <CheckState>0</CheckState>
    </CopyrightCheckResult>
</xml>

发送语音

发送语音和发送文本类似，不过格式为：

{
   "filter":{
      "is_to_all":false,
      "tag_id":2
   },
   "voice":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"voice"
}

发送图文

sendall_mpnews.php

返回：

{"errcode":48008,"errmsg":"no permission for this msgtype hint: [PgBA9a0938ge25]"}

说是没有权限，可以调用预览接口测试：

发送图片

发送视频：

uploadvideo.php

返回结果：

{
    "type": "video",
    "media_id": "4KExkgRWTofVOgQZRkCtpTEyFhuYk1Xwr1y-biXNS93U7hICK1rtHgXs8uzntW60",
    "created_at": 1505400804
}

sendall_video.php

2、根据OpenID列表群发【订阅号不可用，服务号认证后可用】

消息格式类似：

{
   "touser":[
    "OPENID1",
    "OPENID2"
   ],
   "mpnews":{
      "media_id":"123dsdajkasd231jhksad"
   },
    "msgtype":"mpnews"，
    "send_ignore_reprint":0
}

这里不再列出代码。

3、删除群发消息【订阅号与服务号认证后均可用】

post数据：

{
   "msg_id":30124,
   "article_idx":2
}

返回：

{
   "errcode":0,
   "errmsg":"ok"
}

说明：

1、只有已经发送成功的消息才能删除 2、删除消息是将消息的图文详情页失效，已经收到的用户，还是能在其本地看到消息卡片。 3、删除群发消息只能删除图文消息和视频消息，其他类型的消息一经发送，无法删除。 4、如果多次群发发送的是一个图文消息，那么删除其中一次群发，就会删除掉这个图文消息也，导致所有群发都失效

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

post数据：

{
   "msg_id": "201053012"
}

返回：

{
     "msg_id":201053012,
     "msg_status":"SEND_SUCCESS"
}

相关博客