2014年5月15日 (四) 22:27的版本

根据分组进行群发

接口调用请求说明： URL：https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN HTTP 请求方式：POST 授权限制：频次限制是

POST数据说明： 图文素材

{
   "filter":{
      "group_id":"123"      //分组id
   },
   "news":{
      "media_id":"XXXXXXXXXX"    //通过上传图文消息素材生成的短链
   },
    "msgtype":"news"
}

文本

{
   "filter":{
      "group_id":"123"      //分组id
   },
   "text":{
      "content":"CONTENT"  //文本内容
   },
    "msgtype":"text"
}

语音

{
   "filter":{
      "group_id":"123"      //分组id
   },
   "voice":{
      "media_id":"xxxxxxxxx"  //语音id，通过上传下载多媒体文件来得到
   },
    "msgtype":"voice"
}

图片

{
   "filter":{
      "group_id":"123"      //分组id
   },
   "image":{
      "media_id":"xxxxxxxxx"  //图片id，通过上传下载多媒体文件来得到
   },
    "msgtype":"image"
}

图文消息

{
   "filter":{
      "group_id":"123"      //分组id
   },
  "articles": [
        {
            "display_name": "两个故事",
            "summary": "今天讲两个故事，分享给你。谁是公司？谁又是中国人？​",
            "image": "http://storage.mcp.weibo.cn/0JlIv.jpg",
            "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319"
        },
        ... //最多支持8个图文，建议为1或3个
    ],
    "msgtype":"articles"
}

//返回说明 调用成功时的返回值:

{
    "result": true,    
    "msg_id": xxxxx   //成功返回true，消息ID

}

调用失败时的返回值:

{
    "request": "https://m.api.weibo.com/2/messages/sendall",
    "errcode": "1000XX",
    "errmsg": "error message."
}

请注意：在返回成功时，意味着群发任务提交成功，并不意味着此时群发已经结束，所以，仍有可能在后续的发送过程中出现异常情况导致用户未收到消息，如消息有时会进行审核、服务器不稳定等。此外，群发任务一般需要较长的时间才能全部发送完毕，请耐心等待。

根据OpenID列表群发

接口调用请求说明： URL：https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN HTTP 请求方式：POST

POST数据说明：

图文素材

{
   "touser":[
    "uid1",
    "uid2"
   ],
   "news":{
      "media_id":"XXXXXXXXXX"    //通过上传图文消息素材生成的短链
   },
    "msgtype":"news"
}

文本

{
   "touser":[
    "uid1",
    "uid2"
   ],
   "text":{
      "content":"CONTENT"  //文本内容
   },
    "msgtype":"text"
}

语音

{
    "touser":[
    "uid1",
    "uid2"
   ],
   "voice":{
      "media_id":"xxxxxxxxx"  //语音id，通过上传下载多媒体文件来得到
   },
    "msgtype":"voice"
}

图片

{
   "touser":[
    "uid1",
    "uid2"
   ],
   "image":{
      "media_id":"xxxxxxxxx"  //图片id，通过上传下载多媒体文件来得到
   },
    "msgtype":"image"
}

图文消息

{
    "touser":[
    "uid1",
    "uid2"
   ],
  "articles": [
        {
            "display_name": "两个故事",
            "summary": "今天讲两个故事，分享给你。谁是公司？谁又是中国人？​",
            "image": "http://storage.mcp.weibo.cn/0JlIv.jpg",
            "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319"
        },
        ... //最多支持8个图文，建议为1或3个
    ],
    "msgtype":"articles"
}

//返回说明 调用成功时的返回值:

{
    "result": true,    
    "msg_id": xxxxx   //成功返回true，消息ID

}

调用失败时的返回值:

{
    "request": "https://m.api.weibo.com/2/messages/sendall",
    "errcode": "1000XX",
    "errmsg": "error message."
}

请注意：在返回成功时，意味着群发任务提交成功，并不意味着此时群发已经结束，所以，仍有可能在后续的发送过程中出现异常情况导致用户未收到消息，如消息有时会进行审核、服务器不稳定等。此外，群发任务一般需要较长的时间才能全部发送完毕，请耐心等待。

删除群发

接口调用请求说明： URL：https://m.api.weibo.com/2/messages/delete?access_token=ACCESS_TOKEN HTTP 请求方式：POST 授权限制：频次限制是

POST数据说明：

{
    "msgid":12333
}

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

//返回说明 调用成功时的返回值:

{
    "result": true   
}

调用失败时的返回值:

{
    "request": "https://m.api.weibo.com/2/messages/delete",
    "errcode": "1000XX",
    "errmsg": "error message."
}

事情推送群发结果

由于群发任务提交后，群发任务可能在一定时间后才完成，因此，群发接口调用时，仅会给出群发任务是否提交成功的提示，若群发任务提交成功，则在群发任务结束时，会向开发者在粉丝服务平台填写的开发者URL（callback URL）推送事件。

推送的XML结构如下（发送成功时）：

<xml>
<ToUserName><![CDATA[gh_3e8adccde292]]></ToUserName>
<FromUserName><![CDATA[oR5Gjjl_eiZoUpGozMo7dbBJ362A]]></FromUserName>
<CreateTime>1394524295</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[MASSSENDJOBFINISH]]></Event>
<MsgID>1988</MsgID>
<Status><![CDATA[sendsuccess]]></Status>
<TotalCount>100</TotalCount>
<FilterCount>80</FilterCount>
<SentCount>75</SentCount>
<ErrorCount>5</ErrorCount>
</xml>