Ereignisabos

Integration Connectors ermöglicht Ihnen nicht nur die Durchführung von Lese- und Schreibvorgängen in Ihrem Back-End, sondern auch das Abonnieren von Ereignissen, die in Ihren Back-End-Anwendungen auftreten. Angenommen, Sie möchten benachrichtigt werden, wenn ein neues Jira-Ticket erstellt wird. Dazu müssen Sie den Jira Cloud-Connector für Ereignisabos konfigurieren. Wenn Sie die Ereignisabos zusammen mit Application Integration verwenden, können Sie nützliche Integrationen für Ihre Geschäftsanforderungen erstellen. Weitere Informationen finden Sie unter Ereignisabos in Integrationen verwenden.

Hinweis: Wenn Sie einen VPC-Dienstperimeter für Ihr Google Cloud-Projekt einrichten, müssen Sie die private Verbindung für Ereignisabos aktivieren.

Ereignisabos in Verbindungen aktivieren

Eine von Ihnen erstellte Verbindung kann für folgende Zwecke verwendet werden:

• Nur für die Durchführung von Connector-Vorgängen (Entitäten und Aktionen)
• Nur für Abos von Veranstaltungen
• Zum Ausführen von Connector-Vorgängen und Ereignisabos

Die Option zum Aktivieren von Ereignisabos und zum Konfigurieren ereignisbezogener Details steht Ihnen während der Verbindungserstellung zur Verfügung. Wenn Sie jedoch bereits eine Verbindung haben und sie für ein Ereignisabo wiederverwenden möchten, können Sie die Verbindung bearbeiten und neu konfigurieren.

Die folgenden Connectors unterstützen Ereignisabos:

• HubSpot
• IBM MQ
• Jira
• Rabbit MQ
• ServiceNow
• Webhook
• Zendesk

Datenanreicherung in Ereignisbenachrichtigungen

Sie können eine Verbindung so konfigurieren, dass zusätzliche Informationen in eine Antwort auf Ereignisbenachrichtigung eingefügt werden. Die zusätzlichen Informationen gelten speziell für die Entität, für die Sie das Ereignis konfiguriert haben. Für zusätzliche Informationen müssen Sie die Datenanreicherung in Ihrer Verbindung aktivieren.

Wenn Sie beispielsweise eine Veranstaltung zur Ticketerstellung in Zendesk abonniert haben, werden Sie benachrichtigt, wenn ein Ticket erstellt wird. Die Nutzlast der Veranstaltungsbenachrichtigung besteht jedoch nur aus den grundlegenden Ticketdetails. Zusätzliche Details wie Ticketbeschreibung, zuständige Person und Status sind in der Nutzlast nicht enthalten. Wenn Sie diese zusätzlichen Details zur Entität ticket abrufen möchten, müssen Sie die Datenanreicherung in einer Zendesk-Verbindung aktivieren. Weitere Informationen findest du unter Ereignisabo konfigurieren. Die folgenden Beispiele zeigen die Antwortnutzlast ohne und mit Datenanreicherung.

Nutzlast ohne Datenanreicherung

Das folgende Beispiel zeigt die Antwortnutzlast von Zendesk zum Erstellen eines Tickets ohne Datenanreicherung.

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

Nutzlast mit Datenanreicherung

Das folgende Beispiel zeigt die Antwortnutzlast von Zendesk zum Erstellen eines Tickets mit Datenanreicherung.

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

Hinweis:

• Wenn Sie die Datenanreicherung aktiviert haben, enthält die Antwortnutzlast zusätzlich zur normalen Antwort, die Sie ohne Datenanreicherung erhalten hätten, das Feld context-data. Im vorherigen Beispiel enthält das Feld context-data zusätzliche Details zum neu erstellten Ticket in Zendesk.
• Nur der Zendesk-Connector unterstützt die Datenanreicherung für Ereignisbenachrichtigungen.

Private Verbindung für Ereignisabo

Für noch mehr Sicherheit können Sie private Verbindungen zwischen Ihrer Back-End-Anwendung und Ihrer Verbindung konfigurieren. Bei privaten Verbindungen wird der Event-Listener Ihrer Verbindung nicht direkt öffentlich gemacht. Stattdessen müssen Sie eingehenden Netzwerktraffic zum Event-Listener über einen PSC-Dienstanhang zulassen, der Ihnen von Integration Connectors bereitgestellt wird.

Wenn Sie beim Erstellen der Verbindung die Option Private Verbindung aktivieren für das Ereignisabo ausgewählt haben, erstellt Integration Connectors einen PSC-Dienstanhang. Sie müssen den PSC-Dienstanhang für Ihre Back-End-Anwendung freigeben. Verwenden Sie dazu einen beliebigen Ansatz. Ein möglicher Ansatz besteht darin, den PSC-Dienstanhang in einem Load-Balancer zu verwenden und dann den Load-Balancer so zu konfigurieren, dass Ereignisse von Ihrer Back-End-Anwendung akzeptiert werden. Die Verbindung überwacht dann die Ereignisse des Back-Ends über die Adresse des Load-Balancers. Die folgenden übergeordneten Schritte zeigen, wie Sie mit einem Load-Balancer private Verbindungen konfigurieren können:

