2014年7月15日 (二) 16:00的最后版本

根据分组进行群发

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

HTTP 请求方式：POST

POST数据说明： 文本

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

图文消息

{
   "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."
}

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

根据UID列表群发

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

POST数据说明：

文本

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

图文消息

{
    "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（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>