Übergeben Sie Kontaktattribute an einen Agenten im Contact Control Panel (CCP), wenn ein Chat beginnt - Amazon Connect
So übergeben Sie Kontaktattribute an das Kommunikations-WidgetAlternative Methode: Übergeben Sie Kontaktattribute direkt aus dem CodeausschnittWichtige Hinweise

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 Sie Kontaktattribute an einen Agenten im Contact Control Panel (CCP), wenn ein Chat beginnt

Sie können Kontaktattribute verwenden, um Informationen über den Kontakt zu erfassen, der das Kommunikations-Widget verwendet. Anschließend können Sie dem Agenten diese Informationen ü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. Konto/MitgliedIDs, Kundenkennungen wie Namen und E-Mails oder andere Metadaten, die mit einem Kontakt verknüpft sind.

So übergeben Sie Kontaktattribute an das Kommunikations-Widget

  1. Aktivieren Sie die Sicherheitseinstellungen im Kommunikations-Widget wie unter Fügen Sie Ihrer von Amazon Connect gehosteten Website eine Chat-Benutzeroberfläche hinzu 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 Web-Tokens zu generierenJSON.

  2. Fügen Sie die Kontaktattribute zur Nutzlast Ihres JWT attributes Antrags hinzu.

    Im Folgenden finden Sie ein Beispiel dafür, wie Sie in Python eine JWT mit Kontaktattributen generieren könnten:

    Anmerkung

    JWTsollte als Voraussetzung installiert werden. Um es zu installieren, führen Sie es pip install PyJWT in Ihrem Terminal aus.

    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 Einschränkungen entsprechen, die durch Folgendes festgelegt sind: StartChatConnectAPI

    • 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 Amazon Connect Standardattribute. Auf sie kann in Flows zugegriffen werden. Die Kontaktattribute müssen den Einschränkungen entsprechen, die von der festgelegt wurden StartChatConnectAPI.

Alternative Methode: Übergeben Sie Kontaktattribute direkt aus dem Codeausschnitt

Anmerkung

  • Der Snippet-Code wird allen Kontaktattributschlüsseln HostedWidget- vorangestellt, die er übergibt. Im folgenden Beispiel sieht die Agentenseite das Schlüssel-Wert-Paar. HostedWidget-foo: 'bar'

  • Diese Attribute haben zwar den Gültigkeitsbereich des HostedWidget- Präfixes, sind aber dennoch für die Client-Site veränderbar. Verwenden Sie das JWT Setup, wenn Sie unveränderliche PII oder unveränderliche Daten in Ihrem Kontaktablauf 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/>

Verwendung der Attribute in Flows

Der Flussblock „Kontaktattribute prüfen“ ermöglicht den Zugriff auf diese Attribute mithilfe des benutzerdefinierten Namespaces, wie in der folgenden Abbildung dargestellt. Sie können den Flow-Block verwenden, um Verzweigungslogik hinzuzufügen. Der vollständige Pfad ist$.Attributes.HostedWidget-attributeName.

Das Bild zeigt einen Flow-Block, der zu den Eingabeaufforderungen 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 Kodierung UTF -16 JavaScript verwendet wird, werden 2 Byte pro Zeichen verwendet, sodass die maximale Größe von etwa 3000 Zeichen betragen encoded_token sollte.

  • Das encoded_token muss an callback(data) übergeben werden. Der Codeblock authenticate benötigt keine zusätzlichen Änderungen. Beispielsweise:

    amazon_connect('authenticate', function(callback) {
  window.fetch('/token').then(res => {
    res.json().then(data => {
      callback(data.data);
    });
  });
});

  • Die Verwendung von a 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 werden nur in der kodiertJWT, 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.

    Die Seite mit den Testeinstellungen, ein Kontaktattributsschlüssel in Anführungszeichen, ein Wert in Anführungszeichen.