在事件总线(EventBridge)上创建完自定义事件总线后,您可以通过配置自定义事件规则将特定事件源产生的事件推送到企业微信聊天群。本文主要介绍如何通过模拟发布事件的方式实现这一推送过程。
背景信息
自定义机器人是一种专用于当前群聊的工具,它能够通过接口向群内发送告警或提醒类的消息通知。这类机器人不需要经过租户管理员的审核,就可以直接在当前群聊中通过调用Webhook地址来实现消息推送。
事件总线(EventBridge)支持HTTP目标,可以通过Webhook的形式向企业微信的自定义机器人推送事件,从而实现异动告警、变更告警等功能。HTTP事件目标支持HTTP和HTTPS协议,并且可以在公网和阿里云VPC等不同的网络环境中使用。您可以将这些Webhook URL集成到各种应用中,以满足不同场景的需求。
更多信息,请参见 路由到HTTP端点地址。
使用场景
当企业微信机器人和事件总线(EventBridge)联通后,适用于以下场景:
嵌入式的体验:可以在聊天中通过消息完成内容的触达、信息收集等操作。借助机器人能力,您可以将企业系统集成进企业微信,在企业微信内获得一站式的系统使用体验。
开发成本相对较低:只需要服务端开发,就能实现内容呈现友好、可进行互动的机器人。并且一次开发后,可以被企业内的其他成员轻松使用。
本文以事件推送为例,介绍如何使用事件总线(EventBridge)将事件推送至企业微信。
步骤综述
创建自定义事件总线:创建自定义事件总线,用于接收自定义应用或存量消息数据的事件。
创建企业微信机器人:此机器人用于接收并通知来自于自定义事件总线的事件。
配置事件规则: 为创建成功的自定义事件总线配置事件规则。
结果验证:模拟验证机器人是否能接收事件信息。
前提条件
注册一个企业微信账号,并创建一个企业微信群。
步骤一:创建自定义事件总线
在左侧导航栏单击事件总线,选择目标地域,然后在事件总线页面的自定义事件总线区域单击快速创建。
在弹出创建自定义事件总线面板,配置以下信息。
在总线配置向导,设置自定义事件总线名称和描述,然后单击下一步。
在事件源配置向导,自定义事件源名称,然后选择事件提供方为自定义应用,最后单击下一步。
在规则配置向导,单击跳过,然后在弹出的直接创建自定义事件总线对话框单击确定。
说明暂时不在新创建的自定义事件总线上创建事件规则和事件目标。
查看新创建的自定义事件总线。
步骤二:创建企业微信机器人
登录PC版企业微信,选择需要添加机器人的群聊。
在添加机器人页面单击新创建一个机器人。
在创建机器人页面,自定义机器人名称,然后复制WebHook地址。
步骤三:配置EventBridge事件规则
返回新建自定义事件总线的概览页面,单击添加事件规则。
在弹出的创建规则面板,配置一下信息。
在配置基本信息向导,自定义规则名称,然后单击下一步。
在配置事件模式向导,单击下一步。
重要本示例中不配置事件模式。在生产环境中,按照需求在配置事件模式向导配置事件源和事件类型。
在配置事件目标向导,服务类型选择为HTTPS,URL配置为步骤二复制的WebHook地址,然后选择Body为模版,并设置变量和模板,最后单击创建。
说明模版的具体配置。请参见事件内容转换。
变量:
{ "msg_source":"$.source", "msg_type":"$.type" }
模板:
{ "msgtype": "text", "text": { "content": "事件源信息是:${msg_source}, 事件类型是:${msg_type}" } }
说明本示例中的模版配置比较简单,在生产环境中,参见企业微信官方文档并按实际需求配置模版信息。
步骤四:结果验证
在创建的自定义事件总线的概览页面,点击发布事件。
在弹出的发布事件至自定义事件总线面板,选择自定义事件源并配置事件体,然后单击确认。
在企业微信群查看事件推送效果。