此页面由 Cloud Translation API 翻译。

事件订阅

除了让您在后端执行读写操作之外，集成连接器还可让您订阅后端应用中发生的事件。例如，假设您希望在创建新的 Jira 工单时收到通知。为此，您可以为事件订阅配置 Jira Cloud 连接器。通过使用事件订阅以及 Application Integration，您可以创建实用的集成来满足您的业务需求。如需了解详情，请参阅在集成中使用事件订阅

在连接中启用事件订阅

您创建的关联可用于以下任一用途：

仅用于执行连接器操作（实体和操作）
仅适用于事件订阅
用于执行连接器操作和事件订阅

在创建关联时，您可以选择启用事件订阅和配置事件相关详细信息。不过，如果您已有现有连接，并希望将其用于事件订阅，可以通过修改和重新配置该连接来实现。

以下连接器支持事件订阅：

事件通知中的数据丰富功能

您可以配置连接，以便在事件通知响应中附加其他信息。这些其他信息仅适用于您为其配置了事件的实体。如需获取更多信息，您必须在关联中启用数据丰富功能。

例如，如果您在 Zendesk 中订阅了工单创建事件，则会在有工单创建时收到通知。不过，事件通知载荷仅包含基本支持服务工单详情。工单说明、分配者和状态等其他详细信息未包含在载荷中。如需获取 ticket 实体的这些其他详细信息，您必须在 Zendesk 连接中启用数据丰富功能。如需了解详情，请参阅配置事件订阅。以下示例展示了未使用和使用数据丰富功能时的响应载荷。

未进行数据丰富的载荷

以下示例展示了未进行数据丰富的 Zendesk 创建工单事件的响应载荷。

{
  "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“创建工单”事件的响应载荷。

{
    "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 服务连接，允许向事件监听器发送入站网络流量。

在创建连接期间，如果您为事件订阅选择了启用专用连接，集成连接器会创建 PSC 服务附件。您必须使用适合您的任何方法将 PSC 服务连接公开给后端应用。一种可能的方法是在负载平衡器中使用 PSC 服务连接，然后将负载平衡器配置为接受来自后端应用的事件。然后，该连接会在负载平衡器的地址上监听后端的事件。以下概要步骤展示了如何使用负载平衡器配置专用连接：

前往新创建的连接的连接详情页面。
点击修改入站端点。此时会显示事件订阅设置窗格。
复制 PSC 服务连接名称字段中显示的服务连接名称。
创建一个指向您在上一步中获取的服务连接的 PSC 网络端点组。
创建一个外部负载平衡器，并将在上一步中创建的 PSC 网络端点组用作后端。
提示： 如果您已经有外部负载平衡器，则可以使用它来配置专用连接，而无需创建新的负载平衡器。
将负载平衡器配置为接受来自事件提供方（后端应用）IP 地址的请求。
后续步骤（7 到 11）仅适用于后端支持自动注册事件订阅的连接器。例如 Zendesk 和 Jira。
前往新创建的连接的连接详情页面。
点击修改入站端点。此时会显示事件订阅设置窗格。
在事件监听器入站流量端点字段中输入负载平衡器的地址。
点击完成。
点击保存以保存对连接所做的更改。

在集成中使用事件订阅

将事件订阅与集成搭配使用时，您可以创建集成来解决复杂的业务问题。例如，您可以根据 ServiceNow 事件开始执行整个集成。应用集成提供了以下用于监听来自后端应用的事件通知的触发器：

HL7 触发器 - 监听 HL7 事件。
HubSpot 触发器 - 监听 HubSpot 事件。
IBM MQ 触发器 - 监听 IBM MQ 事件。
Jira Cloud 触发器 - 监听 Jira Cloud 事件。
RabbitMQ 触发器 - 监听 RabbitMQ 事件。
ServiceNow 触发器 - 监听 ServiceNow 事件。
TIBCOEMS 触发器 - 监听 TIBCOEMS 事件。
Webhook 触发器 - 监听通用 webhook 事件。
Zendesk 触发器 - 监听 Zendesk 事件。

如需配置触发器，您必须为连接启用事件订阅。您可以在现有连接中或新连接中启用事件订阅。如需详细了解如何配置这些应用集成触发器，请参阅相应的触发器文档。

查看有效订阅

当您在应用集成中使用事件订阅时，Integration Connectors 会在相应连接中为该订阅创建条目。如需查看某个连接的所有订阅，请执行以下步骤：

打开 Google Cloud 项目的“所有连接”页面。
转到“连接”页面
点击您要查看其订阅的连接。
系统随即会打开连接详情页面。
点击订阅标签页。
此时会显示该连接的所有订阅。此页面上列出的订阅可以处于以下任一状态：
- 正在创建 - 订阅由集成创建。
- 有效 - 订阅有效且正常运行。
- 暂停 - 连接处于暂停状态。
- 错误 - 创建订阅失败。例如，订阅创建期间身份验证失败。

事件订阅的价格

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