Beta

跳转到: 导航, 搜索
第1行: 第1行:
  
 
 
<div style="text-align:center;"><font size="6" style="font-weight:bold">消息服务</font></div>
 
 
 
 
__TOC__
 
 
=消息服务是什么=
 
=消息服务是什么=
 
*消息服务是微博为应用、蓝V提供的与微博用户、粉丝进行消息交互的服务。
 
*消息服务是微博为应用、蓝V提供的与微博用户、粉丝进行消息交互的服务。
第12行: 第5行:
  
  
<font size="3" style="font-weight:bold">涵盖的主要功能模块:</font>
+
'''涵盖的主要功能模块:'''
 +
 
 
<div style="text-align:center;">
 
<div style="text-align:center;">
<img src="http://ww3.sinaimg.cn/large/946308c5jw1e88njxkk7vj20oa05kgm7.jpg" style="height: 90px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message8.png" style="height: 90px;">
 
</div>
 
</div>
  
 +
=粉丝服务开发模式=
  
=自定义回复=
+
==自定义回复==
 
*使用消息服务自定义回复功能,蓝V可以在自身的服务器或指定应用上接收微博用户与蓝V相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
 
*使用消息服务自定义回复功能,蓝V可以在自身的服务器或指定应用上接收微博用户与蓝V相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
  
  
<font size="3" style="font-weight:bold">1、蓝V可接收的用户行为消息类型:</font>
+
'''1、蓝V可接收的用户行为消息类型:'''
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e9p42ajxi3j21880hugs1.jpg" style="width: 680px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message1.png" style="width: 680px;">
  
  
<font size="3" style="font-weight:bold">2、蓝V可回复的私信类型:</font>
+
'''2、蓝V可回复的私信类型:'''
<img src="http://ww2.sinaimg.cn/large/946308c5jw1e9p4bkulb1j21840ho43w.jpg" style="width: 680px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message2.png" style="width: 680px;">
  
 
*回复规则:每条接收到的私信72小时内可回复3次,关注事件等非私信消息72小时内可回复1次。
 
*回复规则:每条接收到的私信72小时内可回复3次,关注事件等非私信消息72小时内可回复1次。
  
  
==自定义回复 - 示例==
+
===自定义回复 - 示例===
  
  
<font size="3" style="font-weight:bold">1、应用于自动回复场景示例:</font>
+
'''1、应用于自动回复场景示例:'''
<img src="http://ww3.sinaimg.cn/large/946308c5jw1e9p4bjyny6j21880p2ahs.jpg" style="width: 680px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message3.png" style="width: 680px;">
 
