So übergeben Sie Kontaktattribute an das Kommunikations-Widget Alternative Methode: Übergeben von Kontaktattributen direkt aus dem Codeausschnitt Wichtige Hinweise

Übergeben von Kontaktattributen an einen Kundendienstmitarbeiter im Contact Control Panel (CCP), wenn ein Chat gestartet wird

Sie können Kontaktattribute 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

Aktivieren Sie die Sicherheitseinstellungen im Kommunikations-Widget wie unter Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website 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.
2. Verwenden Sie in Schritt 3 den Sicherheitsschlüssel, um JSON-Webtoken zu generieren.
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
- 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 SegmentAttributeValueObjektübersicht in der Payload hinzufügen. Bei den Attributen handelt es sich um Standardattribute. Amazon Connect Auf sie kann in Abläufen zugegriffen werden. Die Kontaktattribute müssen den von der StartChatContactAPI festgelegten Einschränkungen entsprechen.

Alternative Methode: Übergeben von Kontaktattributen direkt aus dem Codeausschnitt

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

Der Ablaufblock Kontaktattribute prüfen 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.

Wichtige Hinweise

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 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.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Übergeben des Anzeigenamens des Kunden

Zusätzliche Anpassungen für Ihr Chat-Widget