Ereignisabos

Mit Integration Connectors können Sie nicht nur Lese- und Schreibvorgänge in Ihrem Backend ausführen, sondern auch Ereignisse abonnieren, die in Ihren Backend-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 Ereignisabonnements konfigurieren. Mithilfe von Ereignisabonnements und der Anwendungsintegration können Sie nützliche Integrationen erstellen, die Ihren Geschäftsanforderungen entsprechen. Weitere Informationen finden Sie unter Ereigniseinträge in Ihren Integrationen verwenden.

Hinweis:Wenn Sie eine VPC-Dienstperimeter für Ihrem Google Cloud-Projekt aktiviert haben, 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
• Für Connector-Vorgänge und Ereignisabos

Die Option zum Aktivieren von Ereignisabos und zum Konfigurieren ereignisbezogener Details ist beim Erstellen einer Verbindung verfügbar. Wenn Sie jedoch bereits eine Verbindung haben und sie für das Ereignisabo verwenden möchten, können Sie sie bearbeiten und neu konfigurieren.

Die folgenden Connectors unterstützen Ereignisabos:

• Apache Kafka
• HubSpot
• IBM MQ
• Jira Cloud
• RabbitMQ
• SAP-Gateway
• SAP ERP
• ServiceNow
• Solace
• TIBCOEMS
• Webhook
• Zendesk

Datenanreicherung in Ereignisbenachrichtigungen

Sie können eine Verbindung konfigurieren , um einer Antwort auf Ereignisbenachrichtigungen zusätzliche Informationen hinzuzufügen. Die zusätzlichen Informationen ist spezifisch für die Entität, für die Sie das Ereignis konfiguriert haben. Um die zusätzlichen Informationen zu erhalten, müssen Sie die Datenanreicherung in Ihrer Verbindung aktivieren.

Wenn Sie beispielsweise ein Ereignis zum Erstellen eines Tickets in Zendesk abonniert haben, werden Sie benachrichtigt, wenn ein Ticket erstellt wird. Die Nutzlast der Ereignisbenachrichtigung besteht jedoch nur aus den grundlegenden Ticketdetails. Zusätzliche Details wie Ticketbeschreibung, zuständige Person und Status sind in der Nutzlast nicht enthalten. Um diese zusätzlichen Details der ticket-Entität müssen Sie die Datenanreicherung in einer Zendesk-Verbindung aktivieren. Für finden Sie unter Ereignisabo konfigurieren Die folgenden Beispiele zeigen die Antwortnutzlast ohne und mit Datenanreicherung.

Nutzlast ohne Datenanreicherung

Im folgenden Beispiel wird die Antwortnutzlast des Zendesk-Ereignisses „create ticket“ ohne Datenanreicherung gezeigt.

{
  "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 des Zendesk-Ereignisses „create ticket“ (Ticket erstellen) 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 würden, das Feld context-data. Im vorherigen Beispiel enthält das Feld context-data zusätzliche Details zum neu erstellten Ticket in Zendesk.
• Nur Zendesk Connector unterstützt die Datenanreicherung für Ereignisbenachrichtigungen.

Private Verbindung für Ereignisabo

Für eine erhöhte Sicherheit können Sie eine private Verbindung zwischen Ihrer Back-End-Anwendung und Ihrer Verbindung konfigurieren. Bei einer privaten Verbindung wird der Ereignis-Listener Ihrer Verbindung nicht direkt veröffentlicht. Stattdessen müssen Sie eingehenden Netzwerktraffic an den Event-Listener über einen Ihnen zur Verfügung gestellten PSC-Dienstanhang zulassen von Integration Connectors.

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 Backend-Anwendung freigeben. Dazu können Sie jeden beliebigen Ansatz verwenden. Eine Möglichkeit verwenden Sie den PSC-Dienstanhang in einem Load-Balancer und konfigurieren Sie dann den Load Balancer, um Ereignisse von Ihrer Back-End-Anwendung anzunehmen. 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 eine private Verbindung konfigurieren:

1. Rufen Sie die Seite mit den Verbindungsdetails der neu erstellten Verbindung auf.
2. Klicken Sie auf Eingangsendpunkt bearbeiten. Daraufhin wird der Bereich Einstellungen für Ereignisabos angezeigt.
3. Kopieren Sie den Namen des Dienstanhangs, der 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 erhalten haben.
5. Externen Load-Balancer mit dem PSC-Netzwerk erstellen die im vorherigen Schritt als Back-End erstellt wurde.
   Tipp: Wenn Sie bereits einen externen Load Balancer haben, können Sie ihn zum Konfigurieren der privaten Verbindung verwenden, anstatt einen neuen zu erstellen.
6. Konfigurieren Sie den Load Balancer so, dass er Anfragen von der IP-Adresse Ihres Ereignisanbieters (Back-End-Anwendung) akzeptiert.

   Die nachfolgenden Einstellungen (7 bis 11) gelten nur für Connectors, deren Back-End automatische Registrierung von Ereignisabos. 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 Ingress-Endpunkt für Event-Listener ein.
10. Klicken Sie auf Fertig.
11. Klicken Sie auf Speichern, um die Änderungen an der Verbindung zu speichern.

Ereignisabos in Ihren Integrationen verwenden

Wenn Sie Ereignisabos zusammen mit Ihren Integrationen verwenden, können Sie zur Lösung komplexer Geschäftsprobleme. So können Sie beispielsweise die Ausführung Ihrer gesamten Integration basierend auf einem ServiceNow-Ereignis starten. Die Anwendungsintegration bietet die folgenden Trigger, die auf Ereignisbenachrichtigungen von Ihren Backend-Anwendungen warten:

• HubSpot-Trigger: Hier werden HubSpot-Ereignisse überwacht.
• IBM MQ-Trigger: wartet auf IBM MQ-Ereignisse.
• Jira Cloud-Trigger: Hört auf Jira Cloud-Ereignisse.
• Rabbit MQ-Trigger: Erfasst Rabbit MQ-Ereignisse.
• ServiceNow-Trigger: wartet auf ServiceNow-Ereignisse.
• TIBCOEMS-Trigger: Hört auf TIBCOEMS-Ereignisse.
• Webhook-Trigger: Hört auf generische Webhook-Ereignisse.
• Zendesk-Trigger: wartet auf Zendesk-Ereignisse.

Zum Konfigurieren der Trigger müssen Sie das Ereignisabo aktivieren für Ihre Kontakte. Du kannst das Ereignisabo entweder in einer bestehenden oder einer neuen Verbindung. Eine ausführliche Anleitung Informationen zum Konfigurieren dieser Application Integration-Trigger finden Sie in den entsprechenden Trigger-Dokumentation.

Aktive Abos aufrufen

Wenn Sie ein Ereignisabo in Ihrer Anwendungsintegration verwenden, erstellt Integration Connectors einen Eintrag für das Abo in der entsprechenden Verbindung. So rufen Sie alle Abos für eine Verbindung auf:

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.

   Daraufhin wird die Seite Verbindungsdetails geöffnet.

3. Klicken Sie auf den Tab Abos.

   Daraufhin werden alle Abos für die Verbindung angezeigt. Ein hier aufgeführtes Abo Folgende Status sind möglich:

   • 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: Authentifizierung Fehler bei der Aboerstellung.

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

Preise für Ereignisabo

Die Daten (Ereignisnutzlast), die für Ereignisabos in den Vorabtriggern verarbeitet werden, werden nicht in Rechnung gestellt. Daten von Ereignisabonnements, die in allgemein verfügbaren Triggern verarbeitet werden, werden Ihnen jedoch in Rechnung gestellt.