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.

# Übergeben von Kontaktattributen an einen Kundendienstmitarbeiter im Contact Control Panel (CCP), wenn ein Chat gestartet wird
<a name="pass-contact-attributes-chat"></a>

Sie können [Kontaktattribute](what-is-a-contact-attribute.md) verwenden, um Informationen über den Kontakt zu erfassen, der das Kommunikations-Widget verwendet. Anschließend können Sie diese Informationen dem Kundendienstmitarbeiter über das Contact Control Panel (CCP) anzeigen oder sie an anderer Stelle im Flow verwenden.

Sie können den Flow beispielsweise so anpassen, dass der Name des Kunden in Ihrer Willkommensnachricht erwähnt wird. Oder Sie können für Ihr Unternehmen spezifische Attribute verwenden, z. B. Kundenkennungen wie Namen und E-Mails oder andere Metadaten, die mit einem Kontakt verknüpft sind. account/member IDs

## So übergeben Sie Kontaktattribute an das Kommunikations-Widget
<a name="how-to-contact-attributes-chatwidget"></a>

1. Aktivieren Sie die Sicherheitseinstellungen im Kommunikations-Widget wie unter [Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website](add-chat-to-website.md) beschrieben, falls Sie dies noch nicht getan haben:

   1. Wählen Sie in Schritt 2 unter **Zusätzliche Sicherheit für Ihr Chat-Widget** die Option **Ja** aus.

   1. Verwenden Sie in Schritt 3 den Sicherheitsschlüssel, um JSON-Webtoken zu generieren.

1. Fügen Sie die Kontaktattribute der Payload Ihres JWT als Claim `attributes` hinzu.

   Im Folgenden finden Sie ein Beispiel dafür, wie Sie ein JWT mit Kontaktattributen in Python generieren könnten:
**Anmerkung**  
Voraussetzung ist, dass JWT installiert ist. Führen Sie `pip install PyJWT` in Ihrem Terminal aus, es zu installieren.

   ```
   import jwt 
   import datetime 
   CONNECT_SECRET = "{{your-securely-stored-jwt-secret}}" 
   WIDGET_ID = "widget-id" 
   JWT_EXP_DELTA_SECONDS = 500
   
   payload = { 
   'sub': WIDGET_ID, 
   'iat': datetime.datetime.utcnow(), 
   'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 
   'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } 
   header = { 'typ': "JWT", 'alg': 'HS256' } 
   encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
   ```

   In der Payload müssen Sie den Zeichenfolgeschlüssel `attributes` (unverändert, alles in Kleinbuchstaben) mit einem Objekt als Wert erstellen. Dieses Objekt muss string-to-string Schlüssel-Wert-Paare haben. Wenn in einem der Attribute etwas anderes als eine Zeichenfolge übergeben wird, kann der Chat nicht gestartet werden. 

   Die Kontaktattribute müssen den von der API festgelegten Einschränkungen entsprechen: [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes) 
   + Schlüssel müssen eine Mindestlänge von 1 haben
   + Werte können eine Mindestlänge von 0 haben

Optional können Sie die SegmentAttributes-Zeichenfolge zur [SegmentAttributeValue](https://docs.aws.amazon.com/connect/latest/APIReference/API_SegmentAttributeValue.html)Objektübersicht in der Payload hinzufügen. Bei den Attributen handelt es sich um Standardattribute. Connect Customer Auf sie kann in Abläufen zugegriffen werden. Die Kontaktattribute müssen den von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-SegmentAttributes)API festgelegten Einschränkungen entsprechen.

## Alternative Methode: Übergeben von Kontaktattributen direkt aus dem Codeausschnitt
<a name="pass-attributes-directly"></a>

**Anmerkung**  
Der Ausschnittcode stellt allen Kontaktattributschlüsseln `HostedWidget-` voran, die er übergibt. Im folgenden Beispiel wird dem Kundendienstmitarbeiter das Schlüssel-Wert-Paar `HostedWidget-foo: 'bar'` angezeigt.
Diese Attribute haben zwar den Gültigkeitsbereich des Präfixes `HostedWidget-`, sind aber dennoch clientseitig veränderbar. Verwenden Sie das JWT-Setup, wenn Sie PII oder unveränderliche Daten in Ihrem Ablauf benötigen. 

Das folgende Beispiel zeigt, wie Kontaktattribute direkt aus dem Codeausschnitt übergeben werden, ohne die Widget-Sicherheit zu aktivieren. 

```
<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', '{{widgetId}}');
  amazon_connect('snippetId', '{{snippetId}}');
  amazon_connect('styles', /* ... */);
  // ...

  amazon_connect('contactAttributes', {
   {{foo}}: '{{bar}}'
  })
<script/>
```

### Verwenden der Attribute in Abläufen
<a name="contact-flow-usage-chat"></a>

Der Ablaufblock [Kontaktattribute prüfen](check-contact-attributes.md) ermöglicht den Zugriff auf diese Attribute mithilfe des Namespace **Benutzerdefiniert**, wie in der folgenden Abbildung dargestellt. Sie können den Ablaufblock verwenden, um Verzweigungslogik hinzuzufügen. Der vollständige Pfad lautet `$.Attributes.HostedWidget-{{attributeName}}`.

![Die Abbildung zeigt einen Ablaufblock, der zu den Prompts „Gültig“ und „Ungültig“ verzweigt.](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/flow-check-contact-attrib.png)


## Wichtige Hinweise
<a name="contact-attributes-chatwidget-important-notes"></a>
+ Das Kommunikations-Widget hat ein Limit von 6144 Byte für das gesamte codierte Token. Da die UTF-16-Kodierung JavaScript verwendet wird, werden 2 Byte pro Zeichen verwendet, sodass die maximale Größe bei etwa 3000 Zeichen liegen `encoded_token` sollte.
+ Das encoded\_token muss an `callback(data)` übergeben werden. Der Codeblock `authenticate` benötigt keine zusätzlichen Änderungen. Beispiel:

  ```
  amazon_connect('authenticate', function(callback) {
    window.fetch('/token').then(res => {
      res.json().then(data => {
        callback(data.data);
      });
    });
  });
  ```
+ Die Verwendung eines JWT zur Weitergabe von Kontaktattributen gewährleistet die Integrität der Daten. Wenn Sie das gemeinsame Geheimnis schützen und angemessene Sicherheitsmaßnahmen einhalten, schützen Sie die Daten vor Manipulation durch böswillige Akteure.
+ Kontaktattribute sind im JWT nur kodiert, nicht verschlüsselt, sodass es möglich ist, die Attribute zu dekodieren und zu lesen.
+ Wenn Sie die Chat-Umgebung mit der [simulierten Chat-Umgebung](chat-testing.md#test-chat) testen und Kontaktattribute einbeziehen möchten, müssen Sie sowohl den Schlüssel als auch den Wert in Anführungszeichen setzen, wie in der folgenden Abbildung dargestellt.  
![Die Seite mit den Testeinstellungen, ein Kontaktattributsschlüssel in Anführungszeichen, ein Wert in Anführungszeichen.](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/test-chat-contact-attributes.png)