Ereignisabos

Mit Integration Connectors können Sie nicht nur Lese- und Schreibvorgänge auf Ihrem Back-End ausführen, können Sie Ereignisse abonnieren, die in Ihren Back-End-Anwendungen auftreten. Stellen Sie sich zum Beispiel vor, möchten benachrichtigt werden, wenn ein neues Jira-Ticket erstellt wird. Um dies zu erreichen, konfigurieren Sie Jira Cloud Connector für Ereignisabos. Wenn Sie die Ereignisabos zusammen mit mit Application Integration können Sie Folgendes tun: nützliche Integrationen für Ihre Geschäftsanforderungen zu erstellen. Weitere Informationen finden Sie unter Ereignisabos in Integrationen verwenden

Hinweis:Wenn Sie eine VPC-Dienstperimeter für in 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
• Zum Ausführen von Connector-Vorgängen und Ereignisabos

Die Option zum Aktivieren von Ereignisabos und zum Konfigurieren ereignisbezogener Details ist verfügbar die während der Verbindungserstellung automatisch erstellt werden. Wenn jedoch und möchten sie für ein Ereignisabo nutzen, haben Sie die Möglichkeit, indem 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 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 zur Ticketerstellung in Zendesk abonniert haben, werden Sie werden benachrichtigt, wenn ein Ticket erstellt wird. Die Nutzlast der Ereignisbenachrichtigung besteht jedoch aus nur die Basisticketdetails. Zusätzliche Details wie Ticketbeschreibung, Zuständige Person und Status sind nicht in der Nutzlast vorhanden. 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 Die folgenden Beispiele zeigen die Antwortnutzlast 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 zusätzlich zur normalen Antwort, die Sie normalerweise erhalten, das Feld context-data. ohne Datenanreicherung. Im vorherigen Beispiel hat der Parameter Das Feld context-data enthält zusätzliche Details des neu in Zendesk erstellten Tickets.
• Nur Zendesk Connector 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 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 die den PSC-Dienstanhang an Ihre Back-End-Anwendung mit einem für Sie geeigneten Ansatz. 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 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 einen Verweis verweist. an den Dienstanhang, 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 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 Back-End automatische Registrierung von Ereignisabos. Beispiele: Zendesk und Jira.

7. Gehen Sie zur Seite mit den Verbindungsdetails der neu erstellten Verbindung.
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 zur Lösung komplexer Geschäftsprobleme. Sie können beispielsweise die Ausführung Ihrer gesamten Integration basierend auf einem ServiceNow-Ereignis. Application Integration stellt die folgenden Trigger bereit, 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 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 auf: für eine Verbindung führen Sie die folgenden Schritte aus:

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. 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 Vorschau-Triggern verarbeitet werden, werden nicht berechnet. Sie können jedoch Daten zu Ereignisabos, die in allgemein verfügbaren Triggern verarbeitet werden, werden Ihnen in Rechnung gestellt.