Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Richten Sie die Event-Streams von Connect Customer Cases ein

In diesem Thema wird erläutert, wie Sie Ereignis-Streams einrichten und verwenden. Für einige der Onboarding-Schritte müssen Sie die Connect Customer Cases APIs aufrufen.

Schritt 1: Erstellen Sie eine Connect-Customer-Instanz und aktivieren Sie Kundenprofile

Schritt 2: Fügen Sie Ihrer Connect Customer-Instanz eine Cases-Domain hinzu

Detaillierte Anweisungen finden Sie unter Aktivieren Sie Kundenvorgänge über die Connect Customer-Konsole.

Wenn Sie mithilfe der API eine Falldomäne hinzufügen möchten, finden Sie Informationen zur CreateDomain API in der Connect Customer Cases API-Referenz.

Schritt 3: Eine Fallvorlage erstellen

Eine Fallvorlage erstellen In Schritt 6: Fallereignis-Streams testen verwenden Sie die Vorlage.

Wenn Sie mithilfe der API eine Fallvorlage erstellen möchten, finden Sie Informationen zur CreateTemplate API in der Connect-API-Referenz für Kundenfälle.

Schritt 4: Aktivieren und Einrichten von Fallereignis-Streams, um Ereignisse in einer SQS-Warteschlange zu empfangen

Führen Sie den folgenden Befehl aus, um Fallereignis-Streams für Ihre Cases-Domain zu aktivieren. Nach der Ausführung dieses Befehls wird bei der Erstellung oder Aktualisierung von Kundenvorgängen ein Ereignis auf dem Standardbus des EventBridge Dienstes in Ihrem Konto veröffentlicht (es muss sich in derselben AWS-Region wie Ihre Falldomäne befinden).

aws connectcases put-case-event-configuration --domain-id dad5efb6-8485-4a55-8241-98a88EXAMPLE --event-bridge enabled=true

Standardmäßig enthalten die von Connect Customer Cases veröffentlichten Ereignisse nur Metadaten über den Fall, wietemplateId, caseId caseArnapproximateChangeTime, und mehr. Sie können mit dem folgenden Befehl weitere Informationen über den Fall (zum Zeitpunkt der Generierung des Ereignisses) abrufen, die darin aufgenommen werden sollen.

# You can include any other field defined in your cases domain in the fields section.
# To list the fields that are defined in your cases domain, call the Cases ListFields API.
# To include case fields that you create (custom fields) in the event, enter the custom field ID.
aws connectcases put-case-event-configuration --domain-id YOUR_CASES_DOMAIN_ID --event-bridge "{
    \"enabled\": true, 
    \"includedData\": {
       \"caseData\": {
          \"fields\": [
          {
          \"id\": \"status\"
          },
          {
          \"id\": \"title\"
          },
          {
          \"id\": \"customer_id\"
          },
         {
          \"id\": \"your custom field ID\"
          }
        ]
      },
      \"relatedItemData\": {
      \"includeContent\": true
      }
    }
  }"

Erstellen Sie als Nächstes eine Amazon SQS-Warteschlange und legen Sie diese als Ziel für die Connect Customer Cases-Ereignisse in Ihrem EventBridge Bus fest, sodass alle Fallereignisse zur späteren Bearbeitung an die SQS-Warteschlange übermittelt werden.

# Create an SQS queue
aws sqs create-queue --queue-name case-events-queue --attributes "{\"Policy\": \"{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": [{ \\\"Sid\\\": \\\"case-event-subscription\\\", \\\"Effect\\\": \\\"Allow\\\", \\\"Principal\\\": { \\\"Service\\\": \\\"events.amazonaws.com\\\"}, \\\"Action\\\": \\\"SQS:SendMessage\\\", \\\"Resource\\\": \\\"*\\\"}]}\"}"

# Create an rule on the EventBridge default bus that represents the case events
aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"], \"detail-type\": [\"Amazon Connect Cases Change\"]}" --state ENABLED

# Ask event bridge to publish case events to the SQS queue.
aws events put-targets --rule case-events-to-sqs-queue --target "[{
\"Id\": \"target-1\",
\"Arn\": \"arn:aws:sqs:The AWS Region of your Amazon Connect instance:your AWS account ID:case-events-queue\"
}]" 

Schritt 5: Testen der Fallereignis-Streams

Verwenden Sie die Connect Customer Agent-Anwendung, um:

Navigieren Sie zur Amazon SQS-Konsole und überprüfen Sie, ob ein Fallereignis (Typ: CASE.CREATED) für den neu erstellten Fall in Ihrer SQS-Warteschlange verfügbar ist. Ebenso können Sie den oben erstellten Fall ändern und ein entsprechendes Fallereignis (Typ: CASE.UPDATED) in Ihrer SQS-Warteschlange abrufen. Sie können den Kontakt dem Fall zuordnen und einen Kommentar zum Fall hinterlassen, um auch Fallereignisse für diese Aktionen abzurufen.

Schritt 6: Anwendungsfälle für die Fallereignis-Streams

In Fallereignis-Streams werden jedes Mal Ereignisse veröffentlicht, wenn ein Fall erstellt oder aktualisiert, ein Kontakt mit dem Fall verknüpft oder ein Kommentar zu einem Fall hinzugefügt wird. Sie können diese Ereignisse für verschiedene Vorgänge verwenden:

Beispielsweise können Sie das SQS-Ziel an EventBridge (wie in Schritt 4 gezeigt) verwenden, um die Kundenvorgangsereignisse vorübergehend in der SQS-Warteschlange zu speichern, und Lambda-Funktionen verwenden, um Ereignisse im SQS zu verarbeiten, um benutzerdefinierte Anwendungen zu erstellen, z. B. das Senden von E-Mails an den Kunden, wenn sein Fall aktualisiert wird, das automatische Lösen aller mit dem Fall verknüpften Aufgaben und vieles mehr. Ebenso können Sie das Firehose-Ziel auf dem verwenden, EventBridge um die Fallereignisse in einem S3-Bucket zu speichern und dann den AWS Glue für ETL, Athena für Ad-hoc-Analysen und Quick für Dashboards verwenden.