# 长期订阅状态通知

> 本文档描述服务器端接收的消息或事件，详细说明参见[消息推送](/miniprogram/dev/framework/server-ability/message-push.md)。

事件英文名：wxalive_follow_notify

用户订阅小程序直播后会触发事件通知

## 1. 消息参数

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "ToUserName",
    "类型": "string",
    "说明": "小程序的原始ID",
    "枚举": "-"
  },
  {
    "参数名": "FromUserName",
    "类型": "string",
    "说明": "发送者的openid",
    "枚举": "-"
  },
  {
    "参数名": "CreateTime",
    "类型": "number",
    "说明": "消息创建时间（整型）",
    "枚举": "-"
  },
  {
    "参数名": "MsgType",
    "类型": "string",
    "说明": "固定 event",
    "枚举": "-"
  },
  {
    "参数名": "Event",
    "类型": "string",
    "说明": "固定 wxalive_follow_notify",
    "枚举": "-"
  },
  {
    "参数名": "room_id",
    "类型": "number",
    "说明": "房间号",
    "枚举": "-"
  },
  {
    "参数名": "user_openid",
    "类型": "string",
    "说明": "订阅者的openid",
    "枚举": "-"
  },
  {
    "参数名": "time",
    "类型": "number",
    "说明": "订阅的时间戳",
    "枚举": "-"
  },
  {
    "参数名": "live_status",
    "类型": "number",
    "说明": "阅或者取消订阅时直播间状态，取值：",
    "枚举": "枚举值"
  },
  {
    "参数名": "action",
    "类型": "string",
    "说明": "订阅行为",
    "枚举": "枚举值"
  }
]
```

## 2. 消息返回

### 返回体 `Response Payload`

回复 `success` 或空字符串（无需加密）

## 3. 枚举信息

### Body.live_status `Enum`

阅或者取消订阅时直播间状态，取值：

```json
[
  {
    "枚举值": "101",
    "描述": "直播中"
  },
  {
    "枚举值": "102",
    "描述": "未开始"
  },
  {
    "枚举值": "103",
    "描述": "已结束"
  }
]
```

### Body.action `Enum`

订阅行为

```json
[
  {
    "枚举值": "add_follow",
    "描述": "订阅"
  },
  {
    "枚举值": "del_follow",
    "描述": "取消订阅"
  }
]
```

## 4. 注意事项

本事件无特殊注意事项

## 5. 代码示例

请求示例

```xml
<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1546924844</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[wxalive_follow_notify]]></Event>
  <FollowNotify>
    <room_id>1</room_id>
    <user_openid>![CDATA[xxx]]</user_openid>
    <time>1546924844</time>
    <live_status>101</live_status>
    <action>![CDATA[add_follow]]</action>
  </FollowNotify>
 </xml>
```

返回示例

```json
SUCCESS
```