Messages

跳转到: 导航, 搜索
第1行: 第1行:
  
 
=消息服务是什么=
 
=消息服务是什么=
*消息服务是为蓝V、应用提供的与微博用户进行消息互动的服务。
+
*消息服务是为机构认证账号(蓝V)、应用提供的与微博用户进行消息互动的服务。
*通过此服务,蓝V可以在自己的服务器上实现粉丝服务平台“私信自动回复”、“私信人工客服”、“私信提醒”等功能;开发者可以在自己的应用中实现微博“私信邀请好友”、“送礼物”,“排行榜”等功能。
+
*通过此服务,机构认证账号(蓝V)可以在自己的服务器上实现粉丝服务平台“私信自动回复”、“私信人工客服”、“私信提醒”等功能;开发者可以在自己的应用中实现微博“私信邀请好友”、“送礼物”,“排行榜”等功能。
  
  
第12行: 第12行:
  
 
=粉丝服务平台开发模式=
 
=粉丝服务平台开发模式=
*粉丝服务平台开发模式为开发者提供了用于实现蓝V“私信自定义回复”、“私信提醒”、“私信群发(规划)”等功能的接口。
+
*粉丝服务平台开发模式为开发者提供了用于实现机构认证账号(蓝V)“私信自定义回复”、“私信提醒”、“私信群发(规划)”等功能的接口。
 +