1. Rufen Sie die Seite mit den Verbindungsdetails der neu erstellten Verbindung auf.
2. Klicken Sie auf Endpunkt für eingehenden Traffic bearbeiten. Daraufhin wird der Bereich Abo-Einstellungen für Ereignisse angezeigt.
3. Kopieren Sie den Namen des Dienstanhangs, so wie er im Feld Name des PSC-Dienstanhangs angegeben ist.
4. Erstellen Sie eine PSC-Netzwerk-Endpunktgruppe, die auf den Dienstanhang verweist, den Sie im vorherigen Schritt abgerufen haben.
5. Erstellen Sie einen externen Load-Balancer mit der im vorherigen Schritt erstellten PSC-Netzwerk-Endpunktgruppe als Back-End.
   Tipp: Wenn Sie bereits einen externen Load-Balancer haben, können Sie ihn zum Konfigurieren privater Verbindungen verwenden, anstatt eine neue zu erstellen.
6. Konfigurieren Sie den Load-Balancer so, dass Anfragen von der IP-Adresse Ihres Ereignisanbieters (Back-End-Anwendung) akzeptiert werden.

   Die nachfolgenden Einstellungen (7 bis 11) gelten nur in Connectors, deren Backend die automatische Registrierung von Ereignisabos unterstützt. Beispiel: Zendesk und Jira.

7. Rufen Sie die Seite mit den Verbindungsdetails der neu erstellten Verbindung auf.
8. Klicken Sie auf Endpunkt für eingehenden Traffic bearbeiten. Daraufhin wird der Bereich Abo-Einstellungen für Ereignisse angezeigt.
9. Geben Sie die Adresse des Load-Balancers in das Feld Ingress-Endpunkt des Event-Listeners ein.
10. Klicken Sie auf Fertig.
11. Klicken Sie auf Speichern, um die Änderungen an der Verbindung zu speichern.

Ereignisabos in deinen Integrationen verwenden

Wenn Sie Ereignisabos zusammen mit Ihren Integrationen verwenden, können Sie Integrationen erstellen, um komplexe Geschäftsprobleme zu lösen. Sie können beispielsweise die Ausführung der gesamten Integration basierend auf einem ServiceNow-Ereignis starten. Application Integration bietet die folgenden Trigger, die auf Ereignisbenachrichtigungen von Ihren Back-End-Anwendungen warten:

• HubSpot-Trigger: Erfasst HubSpot-Ereignisse.
• IBM MQ-Trigger: Wartet auf IBM MQ-Ereignisse.
• Jira Cloud-Trigger: Erfasst Jira Cloud-Ereignisse.
• Rabbit MQ-Trigger – Wartet auf Rabbit MQ-Ereignisse.
• ServiceNow-Trigger: Erfasst ServiceNow-Ereignisse.
• Webhook-Trigger: Erfasst allgemeine Webhook-Ereignisse.
• Zendesk-Trigger: Wartet auf Zendesk-Ereignisse.

Zum Konfigurieren der Trigger müssen Sie das Ereignisabo für Ihre Verbindungen aktivieren. Sie können das Ereignisabo entweder in einer vorhandenen oder in einer neuen Verbindung aktivieren. Ausführliche Schritte zum Konfigurieren dieser Application Integration-Trigger finden Sie in der zugehörigen Triggerdokumentation.

Aktive Abos aufrufen

Wenn Sie in der Anwendungsintegration ein Ereignisabo verwenden, erstellt Integration Connectors einen Eintrag für das Abo in der entsprechenden Verbindung. Führen Sie die folgenden Schritte aus, um alle Abos für eine Verbindung anzusehen:

1. Öffnen Sie die Seite „Alle Verbindungen“ für Ihr Google Cloud-Projekt.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, deren Abos Sie sich ansehen möchten.

   Die Seite Verbindungsdetails wird geöffnet.

3. Klicken Sie auf den Tab Abos.

   Dadurch werden alle Abos für die Verbindung angezeigt. Ein auf dieser Seite aufgeführtes Abo kann einen der folgenden Status haben:

   • Wird erstellt: Das Abo wird von einer Integration erstellt.
   • Aktiv: Das Abo ist gültig und funktioniert.
   • Gesperrt: Die Verbindung befindet sich im gesperrten Status.
   • Fehler: Das Abo konnte nicht erstellt werden. Beispiel: Authentifizierungsfehler während der Aboerstellung.

Hinweis: Wenn eine Verbindung aktive Ereignisabos hat, können Sie sie weder löschen noch den Hostnamen oder die IP-Adresse des Back-Ends der Verbindung bearbeiten.

Preise für das Veranstaltungsabo

Die Daten (Ereignisnutzlast), die für Ereignisabos in den Vorschautriggern verarbeitet wird, werden nicht in Rechnung gestellt. Es fallen aber Kosten für Ereignisabodaten an, die in einem allgemein verfügbaren Trigger verarbeitet werden.