事件訂閱項目

除了讓您在後端執行讀取和寫入作業，整合連接器還可讓您訂閱後端應用程式中發生的事件。舉例來說，假設您想在建立新 Jira 事件時收到通知。如要完成這項操作，請為事件訂閱設定 Jira Cloud 連接器。您可以搭配使用事件訂閱和應用程式整合功能，建立實用的整合功能，滿足業務需求。詳情請參閱「在整合中使用事件訂閱」一文

在連線中啟用事件訂閱

您建立的連線可用於下列任一用途：

• 僅限執行連接器作業 (實體和動作)
• 僅適用於事件訂閱
• 執行連接器作業和事件訂閱

您可以在建立連線時，選擇啟用事件訂閱功能，並設定事件相關詳細資料。不過，如果您已建立現有連線，並想將其用於事件訂閱，可以編輯及重新設定連線。

下列連接器支援事件訂閱功能：

• Apache Kafka
• Azure AD (Entra ID)
• HubSpot
• HL7
• IBM MQ
• Jira Cloud
• Jira Server Data Center
• Rabbit MQ
• SAP Gateway
• SAP ERP
• ServiceNow
• Solace
• TIBCOEMS
• Webhook
• Zendesk

事件通知中的資料強化

您可以設定連線，在事件通知回應中附加其他資訊。額外資訊是指您已為其設定事件的實體。如要取得其他資訊，您必須在連線中啟用資料強化功能。

舉例來說，如果您在 Zendesk 中訂閱了支援單建立事件，系統會在建立支援單時通知您。不過，事件通知酬載只包含基本票證詳細資料。酬載中不會顯示支援單說明、指派者和狀態等其他詳細資料。如要取得 ticket 實體的這些額外詳細資料，您必須在 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"
        }
      }
    }
  }

{
    "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 服務連結，然後將負載平衡器設為接受來自後端應用程式的事件。接著，連線會監聽負載平衡器位址上的後端事件。下列概略步驟說明如何使用負載平衡器設定私人連線：

1. 前往新建立連線的連線詳細資料頁面。
2. 按一下「編輯入站端點」。畫面會顯示「事件訂閱設定」窗格。
3. 複製「PSC service attachment name」欄位中顯示的服務附件名稱。
4. 建立 PSC 網路端點群組，指向您在上一個步驟中取得的服務連結。
5. 使用先前步驟中建立的 PSC 網路端點群組，建立外部負載平衡器做為後端。
6. 設定負載平衡器，以便接受來自事件供應器 (後端應用程式) IP 位址的要求。

   後續步驟 (7 到 11) 僅適用於後端支援事件訂閱項目自動註冊的連接器。例如 Zendesk 和 Jira。

7. 前往新建立連線的連線詳細資料頁面。
8. 按一下「編輯入站端點」。畫面會顯示「事件訂閱設定」窗格。
9. 在「事件監聽器 ingress 端點」欄位中輸入負載平衡器的地址。
10. 按一下 [完成]。
11. 按一下「儲存」，即可儲存連線的變更內容。

在整合中使用事件訂閱

當您使用事件訂閱功能搭配整合功能時，就能建立整合功能來解決複雜的業務問題。舉例來說，您可以根據 ServiceNow 事件開始執行整個整合作業。應用程式整合功能提供下列觸發事件，可監聽後端應用程式發出的事件通知：

• Azure AD 觸發事件：監聽 Azure AD 事件。
• HL7 觸發條件：會監聽 HL7 事件。
• HubSpot 觸發條件：監聽 HubSpot 事件。
• IBM MQ 觸發事件 - 會監聽 IBM MQ 事件。
• Jira Cloud 觸發條件：監聽 Jira Cloud 事件。
• Rabbit MQ 觸發事件：會監聽 Rabbit MQ 事件。
• ServiceNow 觸發事件：監聽 ServiceNow 事件。
• TIBCOEMS 觸發條件：監聽 TIBCOEMS 事件。
• Webhook 觸發事件：監聽一般 Webhook 事件。
• Zendesk 觸發事件：監聽 Zendesk 事件。

如要設定觸發事件，您必須為連線啟用事件訂閱功能。您可以在現有連線或新連線中啟用事件訂閱。如需設定這些應用程式整合觸發事件的詳細步驟，請參閱對應的觸發事件說明文件。

查看有效的訂閱

在應用程式整合中使用事件訂閱時，整合連接器會在對應的連線中建立訂閱項目。如要查看連線的所有訂閱項目，請執行下列步驟：

1. 開啟 Google Cloud 專案的「所有連線」頁面。

   前往「連線」頁面

2. 按一下要查看訂閱項目的連線。

   系統隨即會開啟「Connection Details」(連線詳細資料) 頁面。

3. 按一下「訂閱」分頁標籤。

   這會顯示連線的所有訂閱項目。這個頁面上列出的訂閱項目可能處於下列任一狀態：

   • 建立：整合項目正在建立訂閱項目。
   • 有效：訂閱方案有效且可正常運作。
   • 已停用：連線處於已停用狀態。
   • 錯誤：無法建立訂閱項目。例如，在建立訂閱時驗證失敗。

事件訂閱項目的價格

系統不會針對預覽觸發事件中為事件訂閱項目處理的資料 (事件酬載) 收費。不過，如果事件訂閱資料是在一般可用的觸發條件中處理，則會產生費用。