高级群发接口

跳转到: 导航, 搜索

根据分组进行群发

接口调用请求说明: 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>


返回值说明
属性 说明描述
ToUserName 群发发起人的uid
FromUserName 为空
CreateTime 创建时间
MsgType Event
Event 事件信息,此处为MASSSENDJOBFINISH
MsgID 群发的消息ID
Status 群发的结构,为“send success”或“send fail”。但send success时,也有可能因用户拒收公众号的消息、系统错误等原因造成少量用户接收失败
TotalCount group_id下粉丝数,或者uid_list中的粉丝数
FilterCount 过滤(过滤是指特定地区、性别的过滤、用户设置拒收的过滤,用户接收已超规定条数的过滤)后,准备发送的粉丝数,原则上,FilterCount = SentCount + ErrorCount
SentCount 发送成功的粉丝数
ErrorCount 发送失败的粉丝数
文档更新时间: 2014-07-15