概述

功能简介

通过事件订阅，可以满足应用及时响应Bosshi事件变更的需求。如果要使用事件订阅功能，需要先配置请求地址，并添加订阅事件。当事件发生时，Bosshi开放平台会以 HTTP POST 请求的方式将事件内容以 JSON 格式推送给请求地址。

适用场景

下面列举两个简单的适用场景。开发者可以根据实际需求，订阅不同的事件。Bosshi开放平台目前支持的事件请参考事件列表。

• 实时数据处理

  如果应用对数据的实时性要求比较高，希望能够及时地从Bosshi同步数据的变化，可以进行事件订阅。例如在用户离职时，应用需要第一时间处理离职用户的业务数据，就可以订阅员工离职事件。

• 快速事件响应

  如果应用需要及时响应用户的操作，可以进行事件订阅。例如当用户发送消息给机器人时，机器人需要对消息做出对应的应答，就可以订阅接收消息事件。

订阅流程

事件订阅的基本流程如下图所示：

• （可选）配置 Encrypt Key。配置 Encrypt Key 后，Bosshi开放平台将向请求地址推送加密后的事件。加密推送，能够让用户数据更加安全。

• （可选）修改 Verification Token。创建应用后，开放平台会自动为应用生成一个 Verification Token，用户也可以修改该 Token。开放平台向应用推送的事件中都带有此 Token，应用可以据此 Token 验证推送的事件是否属于该应用。

• 配置请求地址。请求地址用于接收开放平台向应用推送的事件消息。当应用订阅的事件发生时，开放平台会向该请求地址发送相应的 HTTP POST 请求。

• 添加事件。添加应用需要关注的事件。

• 申请权限。要使订阅的事件生效，还需申请所需的权限。申请权限后，请创建应用版本并提交审核，审核通过后，才可生效。

• 接收并处理事件。当事件发生时，Bosshi开放平台会向应用推送事件，应用需要接收并处理事件。