Messages

跳转到: 导航, 搜索
第11行: 第11行:
 
***[[#好友邀请 - 示例|3.1 好友邀请 - 示例]]
 
***[[#好友邀请 - 示例|3.1 好友邀请 - 示例]]
 
***[[#好友邀请 - 实现步骤|3.2 好友邀请 - 实现步骤]]
 
***[[#好友邀请 - 实现步骤|3.2 好友邀请 - 实现步骤]]
 +
**[[#私信提醒|4 私信邀请]]
 +
***[[#私信提醒 - 示例|4.1 私信提醒 - 示例]]
 +
***[[#私信提醒 - 实现步骤|4.2 私信提醒 - 实现步骤]]
  
  
第16行: 第19行:
  
 
=消息服务是什么=
 
=消息服务是什么=
*消费服务是微博为应用、蓝V提供的与微博用户、粉丝进行消息交互的服务。
+
*消息服务是微博为应用、蓝V提供的与微博用户、粉丝进行消息交互的服务。
*通过此服务,应用、蓝V可在自己的产品中实现'''私信人工客服'''、'''私信自动回复'''、'''好友邀请'''等功能。
+
*通过此服务,应用、蓝V可在自己的产品中实现'''私信人工客服'''、'''私信自动回复'''、'''游戏好友邀请'''、'''降价私信提醒'''等功能。
  
  
 
<h3>涵盖的主要功能模块:</h3>
 
<h3>涵盖的主要功能模块:</h3>
 
<div style="text-align:center;">
 
<div style="text-align:center;">
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e81panhb9yj20g605iglw.jpg" alt="946308c5jw1e823zq5uf5j218a0hwtfe.jpg" style="width: 260px;">
+
<img src="http://ww3.sinaimg.cn/large/946308c5jw1e88njxkk7vj20oa05kgm7.jpg" style="height: 90px;">
 
</div>
 
</div>
  
  
 
=自定义回复=
 
=自定义回复=
*使用消息服务自定义回复功能,蓝V 可以在自身的服务器或指定应用上接收微博用户与自己相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
+
*使用消息服务自定义回复功能,蓝V可以在自身的服务器或指定应用上接收微博用户与自己相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
  
  
 
<h3>1、蓝V可接收的用户行为消息类型:</h3>
 
<h3>1、蓝V可接收的用户行为消息类型:</h3>
<img src="http://ww3.sinaimg.cn/large/946308c5jw1e823zq5uf5j218a0hwtfe.jpg" style="width: 680px;">
+
<img src="http://ww3.sinaimg.cn/large/946308c5jw1e88na71t70j218i0hs7az.jpg" style="width: 680px;">
  
  
 
<h3>2、蓝V可回复的私信类型:</h3>
 
<h3>2、蓝V可回复的私信类型:</h3>
<img src="http://ww4.sinaimg.cn/large/946308c5jw1e82965yjsgj218g0hstej.jpg" style="width: 680px;">
+
<img src="http://ww2.sinaimg.cn/large/946308c5jw1e88npe701ej218c0hs0yg.jpg" style="width: 680px;">
  
*回复规则:每条接收到的私信72小时内可回复3次,关注事件等非私信消息72小时内可回复1次。
+
*回复规则:每条接收到的私信72小时内可回复3次,关注事件等非私信消息72小时内可回复1次。
  
  
第45行: 第48行:
 
<h3>1、应用于自动回复场景示例:</h3>
 
<h3>1、应用于自动回复场景示例:</h3>
 
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e82bqnof51j218g0p0aht.jpg" style="width: 680px;">
 
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e82bqnof51j218g0p0aht.jpg" style="width: 680px;">
 +
<div style="text-align:right;">体验:关注[http://e.weibo.com/u/3254646623 @海淀桥路况]、关注[http://e.weibo.com/myyxbj @我的印象笔记]</div>
  
  
第56行: 第60行:
 
==自定义回复 - 实现步骤==
 
==自定义回复 - 实现步骤==
  
*1、蓝V用户开启自定义回复开发者模式
+
*1、开启开发者模式
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
 
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
 
**<font style="color:red">服务未正式开放,提前体验请邮件[mailto:shenbin1@staff.sina.com.cn shenbin1@staff.sina.com.cn]申请,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。</font>
 
**<font style="color:red">服务未正式开放,提前体验请邮件[mailto:shenbin1@staff.sina.com.cn shenbin1@staff.sina.com.cn]申请,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。</font>
  
  
*2、蓝V通过应用连接消息服务接收微博用户与该蓝V相关的行为消息
+
*2、接收新消息
**应用调用[[2/messages/receive|messages/receive]]接口与消息服务建立长连接,接收指定蓝V用户被关注、被取消关注、私信、留言等新消息。
+
**蓝V通过应用调用[[2/messages/receive|messages/receive]]接口连接消息服务,接收微博用户与该蓝V相关的行为消息。行为消息包括指定蓝V用户被关注、被取消关注、私信、留言等新消息。
  
  
*3、蓝V通过应用回复接收到的新消息
+
*3、回复新消息
**应用对新消息进行相应的处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答,所有回复以微博私信方式到达用户。
+
**蓝V通过应用对接收到的新消息进行相应处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。
  
  
第83行: 第87行:
 
<h3>应用于游戏邀请场景示例:</h3>
 
<h3>应用于游戏邀请场景示例:</h3>
 
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e82dbhnagqj218a0hajyk.jpg" style="width: 680px;">
 
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e82dbhnagqj218a0hajyk.jpg" style="width: 680px;">
 
+
<div style="text-align:right;">体验地址:[http://weibo.com/p/100404770915 思密达的快乐家族]</div>
  
  
 
==好友邀请 - 实现步骤==
 
==好友邀请 - 实现步骤==
  
*1、应用引导用户使用微博登录
+
*1、使用微博登录
 
**应用引导用户使用微博登录,采用[[授权机制说明|OAuth2]]的[[scope|Scope]]授权方式获得用户“发送私信邀请给你的微博好友”权限。
 
**应用引导用户使用微博登录,采用[[授权机制说明|OAuth2]]的[[scope|Scope]]授权方式获得用户“发送私信邀请给你的微博好友”权限。
  
  
*2、应用获取用户微博互粉好友列表
+
*2、获取互粉好友
 
**应用调用[[2/friendships/friends/bilateral|friendships/friends/bilateral]]接口,获取当前用户微博互粉好友列表,友好地引导、鼓励用户邀请好友加入应用或向好友送礼物等。
 
**应用调用[[2/friendships/friends/bilateral|friendships/friends/bilateral]]接口,获取当前用户微博互粉好友列表,友好地引导、鼓励用户邀请好友加入应用或向好友送礼物等。
  
  
*3、应用获得用户确认后向指定用户发送邀请
+
*3、发送邀请
**应用引导用户后由用户主动向好友发送邀请,应用调用[[2/messages/invite|messages/invite]]接口实现向指定好友发送邀请。
+
**应用引导用户向好友发送使用邀请或送礼物,由用户主动发起向好友发送邀请,应用调用[[2/messages/invite|messages/invite]]接口实现向指定好友发送邀请。
 +
 
 +
 
 +
 
 +
=私信提醒=
 +
*使用消息服务私信提醒功能,蓝V可以在自身的服务器或指定应用上主动地向进行了服务提醒订阅的粉丝发送文字、图文等私信提醒。
 +
 
 +
 
 +
<img src="http://ww2.sinaimg.cn/large/946308c5jw1e88cce1x1nj20zy0haaew.jpg" style="height: 265px;">
 +
 
 +
 
 +
*私信提醒规则:
 +
**1,提醒内容需征得用户同意,如“关注本银行服务号,我们将每月提醒您消费总额”;
 +
**2,需为账单、消费、降价、物流提醒等生活服务场景;
 +
**3,不得用于推广、运营、广告等可能对用户造成骚扰的场景。
 +
 
 +
==私信提醒 - 示例==
 +
 
 +
<h3>应用于电子商务微博私信降价提醒场景示例:</h3>
 +
*当订阅了降价提醒服务的用户的某款商品价格降到用户设定的提醒价格时,电商网站可以微博私信提醒用户购买。所提醒商品的价格是用户所期待的,因此更有利于购买行为的发生。依托微博私信提供的降价服务,将大大增强电商网站官微的服务能力,有利于培养长期忠实的微博粉丝。
 +
 
 +
 
 +
<img src="http://ww1.sinaimg.cn/large/946308c5jw1e88d4upgsej218a0l20z9.jpg" style="width: 680px;">
 +
<div style="text-align:right;">体验:关注[http://e.weibo.com/ruyitao @如意淘]</div>
 +
 
 +
 
 +
 
 +
==私信提醒 - 实现步骤==
 +
 
 +
 
 +
*1、开启开发者模式
 +
**蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
 +
**<font style="color:red">服务未正式开放,提前体验请邮件[mailto:shenbin1@staff.sina.com.cn shenbin1@staff.sina.com.cn]申请,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。</font>
 +
 
 +
 
 +
*2、引导用户关注服务帐号
 +
**应用通过微博等方式宣传,告知用户关注指定提供服务的蓝V帐号后可获得账单、消费、降价、物流提醒等私信提醒服务,获得用户关注。
 +
 
  
 +
*3、帐号绑定
 +
**蓝V被用户关注(调用[[2/messages/receive|messages/receive]]获取)后,私信(调用[[2/messages/reply|messages/reply]])引导用户登录应用进行帐号绑定。支持用户设定需要提醒的服务状态。
  
  
 +
*4、发送私信提醒
 +
**蓝V服务达到用户设定的提醒状态时,调用[[2/messages/send|messages/send]]接口给指定用户发送提醒。
  
 
__NOTOC__
 
__NOTOC__

2013年9月3日 (二) 08:46的版本

消息服务


目录



消息服务是什么

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


涵盖的主要功能模块:


自定义回复

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


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


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

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


自定义回复 - 示例

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

体验:关注@海淀桥路况、关注@我的印象笔记



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


自定义回复 - 实现步骤

  • 1、开启开发者模式
    • 蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
    • 服务未正式开放,提前体验请邮件shenbin1@staff.sina.com.cn申请,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。


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


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


好友邀请

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


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

好友邀请 - 示例

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


好友邀请 - 实现步骤

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


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


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


私信提醒

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



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

私信提醒 - 示例

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

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


体验:关注@如意淘


私信提醒 - 实现步骤

  • 1、开启开发者模式
    • 蓝V用户在企业微博后台开启开发者模式,设置成将自己的私信、留言等新消息托管给指定应用处理。
    • 服务未正式开放,提前体验请邮件shenbin1@staff.sina.com.cn申请,需提供您希望实现的功能或服务场景,我们评估后确定是否提前为您开通。


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


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


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