使用EventBridge将事件推送至飞书

背景信息

飞书自定义机器人是一种只能在当前群聊中使用的机器人。该类机器人无需经过租户管理员审核，即可在当前群聊中通过调用webhook地址的方式完成消息推送。

事件总线支持HTTP目标，可以Webhook的形式向飞书的自定义机器人推送事件，实现异动告警，变更告警等能力。HTTP事件目标提供了支持HTTP与HTTPS，公网与阿里云VPC等不同请求方式、不同网络环境的Webhook URL，您可以将其集成到各类应用中。 更多信息，请参见 路由到HTTP端点地址。

适用场景

当飞书机器人和事件总线EventBridge联通后，适用于以下场景：

• 嵌入式的体验：可以在聊天中通过消息完成内容的触达、信息收集等操作。借助机器人能力，你可以将企业系统集成进飞书，在飞书内获得一站式的系统使用体验。

• 开发成本相对较低：只需要服务端开发，就能实现内容呈现友好、可进行互动的机器人。并且一次开发后，可以被企业内的其他成员轻松使用。

本文以事件推送为例，介绍如何使用EventBridge将事件推送至飞书。

步骤综述

1. 创建自定义事件总线：创建自定义事件总线，用于接收自定义应用或存量消息数据的事件。

2. 创建飞书机器人：此机器人用于接收并通知目标事件源产生的事件。

3. 配置事件规则： 为创建成功的自定义事件总线配置事件规则。

4. 结果验证：通过发布事件，在目标飞书群查看推送效果。

前提条件

• 注册一个飞书账号，并创建一个飞书群。

• 开通事件总线EventBridge并授权。

步骤一：创建自定义事件总线

1. 登录事件总线 EventBridge 控制台。

2. 在左侧导航栏单击事件总线，选择目标地域，然后在事件总线页面的自定义事件总线区域单击快速创建。

   

3. 在弹出创建自定义事件总线面板，配置以下信息。

   1. 在总线配置向导，设置自定义事件总线名称和描述，然后单击下一步。

      

   2. 在事件源配置向导，自定义事件源名称，然后选择事件提供方为自定义应用，最后单击下一步。

      

   3. 在规则配置向导，单击跳过，然后在弹出的直接创建自定义事件总线对话框单击确定。

      说明

      暂时不在新创建的自定义事件总线上创建事件规则和事件目标。

4. 查看新创建的自定义事件总线。

   

步骤二：创建飞书机器人

1. 登录PC版飞书，选择需要加入机器人的群聊。

2. 在目标群聊页面，单击右上角的图标，然后单击设置。

3. 在设置页面，单击群机器人。

4. 在添加机器人页面，单击自定义机器人。

5. 在创建机器人页面，自定义机器人名称和描述单击添加。

6. 在WebHook 地址页面，复制WebHook 地址，然后按需勾选安全设置，最后单击完成。

步骤三：配置EventBridge事件规则

1. 返回新建自定义事件总线的概览页面，单击添加事件规则。

   

2. 在弹出的创建规则面板，配置一下信息。

   1. 在配置基本信息向导，自定义规则名称，然后单击下一步。

      

   2. 在配置事件模式向导，单击下一步。

      重要

      本示例中不配置事件模式。在生产环境中，按照需求在配置事件模式向导配置事件源和事件类型。

   3. 在配置事件目标向导，服务类型选择为HTTPS，URL配置为步骤二复制的WebHook地址，然后选择Body为模版，并设置变量和模板，最后单击创建。

      说明

      模版的具体配置。请参见事件内容转换。

      

      变量：

      {
          "msg_source":"$.source",
          "msg_type":"$.type"
      }

      模板：

      {
          "msg_type": "text",
          "content": {
              "text": "事件源信息是：${msg_source}, 事件类型是：${msg_type}"
          }
      }

      说明

      本示例中的模版配置比较简单，在生产环境中，参见飞书官方文档并按实际需求配置模版信息。

步骤四：结果验证

1. 在创建的自定义事件总线的概览页面，点击发布事件。

   

2. 在弹出的发布事件至自定义事件总线面板，选择自定义事件源并配置事件体，然后单击确认。

   

3. 在飞书群查看事件推送效果。