Flow-Block: „Kontaktattribute festlegen“

Beschreibung

Speichert Schlüssel-Wert-Paare als Kontaktattribute. Sie legen einen Wert fest, auf den später in einem Flow verwiesen wird.

Erstellen Sie beispielsweise eine personalisierte Begrüßung für Kunden, die je nach Art des Kundenkontos an eine Warteschlange weitergeleitet werden. Sie können auch ein Attribut für einen Firmennamen oder eine Branche definieren, das in den Text-to-Speech-Zeichenfolgen enthalten ist, die einem Kunden mitgeteilt werden.

Der Block Kontaktattribute festlegen ist nützlich, um beispielsweise Attribute aus externen Quellen in benutzerdefinierte Attribute einzukopieren.

Weitere Informationen zu Kontaktattributen finden Sie unter Amazon Connect-Kontaktattribute verwenden.

Unterstützte Kanäle

In der folgenden Tabelle sind die Block-Weiterleitungsoptionen für einen Kontakt im vorgegebenen Kanal aufgeführt.

Kanal	Unterstützt?
Stimme	Ja
Chat	Ja
Aufgabe	Ja

Flow-Typen

Sie können diesen Block in den folgenden Flow-Typen verwendet:

• Alle Flows

Eigenschaften

In der folgenden Abbildung sehen Sie die Seite Eigenschaften des Blocks Kontaktattribute festlegen. Es ist so konfiguriert, dass ein benutzerdefiniertes Attribut für Aktueller Kontakt mit dem Schlüssel GreetingPlayed und dem Wert true festgelegt wird.

Sie können folgende Attribute festlegen:

• Aktueller Kontakt: Die Attribute werden für den Kontakt festgelegt, für den dieser Flow ausgeführt wird. Auf die Attribute kann in anderen Bereichen von Amazon Connect zugegriffen werden, z. B. in anderen Flows, Modulen, Lambdas, Kontaktdatensätzen und der GetMetricData V2-API.

• Verwandter Kontakt: Die Attribute sind einem neuen Kontakt zugeordnet, der eine Kopie der ursprünglichen Kontakteigenschaften enthält.

  Im Kontaktdatensatz ist dies die RelatedContact ID.

• Flow: Die Attribute sind auf den Flow beschränkt, in dem sie konfiguriert sind.

  Flow-Attribute sind hilfreich, wenn Daten nicht für den gesamten Kontakt beibehalten werden sollen (z. B. wenn Sie vertrauliche Informationen wie die Kreditkartennummer des Kunden für einen Lambda-Datendip verwenden müssen).

  • Flow-Attribute sind temporäre Variablen, die lokal gespeichert und nur im Flow verwendet werden. Sie sind außerhalb des Flows nicht sichtbar, auch dann nicht, wenn der Kontakt in einen anderen Flow übertragen wird.

  • Sie können bis zu 32 KB groß sein (die maximale Größe des Abschnitts mit den Attributen des Kontaktdatensatzes).

  • Sie werden nicht an ein Lambda übergeben, es sei denn, sie sind explizit als Parameter konfiguriert: Wählen Sie im Block Aufrufen der AWS -Lambda-Funktion die Option Parameter hinzufügen aus.

  • Diese werden nicht an Module weitergegeben. Sie können ein Flow-Attribut innerhalb eines Moduls festlegen, es wird jedoch nicht vom Modul weitergegeben.

  • Sie erscheinen nicht im Kontaktdatensatz.

  • Sie werden auch nicht dem Kundendienstmitarbeiter im CCP angezeigt.

  • Die GetContactAttributes-API kann sie nicht offenbaren.

  • Wenn Sie die Protokollierung für den Flow aktiviert haben, erscheinen der Schlüssel und der Wert im Cloudwatch-Protokoll.

So verweisen Sie auf Attribute

• Die JSON-Syntax der einzelnen Attribute finden Sie unter Liste der verfügbaren Kontaktattribute und ihrer JSONPath-Referenz.

• Für Verweise auf Attribute mit Sonderzeichen im Namen, z. B. Leerzeichen, eckige Klammern und einfache Anführungszeichen um den Attributnamen. Zum Beispiel: $.Attributes.['user attribute name'].

• Um auf Attribute im gleichen Namespace zu verweisen, z. B. ein Systemattribut, verwenden Sie den Attributnamen oder den Namen, den Sie als Destination key (Zielschlüssel) angegeben haben.