*开发模式开启:提供服务的机构认证账号(蓝V)私信[http://weibo.com/u/1870632073 @微博API]以下内容“本帐号确认开启粉丝服务平台开发模式,并指定应用名称为****(appkey:****)的应用为本帐号开发”。
  
 
==自定义回复==
 
==自定义回复==
*使用自定义回复功能,蓝V可以在自身的服务器或指定应用上接收微博用户与蓝V相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
+
*使用自定义回复功能,机构认证账号(蓝V)可以在自身的服务器或指定应用上接收微博用户与机构认证账号(蓝V)相关的行为消息,并可在72小时内按需进行文字、图文等私信的回复。
  
  
'''1、蓝V可接收的用户行为消息类型:'''
+
'''1、机构认证账号(蓝V)可接收的用户行为消息类型:'''
 
<img src="http://www.sinaimg.cn/blog/developer/wiki/message1.png" style="width: 680px;">
 
<img src="http://www.sinaimg.cn/blog/developer/wiki/message1.png" style="width: 680px;">
  
  
'''2、蓝V可回复的私信类型:'''
+
'''2、机构认证账号(蓝V)可回复的私信类型:'''
 
<img src="http://www.sinaimg.cn/blog/developer/wiki/message2.png" style="width: 680px;">
 
<img src="http://www.sinaimg.cn/blog/developer/wiki/message2.png" style="width: 680px;">
  
第44行: 第45行:
 
===自定义回复 - 实现步骤===
 
===自定义回复 - 实现步骤===
  
*1、开启粉丝服务平台开发模式
+
*1、接收新消息
**提供服务的蓝V私信[http://weibo.com/u/1870632073 @微博API]以下内容“本帐号确认开启粉丝服务平台开发模式,并指定应用名称为****(appkey:****)的应用为本帐号开发”;
+
**机构认证账号(蓝V)通过应用调用[[2/messages/receive|messages/receive]]接口连接消息服务,接收微博用户与该机构认证账号(蓝V)相关的行为消息。行为消息包括指定机构认证账号(蓝V)用户被关注、被取消关注、私信、留言等新消息。
  
  
*2、接收新消息
+
*2、回复新消息
**蓝V通过应用调用[[2/messages/receive|messages/receive]]接口连接消息服务,接收微博用户与该蓝V相关的行为消息。行为消息包括指定蓝V用户被关注、被取消关注、私信、留言等新消息;
+
**机构认证账号(蓝V)通过应用对接收到的新消息进行相应处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由机构认证账号(蓝V)客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。
 
+
 
+
*3、回复新消息
+
**蓝V通过应用对接收到的新消息进行相应处理,调用[[2/messages/reply|messages/reply]]接口进行回复,实现关键词自动回复或交由蓝V客服进行72小时人工应答功能,所有回复以微博私信方式到达用户。
+
  
 
==私信提醒==
 
==私信提醒==
*使用消息服务私信提醒功能,蓝V可以在自身的服务器或指定应用上向已主动订阅了服务提醒的粉丝发送文字、图文等私信提醒。
+
*使用消息服务私信提醒功能,机构认证账号(蓝V)可以在自身的服务器或指定应用上向已主动订阅了服务提醒的粉丝发送文字、图文等私信提醒。
  
  
第83行: 第80行:
  
 
*1、申请私信提醒接口使用权限
 
*1、申请私信提醒接口使用权限
**服务未正式开放,此接口采用严格的申请接入流程。银行、运营商、水电煤、地震公安政府等提供公共服务类的蓝V可私信[http://weibo.com/u/1870632073 @微博API]申请,需要详细描述您希望实现的功能或服务,我们评估后确定是否为您开通。
+
**服务未正式开放,此接口采用严格的申请接入流程。银行、运营商、水电煤、地震公安政府等提供公共服务类的机构认证账号(蓝V)可私信[http://weibo.com/u/1870632073 @微博API]申请,需要详细描述您希望实现的功能或服务,我们评估后确定是否为您开通。
  
  
 
*2、引导用户关注服务帐号
 
*2、引导用户关注服务帐号
**应用通过微博等方式宣传,告知用户关注指定提供服务的蓝V帐号后可获得账单、消费、降价、物流提醒等私信提醒服务,获得用户关注。
+
**应用通过微博等方式宣传,告知用户关注指定提供服务的机构认证账号(蓝V)帐号后可获得账单、消费、降价、物流提醒等私信提醒服务,获得用户关注。
  
  
 
*3、帐号绑定
 
*3、帐号绑定
**蓝V被用户关注(调用[[2/messages/receive|messages/receive]]获取)后,私信(调用[[2/messages/reply|messages/reply]])引导用户登录应用进行帐号绑定。支持用户设定需要提醒的服务状态。
+
**机构认证账号(蓝V)被用户关注(调用[[2/messages/receive|messages/receive]]获取)后,私信(调用[[2/messages/reply|messages/reply]])引导用户登录应用进行帐号绑定。支持用户设定需要提醒的服务状态。
  
  
 
*4、发送私信提醒
 
*4、发送私信提醒
**蓝V服务达到用户设定的提醒状态时,调用[[2/messages/send|messages/send]]接口给指定用户发送提醒。
+
**机构认证账号(蓝V)服务达到用户设定的提醒状态时,调用[[2/messages/send|messages/send]]接口给指定用户发送提醒。
  
 
=好友邀请=
 
=好友邀请=

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

目录

消息服务是什么

  • 消息服务是为机构认证账号(蓝V)、应用提供的与微博用户进行消息互动的服务。
  • 通过此服务,机构认证账号(蓝V)可以在自己的服务器上实现粉丝服务平台“私信自动回复”、“私信人工客服”、“私信提醒”等功能;开发者可以在自己的应用中实现微博“私信邀请好友”、“送礼物”,“排行榜”等功能。


涵盖的主要功能模块:

粉丝服务平台开发模式

  • 粉丝服务平台开发模式为开发者提供了用于实现机构认证账号(蓝V)“私信自定义回复”、“私信提醒”、“私信群发(规划)”等功能的接口。
  • 开发模式开启:提供服务的机构认证账号(蓝V)私信@微博API以下内容“本帐号确认开启粉丝服务平台开发模式,并指定应用名称为****(appkey:****)的应用为本帐号开发”。

自定义回复

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


1、机构认证账号(蓝V)可接收的用户行为消息类型:


2、机构认证账号(蓝V)可回复的私信类型:

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


自定义回复 - 示例

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

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



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


自定义回复 - 实现步骤

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


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

私信提醒

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



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


私信提醒 - 示例

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

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

体验:关注@如意淘


私信提醒 - 实现步骤

  • 1、申请私信提醒接口使用权限
    • 服务未正式开放,此接口采用严格的申请接入流程。银行、运营商、水电煤、地震公安政府等提供公共服务类的机构认证账号(蓝V)可私信@微博API申请,需要详细描述您希望实现的功能或服务,我们评估后确定是否为您开通。


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


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


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

好友邀请

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


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

好友邀请 - 示例

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

好友邀请 - 实现步骤

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


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


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