微博开放平台
微连接
移动应用
网站接入
电商服务商
电商商家
数据服务
数据服务
合作伙伴
微博支付
轻应用
粉丝服务
文档
推广
我的应用
登录
weibo
开发文档
首页
平台政策与指引
概述
平台公约
新手指南
开发者协议
应用运营管理规范
微连接分级管理办法
应用审核产品指南
应用安全开发注意事项
平台应用设计规范
微服务接入指南
微博登录接入
用微博帐号登录
授权机制
移动应用接入
移动应用介绍
移动应用SSO授权
微博Deep Link
媒体接入平台
头条文章开放接口
视频上传开放接口
电商接入平台
电商服务商接入
电商商家端接入
电商平台能力接口
粉丝服务平台
粉丝服务平台
新手接入指南
微信开发者迁移指南
接收消息
发送消息
自定义菜单
用户管理
生成带参数的二维码
Fans Service Platform
商业接口
商业数据接入指南
订阅服务手册(中文版)
订阅服务手册(英文版)
商业接口-REST API
商业数据常见问题
网站接入
网站接入介绍
微博API
微博API
接口访问频次权限
资源下载
SDK
微博标识下载
常见问题
联系我们
工具箱
链入页面
链出更改
特殊页面
查看源代码
跳转到:
导航
,
搜索
根据下列原因,你没有权限编辑本页:
您刚才请求的操作只有这个用户组中的用户才能使用:
用户
您可以查看并复制此页面的源代码:
=根据分组进行群发= 接口调用请求说明: URL:https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN HTTP 请求方式:POST POST数据说明: '''图文素材'''(二期上线) <pre> { "filter":{ "group_id":"123" //分组id }, "news":{ "media_id":"XXXXXXXXXX" //通过上传图文消息素材生成的短链 }, "msgtype":"news" } </pre> '''文本''' <pre> { "filter":{ "group_id":"123" //分组id }, "text":{ "content":"CONTENT" //文本内容 }, "msgtype":"text" } </pre> '''图文消息''' <pre> { "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" } </pre> //返回说明 调用成功时的返回值: <pre> { "result": true, "msg_id": xxxxx //成功返回true,消息ID } </pre> 调用失败时的返回值: <pre> { "request": "https://m.api.weibo.com/2/messages/sendall", "errcode": "1000XX", "errmsg": "error message." } </pre> 请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 =根据UID列表群发= 接口调用请求说明: URL:https://m.api.weibo.com/2/messages/sendall?access_token=ACCESS_TOKEN HTTP 请求方式:POST POST数据说明: '''图文素材''' (二期上线) <pre> { "touser":[ "uid1", "uid2" ], "news":{ "media_id":"t.cn/xxx" //通过上传图文消息素材生成的短链 }, "msgtype":"news" } </pre> '''文本''' <pre> { "touser":[ "uid1", "uid2" ], "text":{ "content":"CONTENT" //文本内容 }, "msgtype":"text" } </pre> '''图文消息''' <pre> { "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" } </pre> //返回说明 调用成功时的返回值: <pre> { "result": true, "msg_id": xxxxx //成功返回true,消息ID } </pre> 调用失败时的返回值: <pre> { "request": "https://m.api.weibo.com/2/messages/sendall", "errcode": "1000XX", "errmsg": "error message." } </pre> 请注意:在返回成功时,意味着群发任务提交成功,并不意味着此时群发已经结束,所以,仍有可能在后续的发送过程中出现异常情况导致用户未收到消息,如消息有时会进行审核、服务器不稳定等。此外,群发任务一般需要较长的时间才能全部发送完毕,请耐心等待。 =删除群发(二期上线)= 接口调用请求说明: URL:https://m.api.weibo.com/2/messages/delete?access_token=ACCESS_TOKEN HTTP 请求方式:POST 授权限制:频次限制是 POST数据说明: <pre> { "msgid":12333 } </pre> 请注意,只有已经发送成功的消息才能删除删除消息只是将消息的图文详情页失效,已经收到的用户,还是能在其本地看到消息卡片。 另外,删除群发消息只能删除news和image,其他类型的消息一经发送,无法删除。 //返回说明 调用成功时的返回值: <pre> { "result": true } </pre> 调用失败时的返回值: <pre> { "request": "https://m.api.weibo.com/2/messages/delete", "errcode": "1000XX", "errmsg": "error message." } </pre> =事情推送群发结果(二期上线)= 由于群发任务提交后,群发任务可能在一定时间后才完成,因此,群发接口调用时,仅会给出群发任务是否提交成功的提示,若群发任务提交成功,则在群发任务结束时,会向开发者在粉丝服务平台填写的开发者URL(callback URL)推送事件。 推送的XML结构如下(发送成功时): <pre> <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> </pre> <div class="wiki_kit"> {|width="100%" border="0" cellspacing="0" cellpadding="0" class="wiki_table" <html><colgroup><col class="tbF1"/><col class="tbF2" /><col /></colgroup></html> !colspan="2" scope="col" |<span id="返回值说明">返回值说明</span> |- |style="text-align:center; width: 12%"|属性 |style="text-align:center;"|说明描述 |- |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 |发送失败的粉丝数 |}
返回到
高级群发接口
。
反馈
分享
顶部