事件订阅概述

应用可通过订阅WPS协作开放平台提供的订阅事件，实时获取并响应WPS协作里的动作，充分利用WPS协作的协作能力，提升应用的业务协作能力。

例如，你的应用需要及时接收并处理用户发送给应用机器人的消息，那么就可以订阅 接收消息 事件。WPS协作会在应用机器人接收到用户发送的消息后触发此事件。触发事件消息推送至应用指定的消息接收地址，应用接收并解析消息后即可获取对应的消息内容，处理后续业务逻辑。

事件订阅流程

事件订阅整体可分为 4 个步骤：

1. 配置用于接收WPS协作事件消息推送的地址（URL）。
2. 选择需要订阅的事件。
3. 申请并开通事件所需权限。
4. 事件触发并推送至应用的事件订阅地址，应用解密消息体并响应成功。

详细流程解析如下：

1. 开发者在 开发者后台-事件订阅设置事件回调的请求网址。
2. 在开发者后台应用中，事件订阅菜单中订阅感兴趣的事件。

（图1：开发者后台-事件订阅）

（图2：事件订阅界面）

3. 部分事件受权限控制，请根据“所需权限”，到开发者后台-权限申请模块进行相应权限的申请，并申请审核，等待企业超管审批通过（第三方企业应用则需创建版本申请上架）。例如接收消息事件，若要接收单聊消息，则需申请“获取用户发给机器人的单聊消息”权限。

（图3：权限申请界面）

4. 事件触发时，WPS协作开放平台发送事件内容给应用服务器，其中事件消息体为加密后的消息体。
5. 应用服务器收到事件内容后，需根据WPS协作开放平台提供的解密算法进行解密得到消息内容，并在规定的时间内作出响应，返回给WPS协作。