活动订阅
除了让您在后端执行读写操作外,Integration Connectors 还可以 让您可以订阅在后端应用中发生的事件。例如,假设你 希望在有新的 Jira 票券创建时收到通知。为此,您可以将 适用于事件订阅的 Jira Cloud 连接器。通过使用事件订阅以及 利用 Application Integration,您可以 创建有用的集成来满足您的业务需求。如需了解详情,请参阅 在集成中使用事件订阅
。在连接中启用事件订阅
您创建的连接可用于以下任何用途:
- 仅用于执行连接器操作(实体和操作)
- 仅适用于事件订阅
- 用于执行连接器操作和事件订阅
提供启用活动订阅和配置活动相关详细信息的选项 连接创建期间提供给您。但是,如果 您已经有一个现有连接,并想将其改用于事件订阅,可以执行以下操作: 因此,您需要修改和重新配置该连接。
以下连接器支持事件订阅:
在活动通知中丰富数据
您可以配置连接 在事件通知响应中附加其他信息。通过本单元 特定于您配置事件的实体。要获取其他信息 您必须在连接中启用数据丰富化。
例如,如果您在 Zendesk 中订阅了门票创建活动,
通知。不过,事件通知有效载荷
只有基本的票券详细信息其他详细信息,例如门票说明
分配对象和状态。要获取这些额外的详细信息,
ticket
实体,您必须在 Zendesk 连接中启用数据丰富功能。对于
请参阅
配置事件订阅。通过
以下示例展示了使用数据丰富功能和使用数据丰富功能的响应载荷。
未实现数据丰富化的载荷
以下示例显示了没有数据丰富功能的 Zendesk 的 create Ticket 活动响应载荷。
{ "account_id": 12345, "integration_key": "my_integration_key", "subdomain": "my_zendesk_subdomain", "input": { "ticket_event": { "meta": { "version": "1.0", .... .... "position": 1, "total": 9 } }, "type": "Ticket Created", "ticket": { "id": 35436, .... .... "external_id": "TEST1234", "tags": [ "enterprise" ], "via": { "channel": "web" } } } }
具有数据丰富功能的载荷
以下示例展示了 Zendesk 的 create Ticket 活动具有数据丰富功能的响应载荷。
{ "context-data": { "AllowChannelback": false, "Assignee": null, "AssigneeId": 1.6696812051473E13, "Brand": null, "BrandId": 1.6696812163985E13, "Cc": null, "CollaboratorIds": null, "Commenter": null, "HasAttachment": null, "CreatedAt": "2023-07-08 11:37:19.0", "CustomFields": null, "Description": "Test desc 2", .... .... "Status": "open", "Subject": "Test Zendesk Ticket Created -2 -DA", "Submitter": null, "SubmitterId": 1.6696812051473E13, "Tags": "tag-changed-after-cache,ticket-created", .... .... "ViaChannel": "web", "ViaFollowupSourceId": null, "ViaSource": "{\r\n \"from\": null,\r\n \"to\": null,\r\n \"rel\": null\r\n}", "View_Id": null }, "data":{ "account_id": 12345, "integration_key": "my_integration_key", "subdomain": "my_zendesk_subdomain", "input": { "ticket_event": { "meta": { "version": "1.0", .... .... "position": 1, "total": 9 } }, "type": "Ticket Created", "ticket": { "id": 35436, .... .... "external_id": "TEST1234", "tags": [ "enterprise" ], "via": { "channel": "web" } } } } }
用于事件订阅的专用连接
为提高安全性,您可以在后端应用和连接之间配置专用连接。 在专用连接中,连接的事件监听器不会直接设为公开。您必须改为 允许入站网络流量通过提供给您的 PSC 服务连接传入事件监听器 Integration Connectors。
在创建连接期间,如果您为事件订阅选择了启用专用连接,则 Integration Connectors 会创建 PSC 服务连接。您必须公开 通过使用任何适合您的方法将 PSC 服务连接到后端应用。一种可能 方法是在负载均衡器中使用 PSC 服务连接,然后配置 来接受来自后端应用的事件。然后,该连接会在负载均衡器的地址上监听后端的事件。 以下简要步骤展示了如何使用负载均衡器来配置专用连接:
- 转到新创建的连接的连接详情页面。
- 点击修改入站流量端点。系统随即会显示“事件订阅设置”窗格。
- 复制 PSC 服务连接名称字段中显示的服务连接名称。
- 创建一个 PSC 网络端点组 指向 您在上一步中获得的服务连接。
- 创建使用 PSC 网络的外部负载均衡器 作为后端创建的端点组。
- 将负载均衡器配置为接受来自事件提供方(后端应用)IP 地址的请求。
后续 setps(7 到 11)仅适用于后端支持 自动注册事件订阅。例如 Zendesk 和 Jira。
- 转到新创建的连接的连接详情页面。
- 点击修改入站流量端点。系统随即会显示“事件订阅设置”窗格。
- 在事件监听器入站流量端点字段中输入负载均衡器的地址。
- 点击完成。
- 点击保存以保存对连接所做的更改。
在集成中使用事件订阅
将事件订阅与集成结合使用后,您可以创建 以解决复杂的业务问题。例如,您可以从 基于 ServiceNow 事件执行整个集成。 Application Integration 提供以下触发器, 监听来自后端应用的事件通知:
- HubSpot 触发器 - 监听 HubSpot 事件。
- IBM MQ 触发器 - 监听 IBM MQ 事件。
- Jira Cloud 触发器 - 监听 Jira Cloud 事件。
- Rabbit MQ 触发器 - 监听 Rabbit MQ 事件。
- ServiceNow 触发器 - 监听 ServiceNow 事件。
- TIBCOEMS 触发器 - 监听 TIBCOEMS 事件。
- 网络钩子触发器 - 监听常规网络钩子事件。
- Zendesk 触发器 - 监听 Zendesk 事件。
如需配置触发器,您必须启用事件订阅 您可以在以下位置启用事件订阅: 现有连接或新连接。如需详细了解 配置这些 Application Integration 触发器,请参阅 触发器文档。
查看已启用的订阅
当您在应用集成中使用事件订阅时,Integration Connectors 会创建 相应连接中订阅的条目。查看所有订阅 对于连接,请执行以下步骤:
- 打开 Google Cloud 项目的“所有连接”页面。
- 点击要查看其订阅的连接。
系统随即会打开连接详情页面。
- 点击订阅内容标签页。
这会显示该连接的所有订阅。此页面上列出了一项订阅 网页可处于以下任一状态:
- 正在创建 - 订阅正在由集成创建。
- 有效:订阅有效且运行正常。
- 已暂停 - 连接处于暂停状态。
- 错误 - 订阅创建失败。例如,身份验证 在订阅创建期间失败。
事件订阅的价格
针对预览触发器中的事件订阅处理的数据(事件载荷)不会产生费用。不过, 您需要为在正式版触发器中处理的事件订阅数据付费。