Ereignisabos

Mit Integration Connectors können Sie nicht nur Lese- und Schreibvorgänge auf Ihrem Back-End ausführen, sondern auch Ereignisse abonnieren, die in Ihren Back-End-Anwendungen auftreten. Angenommen, Sie möchten benachrichtigt werden, wenn ein neues Jira-Ticket erstellt wird. Konfigurieren Sie dazu den Jira Cloud Connector für Ereignisabos. Wenn Sie die Ereignisabos zusammen mit Application Integration verwenden, können Sie nützliche Integrationen für Ihre Geschäftsanforderungen erstellen. Weitere Informationen findest du unter Ereignisabos in Integrationen verwenden.

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

Ereignisabos in Verbindungen aktivieren

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

• Nur für Connector-Vorgänge (Entitäten und Aktionen)
• Nur für Ereignisabos
• 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 verwenden möchten, können Sie die Verbindung bearbeiten und neu konfigurieren.

Die folgenden Connectors unterstützen Ereignisabos:

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

Datenanreicherung in Ereignisbenachrichtigungen

Sie können eine Verbindung konfigurieren, um zusätzliche Informationen an eine Antwort auf Ereignisbenachrichtigungen anzuhängen. Die zusätzlichen Informationen gelten speziell für die Entität, für die Sie das Ereignis konfiguriert haben. Damit Sie diese zusätzlichen Informationen erhalten, müssen Sie in Ihrer Verbindung die Datenanreicherung aktivieren.

Wenn Sie beispielsweise ein Ereignis zur Ticketerstellung in Zendesk abonniert haben, werden Sie benachrichtigt, wenn ein Ticket erstellt wird. Die Nutzlast der Ereignisbenachrichtigung besteht jedoch nur aus den grundlegenden Ticketdetails. In der Nutzlast sind keine zusätzlichen Details wie Ticketbeschreibung, zuständige Person und Status vorhanden. Damit Sie diese zusätzlichen Details der Entität ticket erhalten, müssen Sie die Datenanreicherung in einer Zendesk-Verbindung aktivieren. Weitere Informationen finden Sie unter Ereignisabo konfigurieren. Die folgenden Beispiele zeigen die Nutzlast der Antwort ohne und mit Datenanreicherung.

Nutzlast ohne Datenanreicherung

Das folgende Beispiel zeigt die Antwortnutzlast der Zendesk-Funktion 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 der Zendesk-Funktion zum Erstellen eines Tickets für ein Ereignis 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 des neu in Zendesk erstellten Tickets.
• Nur der Zendesk unterstützt die Datenanreicherung für Ereignisbenachrichtigungen.

Private Verbindung für Ereignisabo

Zur Erhöhung der Sicherheit können Sie eine private Verbindung 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 zur Verfügung gestellt wird.

Wenn Sie beim Erstellen der Verbindung für das Ereignisabo Private Verbindung aktivieren ausgewählt haben, erstellt Integration Connectors einen PSC-Dienstanhang. Sie müssen den PSC-Dienstanhang für Ihre Back-End-Anwendung mit einem beliebigen geeigneten Ansatz verfügbar machen. Ein möglicher Ansatz besteht darin, den PSC-Dienstanhang in einem Load-Balancer zu verwenden und den Load-Balancer dann so zu konfigurieren, dass Ereignisse von Ihrer Back-End-Anwendung akzeptiert werden. Die Verbindung überwacht dann die Ereignisse Ihres Back-Ends an der Adresse des Load-Balancers. In den folgenden allgemeinen Schritten wird gezeigt, wie Sie mit einem Load-Balancer private Verbindungen konfigurieren:

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 Einstellungen für Ereignisabos angezeigt.
3. Kopieren Sie den Namen des Dienstanhangs so, wie er im Feld Name des PSC-Dienstanhangs angezeigt wird.
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 damit private Verbindungen konfigurieren, 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 für Connectors, deren Backend die automatische Registrierung von Ereignisabos unterstützt. Beispiele: 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 Einstellungen für Ereignisabos angezeigt.
9. Geben Sie die Adresse des Load-Balancers in das Feld Endpunkt für Ereignis-Listener für eingehenden Traffic ein.
10. Klicken Sie auf Fertig.
11. Klicken Sie auf Speichern, um die Änderungen an der Verbindung zu speichern.

Ereignisabos in Integrationen verwenden

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

• HubSpot-Trigger: wartet auf HubSpot-Ereignisse.
• IBM MQ-Trigger: wartet auf IBM MQ-Ereignisse.
• Jira Cloud-Trigger: wartet auf Jira Cloud-Ereignisse.
• Rabbit MQ-Trigger: Erfasst Rabbit MQ-Ereignisse.
• ServiceNow-Trigger: wartet auf ServiceNow-Ereignisse.
• TIBCOEMS-Trigger: wartet auf TIBCOEMS-Ereignisse.
• Webhook-Trigger: wartet auf 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 Verbindung oder in einer neuen Verbindung aktivieren. Eine ausführliche Anleitung zum Konfigurieren dieser Application Integration-Trigger finden Sie in der entsprechenden Triggerdokumentation.

Aktive Abos aufrufen

Wenn Sie in Ihrer 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 aufrufen möchten.

   Die Seite Verbindungsdetails wird geöffnet.

3. Klicken Sie auf den Tab Abos.

   Dadurch werden alle Abos für die Verbindung angezeigt. Abos, die auf dieser Seite aufgeführt sind, können einen der folgenden Status haben:

   • Wird erstellt: Das Abo wird durch eine Integration erstellt.
   • Aktiv: Das Abo ist gültig und funktionsfähig.
   • Ausgesetzt: Die Verbindung ist gesperrt.
   • Fehler: Das Abo konnte nicht erstellt werden. Beispiel: Authentifizierungsfehler bei der Aboerstellung.

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

Preise für Ereignisabo

Die Daten (Ereignisnutzlast), die für Ereignisabos in den Vorschau-Triggern verarbeitet werden, werden nicht berechnet. Daten zu Ereignisabos, die in allgemein verfügbaren Triggern verarbeitet werden, werden Ihnen jedoch in Rechnung gestellt.