Konfigurieren Sie die Amazon EventBridge-Integration

Nach der Installation von Amazon EventBridge muss ein Genesys Cloud-Administrator die Amazon EventBridge-Quellenintegration hinzufügen und konfigurieren. Administratoren müssen zunächst die Integration hinzufügen und dann die neu hinzugefügte Integration konfigurieren und aktivieren.

Voraussetzungen
  • Integrationen > Integration > Alle Berechtigung (enthalten in der Rolle Master Admin )

Hinzufügen der Integration

  1. Klicken Sie auf Admin.
  2. Klicken Sie unter Integrationenauf Integrationen.
  3. Klicken Sie auf Integration hinzufügen. 
  4. Geben Sie in das Suchfeld EventBridgeein.
  5. Suchen Sie die Karte mit dem Titel Amazon EventBridge Source.
  6. Klicken Sie auf Installieren. Details zur Integration werden angezeigt.

    Konfigurieren und aktivieren 

    Als nächstes konfigurieren und aktivieren Sie die Amazon EventBridge-Integration:

    1. Auf der Registerkarte Details können Sie den Standardnamen (Amazon EventBridge Source) übernehmen oder einen anderen Namen eingeben.
    2. (Fakultativ) Geben Sie in das vorgesehene Feld Anmerkungen ein.
    3. Wählen Sie die Registerkarte Konfiguration .
    4. Verbinden Sie Ihre Partner-Ereignisquelle mit einem Ereignisbus.
    5. Geben Sie Ihre 12-stellige AWS-Konto-ID und die Region ein, in der die Partner-Ereignisquelle erstellt werden soll. Verwenden Sie für Ihre Region die Form mit Bindestrich wie us-east-1 oder us-west-2 Weitere Informationen finden Sie in der Liste der von unterstützten Regionalcodes in der AWS-Dokumentation
    6. Geben Sie ein eindeutiges Event Source Suffix an, das an die Ereignisquelle im AWS-Konto angehängt wird Das Suffix kann bis zu 64 Zeichen lang sein, bestehend aus Klein- und Großbuchstaben, Zahlen oder Zeichen (.,-,_). Das Suffix wird an den Namen der Partner-Ereignisquelle angehängt und hilft, sie von anderen Amazon EventBridge-Integrationen zu unterscheiden.
    7. Wählen Sie unter Topic Filteringdie Benachrichtigungsthemen aus, die an EventBridge gesendet werden sollen. Geben Sie eine Liste von Benachrichtigungsthemen ein, die die Partner-Ereignisquelle empfangen muss. Einige Beispiele sind: v2.users.{id}.presence, v2.users.{id}.routingStatus, und so weiter. Eine Liste aller verfügbaren Benachrichtigungsthemen finden Sie unter Verfügbare Themen im Genesys Cloud Developer Center
      Hinweis: Die Themen enthalten keine Parameter und liefern Informationen für die gesamte Organisation. Wahl des Empfangs von v2.users.{id}.presence ist es nicht erforderlich, eine Benutzer-ID anzugeben, wie es bei der Benachrichtigungs-API der Fall ist Sie erhalten alle Präsenzbenachrichtigungen für Ihre Organisation. Achten Sie darauf, wie viele Benachrichtigungsthemen Sie auswählen. Für jedes ausgewählte Thema werden alle übereinstimmenden Ereignisse für Ihre gesamte Organisation an AWS EventBridge gesendet, um an das Ziel Ihrer Wahl weitergeleitet zu werden. Wenn Sie keine Benachrichtigungsthemen auswählen, werden auch keine Ereignisse gesendet.
    8. Klicken Sie auf Speichern.
    9. Klicken Sie auf die Registerkarte Details
    10. Klicken Sie auf den Kippschalter, damit die Integration Aktivist.
    11. Klicken Sie auf Ja. In ca. 5 Minuten oder nach einem Neuladen der Anwendung wird automatisch eine Partner-Ereignisquelle in Ihrem AWS-Konto erstellt. Genesys Cloud beginnt sofort nach erfolgreicher Aktivierung mit dem Senden von Ereignissen.
      Hinweis: Sie können bis zu 10 Amazon EventBridge Integrationsinstanzen für eine Organisation konfigurieren.

    Sobald Sie die Integration in Genesys Cloud konfiguriert und aktiviert haben, richten Sie in der EventBridge-Konsole in AWS Regeln ein, um Nachrichten von der Ereignisquelle an die vorgesehenen AWS-Ziele weiterzuleiten. Weitere Informationen finden Sie unter Konfigurieren Sie EventBridge für den Empfang von Ereignissen und Erste Schritte mit Amazon EventBridge

    Ändern Sie die Integrationskonfiguration

    Die Änderung eines der folgenden Attribute bei einer aktiven Integration führt zur Deaktivierung der Integration:

    • AWS-Konto-ID
    • AWS-Region
    • Suffix der Ereignisquelle

    Sie müssen die Integration nach einer Änderung der Integrationskonfiguration erneut aktivieren. Durch die Reaktivierung der Integration wird die alte Ereignisquelle gelöscht und eine neue Ereignisquelle erstellt.

    Die Themenfilter können jederzeit geändert werden, ohne dass dies zur Deaktivierung der Integration führt. Warten Sie bis zu 1 Minute, bis alle Änderungen wirksam werden.

    Deaktivieren Sie beide Integrationen.

    Nachdem eine EventBridge-Integration erfolgreich aktiviert wurde, beginnt Genesys Cloud damit, passende Benachrichtigungen an die Ereignisquelle des Partners zu senden. Ereignisse können durch Deaktivierung der Integration vorübergehend deaktiviert werden. Dadurch wird die Ereignisquelle des Partners in keiner Weise verändert.

    Wenn die Integration nicht mehr benötigt wird, kann sie gelöscht werden. Wenn Sie die Integration löschen, wird die Ereignisquelle des Partners in AWS gelöscht.

    Häufige Fehler

    Im Folgenden sind einige häufige Fehler aufgeführt, die auftreten können, wenn Sie versuchen, eine Integrationskonfiguration zu aktivieren:

    • Ungültige AWS-Konto-ID - Zeigt an, dass die angegebene AWS-Konto-ID keine gültige 12-stellige Zeichenfolge ist
    • Ungültige AWS-Region - Gibt an, dass die angegebene AWS-Region nicht zu den gültigen EventBridge-Regionengehört.
    • Suffix der Ereignisquelle muss eindeutig sein - Zeigt an, dass das Suffix der Ereignisquelle mit einem Suffix übereinstimmt, das bereits in einer anderen aktiven EventBridge-Integration für die Organisation definiert ist