2015年8月24日 (一) 10:38的最后版本

目录

• • 1 消息服务是什么
  • 2 自定义回复
    • 2.1 自定义回复 - 示例
    • 2.2 自定义回复实现步骤
  • 3 好友邀请
    • 3.1 好友邀请 - 示例

消息服务是什么

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

涵盖的主要功能模块：

自定义回复

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

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

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

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

自定义回复 - 示例

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

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

自定义回复实现步骤

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

• 2、应用连接、推送开始
  • 应用调用messages/receive接口进行长连接，接收指定蓝V用户的新消息，若蓝V已授权指定应用托管微博私信、留言等消息箱服务，则连接成功，当有微博用户给蓝V发送新消息时，推送服务将此新消息格式化后由此长连接推送给该应用。

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

好友邀请

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

好友邀请 - 示例

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

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

消息推送接口

功能： 消息推送接口，长连接微博推送服务，接收推送给指定蓝V用户的新消息

接口调用地址：https://m.api.weibo.com/2/messages/receive.json

HTTP请求方式：GET

是否需要登陆：是

curl -u "USERNAME:PASSWORD" "https://m.api.weibo.com/2/messages/receive.json?source=YOUR_APPKEY&uid=***"

{
    "id": 1211260020031346,
    "type": "event",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "事件消息",
    "data": {
        "subtype": "EVENT",
        "key": "EVENT_KEY"
    }
}

{
    "id": 1211260020031346,
    "type": "text",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "私信或留言内容",
    "data": {}
}

{
    "request": "/2/messages/receive.json",
    "error_code": "264XX",
    "error": "error message."
}

{
    "text": "纯文本回复"
}

curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&id=1307180000*****&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/reply.json" -k

{
    "articles": [
        {
            "display_name": "两个故事",
            "summary": "今天讲两个故事，分享给你。谁是公司？谁又是中国人？​",
            "image": "http://storage.mcp.weibo.cn/0JlIv.jpg",
            "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319"
        }
    ]
}

{
    "request": "/2/messages/reply.json",
    "error_code": "264XX",
    "error": "error message."
}