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.

Ereignisse im Zusammenhang mit Kundenkontakten

Mit Connect Customer können Sie nahezu in Echtzeit einen Stream von Kontaktereignissen (Sprachanrufe, Chat, Aufgaben und E-Mail) in Ihrem Connect Customer Contact Center abonnieren (z. B. ein Anruf befindet sich in einer Warteschlange).

Mithilfe von Kontaktereignissen können Analytik-Dashboards zur Überwachung und Nachverfolgung von Kontaktaktivitäten erstellt, für ein besseres Verständnis der Contact Centerperformance in Workforce Management (WFM)-Lösungen integriert, oder mit Anwendungen bereichert werden, die in Echtzeit auf Ereignisse reagieren (z. B. „Verbindung unterbrochen“).

Datenmodell für Kontaktereignisse

Kontaktereignisse werden in JSON generiert. Für jeden Ereignistyp wird ein JSON-Blob entsprechend Ihrer Regelkonfigurierung an das Ziel Ihrer Wahl gesendet. Die folgenden Kontaktereignisse sind verfügbar:

AgentInfo

Das AgentInfo-Objekt enthält die folgenden Eigenschaften:

AttributeCondition

Ein Objekt zur Angabe der vordefinierten Attributbedingung.

Kampagne

Informationen im Zusammenhang mit einer Kampagne.

Typ: Kampagnen-Objekt

Kontaktereignis

Das Contact-Objekt enthält die folgenden Eigenschaften:

CustomerVoiceActivity

Das CustomerVoiceActivity-Objekt enthält die folgenden Eigenschaften:

Ablauf

Ein Objekt zur Angabe des Ablaufs eines Routing-Schritts.

Expression

Eine mit Tags versehene Union zur Angabe eines Ausdrucks für einen Routing-Schritt.

GlobalResiliencyMetadata

Informationen zur globalen Resilienzkonfiguration für den Kontakt, einschließlich Einzelheiten zur Verteilung des Datenverkehrs.

QueueInfo

Das QueueInfo-Objekt enthält die folgenden Eigenschaften:

RoutingCriteria

Liste der Weiterleitungskriterien. Jedes Mal, wenn die Weiterleitungskriterien für einen Kontakt aktualisiert werden, wird er dieser Liste hinzugefügt.

Schritte

Wenn Amazon Connect für eine bestimmte Schrittdauer keinen verfügbaren Kundendienstmitarbeiter findet, der die Anforderungen in einem Schritt erfüllt, gehen die Weiterleitungskriterien nacheinander zum nächsten Schritt über, bis eine Verbindung mit einem Kundendienstmitarbeiter abgeschlossen ist. Wenn alle Schritte abgeschlossen sind, wird der Kontakt einem beliebigen Kundendienstmitarbeiter in der Warteschlange angeboten.

SystemEndpoint

Der System-Endpunkt. Bei INBOUND ist dies beispielsweise die Telefonnummer, die der Kunde gewählt hat, oder die E-Mail-Adresse, an die sich der Kunde gewandt hat. Für OUTBOUND und EXTERNAL_OUTBOUND ist dies die ausgehende Anrufer-ID-Nummer, die der ausgehenden Warteschlange zugewiesen ist, über die der Kunde angerufen wird, oder die ausgehende E-Mail-Adresse, die der ausgehenden Warteschlange zugewiesen ist, über die der Kunde erreicht wird.

Endpoint

Informationen zu einem Endpunkt. In Amazon Connect ist ein Endpunkt das Ziel für einen Kontakt, z. B. eine Kunden-Telefonnummer oder eine Telefonnummer für Ihr Contact Center.

Aufnahmen

Wenn die Aufzeichnung aktiviert wurde, handelt es sich um Informationen über die Aufzeichnungen.

RecordingsInfo

Informationen über eine Sprachaufnahme, ein Chatprotokoll oder eine Bildschirmaufnahme.

ContactDetails

Ist eine Zuweisung mit Schlüssel-Wert-Paaren als Zeichenfolge, die benutzerdefinierte Attribute enthält, die innerhalb des Kontakts leicht eingegeben werden. Dieses Objekt wird nur für Aufgabenkontakte verwendet.