• Um auf Werte in einem anderen Namespace zu verweisen, z. B. auf ein externes Attribut, geben Sie die JSONPath-Syntax für das Attribut an.

• Wenn Sie Kontaktattribute für den Zugriff auf andere Ressourcen verwenden möchten, legen Sie ein benutzerdefiniertes Attribut in Ihrem Flow fest und verwenden Sie als Wert für das Attribut den Amazon-Ressourcennamen (ARN) der Ressource, auf die Sie zugreifen möchten.

Beispiele für Lambda

• Verwenden Sie $.External, um aus einer Lambda-Funktionssuche auf einen Kundennamen zu verweisen. AttributeKey, AttributeKey ersetzt durch den Schlüssel (oder Namen) des von der Lambda-Funktion zurückgegebenen Attributs.

• Wenn Sie einen Amazon-Connect-Prompt in einer Lambda-Funktion verwenden möchten, legen Sie für den Prompt ein benutzerdefiniertes Attribut für den ARN fest, und greifen dann über die Lambda-Funktion auf dieses Attribut zu.

Amazon-Lex-Beispiele

• Um auf ein Attribut von einem Amazon Lex Lex-Bot zu verweisen, verwenden Sie das Format $.Lex. und fügen dann den Teil des Amazon Lex Lex-Bot hinzu, auf den verwiesen werden soll, z. B. $.Lex. IntentName.

• Wenn Sie auf die Kundeneingabe an einem Bot-Slot von Amazon Lex verweisen möchten, verwenden Sie „$.Lex.Slots.slotName“,und ersetzen slotName durch den Namen des Slots im Bot.

Was passiert, wenn Attribute 32 KB überschreiten

Attribute können bis zu 32 KB groß sein. Dies ist die maximale Größe des Abschnitts mit den Attributen von Kontaktdatensätzen. Wenn die Attribute für einen Kontakt 32 KB überschreiten, wird der Kontakt in den Fehlerzweig weitergeleitet. Ziehen Sie zur Risikominderung die folgenden Optionen in Betracht:

• Entfernen Sie unnötige Attribute, indem Sie ihre Werte auf leer setzen.

• Wenn die Attribute nur in einem Flow verwendet werden und nicht außerhalb dieses Flows referenziert werden müssen (z. B. durch ein Lambda oder einen anderen Flow), verwenden Sie Flow-Attribute. Auf diese Weise müssen Sie die 32 KB an Informationen nicht unnötig von einem Fluss in einen anderen übertragen.

Konfigurationstipps

• Wenn Sie einen benutzerdefinierten Zielschlüssel verwenden, können Sie ihn beliebig benennen, jedoch dürfen die Zeichen $ und . (Punkt) nicht darin vorkommen. Beide Zeichen werden zur Festlegung der Attributpfade in JSONPath verwendet.

• Sie können den Block Kontaktattribut festlegen verwenden, um das erforderliche Sprachattribut für einen Amazon-Lex-V2-Bot festzulegen. (Ihr Sprachattribut in Amazon Connect muss dem Sprachmodell entsprechen, mit dem Ihr Amazon-Lex-V2-Bot erstellt wurde.) In der folgenden Abbildung sehen Sie ein Sprachattribut, das auf „Spanisch“ festgelegt ist.

  

  Sie können den Stimme festlegen-Block verwenden, um das erforderliche Sprachattribut für einen Amazon-Lex-V2-Bot festzulegen.

Weitere Informationen zur Verwendung von Kontaktattributen finden Sie unter Amazon Connect-Kontaktattribute verwenden.

Konfigurierter Block

In der folgenden Abbildung sehen Sie ein Beispiel eines konfigurierten Blocks. Er hat zwei Verzweigungen: Erfolg und Fehler.

Beispiel-Flows

Amazon Connect enthält eine Reihe von Beispiel-Flows. Anweisungen, dafür, wie Sie im Flow Designer auf Beispiel-Flows zugreifen können, finden Sie unter StichprobenFlows. Im Folgenden finden Sie Themen, in denen die Beispiel-Flows beschrieben werden, die diesen Block beinhalten.

• Beispiel für den Flow bei eingehenden Anrufen (Erstkontakterfahrung)

Szenarien

In diesen Themen finden Sie Szenarien, die diesen Block verwenden:

• Referenzieren von Kontaktattributen