Richten Sie Streams für Fallereignisse ein

In diesem Thema wird erklärt, wie Sie Event-Streams für Fallstudien einrichten und verwenden. Für einige der Onboarding-Schritte müssen Sie die Amazon Connect Cases-APIs aufrufen.

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

1. Stellen Sie sicher, dass Sie über eine funktionierende Amazon Connect Connect-Instance in einem der Fälle verfügen, in AWS-Regionen denen Cases verfügbar ist. Siehe Verfügbarkeit der Fälle nach Regionen.

2. Aktivieren Amazon Connect Connect-Kundenprofile. Detaillierte Anweisungen finden Sie unter Aktivieren Sie Kundenprofile für Ihre Instanz.

   Amazon Connect Cases erfordert Kundenprofile, da jeder Fall mit einem Kundenprofil aus dem Kundenprofil-Service verknüpft sein muss.

Schritt 2: Fügen Sie Ihrer Amazon Connect Connect-Instance eine Cases-Domain hinzu

Detaillierte Anweisungen finden Sie unter Fälle aktivieren.

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

Schritt 3: Erstellen Sie eine Fallvorlage

Erstellen Sie eine Fallvorlage. In Schritt 6: Fallereignisstreams testen verwenden Sie die Vorlage.

Wenn Sie mithilfe der API eine Fallvorlage erstellen möchten, finden Sie weitere Informationen zur CreateTemplateAPI in der Amazon Connect Cases API-Referenz.

Schritt 4: Aktivieren Sie die Streams von Fallereignissen und richten Sie sie ein, um Ereignisse in einer SQS-Warteschlange zu empfangen

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

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

Standardmäßig enthalten die von Amazon Connect Cases veröffentlichten Ereignisse nur Metadaten über den FalltemplateId,caseId, caseArnapproximateChangeTime, und mehr. Sie können den folgenden Befehl ausführen, um weitere Informationen über den Fall (zum Zeitpunkt der Generierung des Ereignisses) zu erhalten, der in das Ereignis aufgenommen werden soll.

Anmerkung

Wenn Sie ein benutzerdefiniertes Feld in das Ereignis einbeziehen möchten, verwenden Sie die benutzerdefinierte Feld-ID. Anweisungen zum Auffinden der ID des benutzerdefinierten Felds finden Sie unterSuchen Sie die ID des benutzerdefinierten Felds.

# 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 SQS-Warteschlange und legen Sie diese als Ziel für die Amazon Connect Cases-Ereignisse auf Ihrem EventBridge Bus fest, sodass alle Fallereignisse zur späteren Verarbeitung 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 defualt bus that represents the case events
aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"]}" --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 Sie die Event-Streams von Fällen

Verwenden Sie die Amazon Connect Connect-Agentenanwendung, um:

1. Akzeptieren Sie einen Chat-Kontakt.

2. Erstellen Sie ein Kundenprofil und verknüpfen Sie es mit dem Chat-Kontakt.

3. Erstellen Sie einen Fall.

   Anmerkung

   Die Schaltfläche Kundenvorgang erstellen auf der Registerkarte Kundenvorgänge ist inaktiv, bis Sie einen Kontakt akzeptieren und diesen Kontakt einem Kundenprofil zuordnen.

Navigieren Sie zur Amazon SQS 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 Fallereignisstreams

Fallereignisstreams veröffentlichen Ereignisse jedes Mal, wenn ein Fall erstellt, ein Fall aktualisiert, ein Kontakt mit dem Fall verknüpft wird und ein Kommentar zu einem Fall hinzugefügt wird. Sie können diese Ereignisse verwenden für:

• Metriken, Analysen und Dashboards

• Entwickeln Sie Apps, die Benutzer benachrichtigen (z. B. E-Mails senden)

• Automatisierte Aktionen, die auf der Grundlage bestimmter Fallaktualisierungen ausgelöst werden

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