<div style="text-align:right;">体验:私信[http://e.weibo.com/weathers @查天气]指定城市、关注[http://e.weibo.com/u/3254646623 @海淀桥路况]、关注[http://e.weibo.com/2859258962/zEo3885ev @我的印象笔记]、私信[http://e.weibo.com/kuaisuwenyisheng @快速问医生]、私信[http://e.weibo.com/u/3499336085 @违章管家]</div>
 
<div style="text-align:right;">体验:私信[http://e.weibo.com/weathers @查天气]指定城市、关注[http://e.weibo.com/u/3254646623 @海淀桥路况]、关注[http://e.weibo.com/2859258962/zEo3885ev @我的印象笔记]、私信[http://e.weibo.com/kuaisuwenyisheng @快速问医生]、私信[http://e.weibo.com/u/3499336085 @违章管家]</div>
  
第42行: 第37行:
  
  
<font size="3" style="font-weight:bold">2、应用于人工客服场景示例:</font>
+
'''2、应用于人工客服场景示例:'''
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e9p4bixdaqj21960p2443.jpg" style="width: 680px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message4.png" style="width: 680px;">
  
  
 
+
===自定义回复 - 实现步骤===
==自定义回复 - 实现步骤==
+
  
 
*1、开启开发者模式
 
*1、开启开发者模式
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
**<font style="color:red">内测期间,邮件[mailto:open_api@sina.com open_api@sina.com]申请开启,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。</font>
+
内测期间,邮件[mailto:open_api@sina.com open_api@sina.com]申请开启,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。
 
+
  
 
*2、接收新消息
 
*2、接收新消息
第61行: 第54行:
 
**蓝V通过应用对接收到的新消息进行相应处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。
 
**蓝V通过应用对接收到的新消息进行相应处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。
  
 
+
==私信提醒==
 
+
=好友邀请=
+
*使用消息服务好友邀请功能,应用可以在自身的客户端上激励用户邀请自己微博好友加入应用,邀请将以Card形式私信好友。
+
 
+
 
+
*好友邀请规则:
+
**1,必须由用户主动发起;
+
**2,每用户每小时通过每应用可邀请10个互粉好友。
+
 
+
==好友邀请 - 示例==
+
 
+
 
+
<font size="3" style="font-weight:bold">应用于游戏邀请场景示例:  </font>
+
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e9p4bh14prj21800h8q9x.jpg" style="width: 680px;">
+
<div style="text-align:right;">体验地址:[http://weibo.com/p/100404770915 思密达的快乐家族]</div>
+
 
+
 
+
==好友邀请 - 实现步骤==
+
 
+
*1、使用微博登录
+
**应用引导用户使用微博登录,采用[[授权机制说明|OAuth2]]的[[scope|Scope]]授权方式获得用户“发送私信邀请给你的微博好友”权限。
+
 
+
 
+
*2、获取互粉好友
+
**应用调用[[2/friendships/friends/bilateral|friendships/friends/bilateral]]接口,获取当前用户微博互粉好友列表,友好地引导、鼓励用户邀请好友加入应用或向好友送礼物等。
+
 
+
 
+
*3、发送邀请
+
**应用引导用户向好友发送使用邀请或送礼物,由用户主动发起向好友发送邀请,应用调用[[2/messages/invite|messages/invite]]接口实现向指定好友发送邀请。
+
 
+
 
+
 
+
=私信提醒=
+
 
*使用消息服务私信提醒功能,蓝V可以在自身的服务器或指定应用上向已主动订阅了服务提醒的粉丝发送文字、图文等私信提醒。
 
*使用消息服务私信提醒功能,蓝V可以在自身的服务器或指定应用上向已主动订阅了服务提醒的粉丝发送文字、图文等私信提醒。
  
  
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e9p4faard0j20zq0h6n1t.jpg" style="height: 265px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message7.png" style="height: 265px;">
  
  
第106行: 第66行:
 
**3,不得用于推广、营销、广告等可能对用户造成骚扰的场景。
 
**3,不得用于推广、营销、广告等可能对用户造成骚扰的场景。
  
==私信提醒 - 示例==
+
===私信提醒 - 示例===
  
 
<font size="3" style="font-weight:bold">应用于电子商务微博私信降价提醒场景示例:</font>
 
<font size="3" style="font-weight:bold">应用于电子商务微博私信降价提醒场景示例:</font>
第112行: 第72行:
  
  
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e9p4bhz01tj218a0kun30.jpg" style="width: 680px;">
+
<img src="http://www.sinaimg.cn/blog/developer/wiki/message5.png" style="width: 680px;">
 
<div style="text-align:right;">体验:关注[http://e.weibo.com/ruyitao @如意淘]</div>
 
<div style="text-align:right;">体验:关注[http://e.weibo.com/ruyitao @如意淘]</div>
  
  
  
==私信提醒 - 实现步骤==
+
===私信提醒 - 实现步骤===
  
  
第127行: 第87行:
 
*2、开启开发者模式
 
*2、开启开发者模式
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
**<font style="color:red">服务未正式开放,提前体验请邮件[mailto:open_api@sina.com open_api@sina.com]开启。</font>
+
服务未正式开放,提前体验请邮件[mailto:open_api@sina.com open_api@sina.com]开启。
  
  
第141行: 第101行:
 
**蓝V服务达到用户设定的提醒状态时,调用[[2/messages/send|messages/send]]接口给指定用户发送提醒。
 
**蓝V服务达到用户设定的提醒状态时,调用[[2/messages/send|messages/send]]接口给指定用户发送提醒。
  
 +
=好友邀请=
 +
*使用消息服务好友邀请功能,应用可以在自身的客户端上激励用户邀请自己微博好友加入应用,邀请将以Card形式私信好友。
  
{{#a:nobtns|nomodtime|noheading}}
+
 
 +
*好友邀请规则:
 +
**1,必须由用户主动发起;
 +
**2,每用户每小时通过每应用可邀请10个互粉好友。
 +
 
 +
==好友邀请 - 示例==
 +
 
 +
 
 +
'''应用于游戏邀请场景示例: '''
 +
<img src="http://www.sinaimg.cn/blog/developer/wiki/message6.png" style="width: 680px;">
 +
<div style="text-align:right;">体验地址:[http://weibo.com/p/100404770915 思密达的快乐家族]</div>
 +
 
 +
==好友邀请 - 实现步骤==
 +
 
 +
*1、使用微博登录
 +
**应用引导用户使用微博登录,采用[[授权机制说明|OAuth2]]的[[scope|Scope]]授权方式获得用户“发送私信邀请给你的微博好友”权限。
 +
 
 +
 
 +
*2、获取互粉好友
 +
**应用调用[[2/friendships/friends/bilateral|friendships/friends/bilateral]]接口,获取当前用户微博互粉好友列表,友好地引导、鼓励用户邀请好友加入应用或向好友送礼物等。
 +
 
 +
 
 +
*3、发送邀请
 +
**应用引导用户向好友发送使用邀请或送礼物,由用户主动发起向好友发送邀请,应用调用[[2/messages/invite|messages/invite]]接口实现向指定好友发送邀请。

2013年10月21日 (一) 13:03的版本

目录

消息服务是什么

  • 消息服务是微博为应用、蓝V提供的与微博用户、粉丝进行消息交互的服务。
  • 通过此服务,应用、蓝V可在自己的产品中实现私信人工客服私信自动回复游戏好友邀请降价私信提醒等功能。


涵盖的主要功能模块:

粉丝服务开发模式

自定义回复

  • 使用消息服务自定义回复功能,蓝V可以在自身的服务器或指定应用上接收微博用户与蓝V相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。


1、蓝V可接收的用户行为消息类型:


2、蓝V可回复的私信类型:

  • 回复规则:每条接收到的私信72小时内可回复3次,关注事件等非私信消息72小时内可回复1次。


自定义回复 - 示例

1、应用于自动回复场景示例:

体验:私信@查天气指定城市、关注@海淀桥路况、关注@我的印象笔记、私信@快速问医生、私信@违章管家



2、应用于人工客服场景示例:


自定义回复 - 实现步骤

  • 1、开启开发者模式
    • 蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。

内测期间,邮件open_api@sina.com申请开启,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。

  • 2、接收新消息
    • 蓝V通过应用调用messages/receive接口连接消息服务,接收微博用户与该蓝V相关的行为消息。行为消息包括指定蓝V用户被关注、被取消关注、私信、留言等新消息。


  • 3、回复新消息
    • 蓝V通过应用对接收到的新消息进行相应处理,调用messages/reply接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。

私信提醒

  • 使用消息服务私信提醒功能,蓝V可以在自身的服务器或指定应用上向已主动订阅了服务提醒的粉丝发送文字、图文等私信提醒。



  • 私信提醒规则:
    • 1,提醒内容需征得用户同意,如“关注本银行服务号,我们将每月提醒您消费总额”;
    • 2,需为账单、消费、降价、物流提醒等生活服务场景;
    • 3,不得用于推广、营销、广告等可能对用户造成骚扰的场景。

私信提醒 - 示例

应用于电子商务微博私信降价提醒场景示例:

  • 当订阅了降价提醒服务的用户的某款商品价格降到用户设定的提醒价格时,电商网站可以微博私信提醒用户购买。所提醒商品的价格是用户所期待的,因此更有利于购买行为的发生。依托微博私信提供的降价服务,将大大增强电商网站官微的服务能力,有利于培养长期忠实的微博粉丝。


体验:关注@如意淘


私信提醒 - 实现步骤

  • 1、申请接口使用权限
    • 服务未正式开放,此接口采用严格的申请接入流程。应用、网站或蓝V可邮件邮件open_api@sina.com申请,需要详细描述您希望实现的功能或服务及用于提醒的蓝V帐号,我们评估后确定是否为您开通。


  • 2、开启开发者模式
    • 蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。

服务未正式开放,提前体验请邮件open_api@sina.com开启。


  • 3、引导用户关注服务帐号
    • 应用通过微博等方式宣传,告知用户关注指定提供服务的蓝V帐号后可获得账单、消费、降价、物流提醒等私信提醒服务,获得用户关注。


  • 4、帐号绑定
    • 蓝V被用户关注(调用messages/receive获取)后,私信(调用messages/reply)引导用户登录应用进行帐号绑定。支持用户设定需要提醒的服务状态。


  • 5、发送私信提醒
    • 蓝V服务达到用户设定的提醒状态时,调用messages/send接口给指定用户发送提醒。

好友邀请

  • 使用消息服务好友邀请功能,应用可以在自身的客户端上激励用户邀请自己微博好友加入应用,邀请将以Card形式私信好友。


  • 好友邀请规则:
    • 1,必须由用户主动发起;
    • 2,每用户每小时通过每应用可邀请10个互粉好友。

好友邀请 - 示例

应用于游戏邀请场景示例:

好友邀请 - 实现步骤

  • 1、使用微博登录
    • 应用引导用户使用微博登录,采用OAuth2Scope授权方式获得用户“发送私信邀请给你的微博好友”权限。


  • 2、获取互粉好友
    • 应用调用friendships/friends/bilateral接口,获取当前用户微博互粉好友列表,友好地引导、鼓励用户邀请好友加入应用或向好友送礼物等。


  • 3、发送邀请
    • 应用引导用户向好友发送使用邀请或送礼物,由用户主动发起向好友发送邀请,应用调用messages/invite接口实现向指定好友发送邀请。