此页面由 Cloud Translation API 翻译。

活动订阅

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"
        }
      }
    }
  }
 }

用于事件订阅的专用连接

为提高安全性，您可以在后端应用和连接之间配置专用连接。在专用连接中，连接的事件监听器不会直接设为公开。您必须允许通过 Integration Connectors 提供给您的 PSC 服务连接来允许入站网络流量进入事件监听器。

在创建连接期间，如果您为事件订阅选择了启用专用连接，则 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 项目的“所有连接”页面。
转到“连接”页面
点击您要查看其订阅的连接。
系统随即会打开连接详情页面。
点击订阅内容标签页。
这会显示该连接的所有订阅。此页面上列出的订阅可能处于以下任何状态：
- 正在创建 - 订阅正在由集成创建。
- 有效：订阅有效且运行正常。
- 已暂停 - 连接处于暂停状态。
- 错误 - 订阅创建失败。例如，创建订阅期间身份验证失败。

事件订阅的价格

针对预览触发器中的事件订阅处理的数据（事件载荷）不会产生费用。不过，您需要为在正式版触发器中处理的事件订阅数据付费。