ContactEvaluations

Informationen über die Kontaktbewertungen, bei denen der Schlüssel der ist FormId — eine eindeutige Kennung für das Formular.

ContactEvaluation

StateTransitions

Liste von StateTransition für einen Supervisor.

StateTransition

Informationen über die Statusübergänge eines Supervisoren

OutboundStrategy

Informationen zur Outbound-Strategie

Typ: OutboundStrategy Objekt

Kontakt-Zeitstempel

ChatContactMetrics

Informationen über die gesamten Interaktionen der Teilnehmer auf Kontaktebene

ParticipantMetrics

Informationen über Interaktionen eines Teilnehmers in einem Kontakt

Abonnieren Sie die Kontaktveranstaltungen für Connect-Kunden

Connect-Kundenkontaktereignisse werden mit Amazon EventBridge veröffentlicht und können in wenigen Schritten für Ihre Connect Customer-Instanz in der EventBridge Amazon-Konsole aktiviert werden, indem Sie eine neue Regel erstellen. Ereignisse sind zwar nicht sortiert, haben aber einen Zeitstempel, den Sie verwenden können, um die Daten zu verarbeiten.

Ereignisse werden auf bestmögliche Weise ausgegeben.

Um Kontaktereignisse von Connect Customer zu abonnieren:

Weitere Informationen zur Konfiguration von Regeln finden Sie unter EventBridge Amazon-Regeln im EventBridge Amazon-Benutzerhandbuch.

Beispiel für das Beenden des Streamings eines Ereignistyps

Das folgende Beispiel zeigt, wie Sie das Streamen eines CONTACT_DATA_UPDATED Ereignisses von Connect Customer an beenden EventBridge.

{
  "source": [
    "aws.connect"
  ],
  "detail-type": [
    "Amazon Connect Contact Event"
  ],
  "detail": {
    "eventType": [
      {
        "anything-but": [
          "CONTACT_DATA_UPDATED"
        ]
      }
    ]
  }
} 

Beispiel für ein Kontaktereignis, wenn ein Sprachanruf mit einem Kundendienstmitarbeiter verbunden wird

{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "contactId":"11111111-1111-1111-1111-111111111111",
        "channel":"VOICE",
        "instanceArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"INBOUND",
        "eventType":"CONNECTED_TO_AGENT",
        "agentInfo":{
          "agentArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
          "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
          "hierarchyGroups": { 
                         "level1": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a"
                        },
                        "level2": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b"
                        },
                        "level3": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c"
                        },
                        "level4": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d"
                        },
                        "level5": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e"
                        }
                 } 
            }
        },   
         "queueInfo": {  
            "queueType":"type",
            "queueArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2021-08-04T17:29:04.000Z"
          },
         "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
         } 
    }
}

Beispiel eines Kontaktereignisses, wenn ein Sprachanruf unterbrochen wird

Das folgende Beispielereignis zeigt einen Kontakt, der über einen benutzerdefinierten Tag mit Dept als Schlüssel verfügt. Beachten Sie, dass dies queueInfo nicht in Ereignissen enthalten initiationMethod ist, die EventBridge bis wann eingehenOUTBOUND.

{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Connect Customer Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType": "DISCONNECTED",
        "contactId": "11111111-1111-1111-1111-111111111111",
        "initialContactId": "11111111-2222-3333-4444-555555555555",
        "previousContactId": "11111111-2222-3333-4444-555555555555",
        "channel": "Voice",
        "instanceArn": "arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod": "OUTBOUND",
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "connectedToSystemTimestamp":"2021-08-04T17:17:55.000Z",
        "disconnectTimestamp":"2021-08-04T17:18:37.000Z",
        "agentInfo": {
            "agentArn": "arn",
            "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
            "hierarchyGroups": { 
                 "level1": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a"
                },
                "level2": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b"
                },
                "level3": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c"
                },
                "level4": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d"
                },
                "level5": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e"
                }
            } 
        },
           
        "CustomerVoiceActivity": {
           "greetingStartTimestamp":"2021-08-04T17:29:20.000Z",
           "greetingEndTimestamp":"2021-08-04T17:29:22.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890",
            "Dept":"Finance"
        }
    }
}

Beispiel eines Ereignisses, wenn die Kontakteigenschaften aktualisiert werden

{
"version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
"detail": {
    "eventType": "CONTACT_DATA_UPDATED",
    "contactId": "the contact ID",
    "channel": "CHAT",
    "instanceArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID",
    "initiationMethod": "API",
    "queueInfo": {
        "queueArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/queue/the queue ID",
        "enqueueTimestamp": "2023-10-24T02:39:15.240Z",
        "queueType": "STANDARD"
    },
    "agentInfo": {
        "agentArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent/the agent ID",
        "connectedToAgentTimestamp": "1970-01-01T00:00:00.001Z",
        "hierarchyGroups": {
            "level1": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level2": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level3": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level4": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            }
        }
    },
    "updatedProperties": ["ContactLens.ConversationalAnalytics.Configuration"],
    "initiationTimestamp": "2023-10-24T02:39:15.154Z",
    "connectedToSystemTimestamp": "1970-01-01T00:00:00.001Z",
    "tags": {
        "aws:connect:instanceId": "the instance ID"
       },
    "contactLens": {
        "conversationalAnalytics": {
            "configuration": {
                "enabled": true,
                "channelConfiguration": {
                    "analyticsModes": ["PostContact"]
                },
                "languageLocale": "en-US",
                "redactionConfiguration": {
                    "behavior": "Enable",
                    "policy": "RedactedAndOriginal",
                    "entities": ["EMAIL"],
                    "maskMode": "EntityType"
                }
            }
        }
    }
}
}

Beispiel für ein Kontaktereignis, wenn ein Sprachanruf mit einem Kundendienstmitarbeiter verbunden wird

{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "OrExpression": [{
                       "AttributeCondition": {
                           "Name": "Technology",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 2.0,
                           "Value": "AWS Kinesis"
                       }
                    },
                    {
                       "AttributeCondition": {
                           "Name": "Language",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 4.0,
                           "Value": "English"
                        }
                    }],
                    "AndExpression": [{
                        "AttributeCondition": {
                            "Name": "Language",
                            "ComparisonOperator": "NumberGreaterOrEqualTo",
                            "ProficiencyLevel": 2.0,
                            "Value": "Spanish"
                        }
                    }]
                }
            }]
        }]
    }
}              
        

Beispielereignis für den Fall, dass der Routing-Schritt für einen Kontakt abläuft

{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType":"CONTACT_DATA_UPDATED",
        "contactId":"12345678-1234-1234-1234-123456789012",
        "channel":"CHAT",
        "instanceArn":"arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"API",
        "queueInfo":{
            "queueArn":"arn:aws:connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2023-11-01T18:33:03.062Z",
            "queueType":"STANDARD"
        },
        "updatedProperties":["RoutingCriteria.Step.Status"],
        "initiationTimestamp":"2023-11-01T18:33:00.716Z",
        "connectedToSystemTimestamp":"2023-11-01T18:33:01.736Z",
        "tags":{
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012"
        },
        "routingCriteria":{
            "steps":[{
                "expiry":{
                    "durationInSeconds":50,
                    "expiryTimestamp":"2023-11-01T18:34:54.275Z"
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Location",
                        "value":"AZ",
                        "proficiencyLevel":3.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"EXPIRED"
            },
            {
                "expiry":{
                    "durationInSeconds":10
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":4.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"ACTIVE"
            },
            {
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":1.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"INACTIVE"
            }],
            "activationTimestamp":"2023-11-01T18:34:04.275Z",
            "index":1
        }
    }
}           
        

Beispiel für ein Kontaktereignis, wenn ein Sprachanruf anhand von Weiterleitungskriterien mit einem Kundendienstmitarbeiter, der vom Kunden angegeben wurde, verbunden wird

{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "AttributeCondition": {
                        "ComparisonOperator": "Match",
                        "MatchCriteria": {
                            "AgentsCriteria": {
                                "AgentIds": ["AGENT_1"]
                            }
                        }
                    }
                }
            }]
        }]
    }
}