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.
# Erstellen von Konversations-KI-Bots in Amazon Connect
Sie können die Amazon Connect Admin-Website verwenden, um Konversations-KI-Bots für interaktive Sprachantwort (IVR) und Chatbot-Self-Service-Erlebnisse zu erstellen, zu bearbeiten und kontinuierlich zu verbessern. Die Bots basieren auf Amazon Lex.
Mithilfe der Amazon Connect Admin-Website können Sie dynamische, dialogorientierte KI-Erlebnisse bereitstellen, um die Absicht Ihrer Kunden zu verstehen, Folgefragen zu stellen und die Lösung ihrer Probleme zu automatisieren. In den Themen in diesem Abschnitt wird erklärt, wie Sie die Bot-Erstellung auf der Amazon Connect Admin-Website aktivieren und wie Sie Ihren Bot erstellen.
**Topics**
+ [Aktivieren von Bots und Analysen in Amazon Connect](enable-bot-building.md)
+ [Erstellen eines Bots](work-bot-building-experience.md)
+ [Erstellen eines Ablaufs und Hinzufügen Ihres KI-Konversations-Bots](create-bot-flow.md)
+ [Konfigurieren Sie Sprachanbieter von Drittanbietern](configure-third-party-speech-providers.md)
+ [Erstellen Sie eine Absicht für Connect AI-Agenten](create-qic-intent-connect.md)
+ [Erstellen von Bot-Versionen und -Aliassen](create-bot-version.md)
+ [Bewerten der Leistung Ihres Konversations-KI-Bots](lex-bot-analytics.md)
+ [Bot-Metriken und -Analytik](bot-metrics.md)
+ [Erweiterte Bot-Konfiguration](bot-advanced-config.md)
+ [Einen Amazon-Lex-Bot hinzufügen](amazon-lex.md)
# Aktivieren von Bot-Erstellung und -Analysen in Amazon Connect
Gehen Sie wie folgt vor, damit Benutzer Amazon Lex-Bots auf der Amazon Connect Admin-Website erstellen und Messwerte zur Bot-Leistung einsehen können.
Benutzer können in Amazon Connect keine LEX-V1-Bots oder regionsübergreifenden Bots bearbeiten.
1. Verwenden Sie die [Amazon Connect console](https://console.aws.amazon.com/connect/).
1. Wählen Sie die Amazon-Connect-Instance aus, die Sie in Ihren Amazon-Lex-Bot integrieren möchten.
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)
1. Wählen Sie im Navigationsmenü **Flows**.
1. Wählen Sie **Lex Bot Management in Amazon Connect aktivieren** und **Bot-Analysen und -Transkripte in Amazon Connect aktivieren** und dann **Speichern** aus.
![\[Die Amazon-Lex-Bots-Seite mit den Optionen zur Aktivierung der Lex-Bot-Verwaltung und -Analyse in Amazon Connect.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-bot-service-linked-role.png)
**Anmerkung**
Wenn Sie bereits über bestehende Service-Kontrollrichtlinien (SCP) verfügen, die den Zugriff auf Lex blockieren, respektiert Amazon Connect diese Richtlinien und aktiviert das Feature für Bot-Verwaltung und -Analysen nicht. Wenn Sie diese SCP jedoch erst einführen, nachdem Sie das Feature bereits aktiviert haben, werden sie nicht eingehalten. In diesem Fall müssen Sie das Feature deaktivieren.
Amazon Connect zeigt die verwendete Servicerolle und den Namen der serviceverknüpften Rolle an. Außerdem werden ressourcenbasierte Amazon-Lex-Richtlinien verwendet, um Aufrufe an den Amazon-Lex-Bot zu tätigen. Wenn Sie Ihrer Amazon-Connect-Instance einen Amazon-Lex-Bot zuordnen, wird die ressourcenbasierte Richtlinie für den Bot aktualisiert, sodass Amazon Connect die Erlaubnis erhält, den Bot aufzurufen.
Weitere Informationen zu ressourcenbasierten Richtlinien von Amazon Lex finden Sie unter [Ressourcenbasierte Richtlinien in Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies) im *Entwicklerhandbuch zu Amazon Lex V2*.
1. Weisen Sie Benutzern, die Bots und Bot-Analysen erstellen und verwalten müssen, die folgenden Sicherheitsprofilberechtigungen zu:
+ **Kanäle und Abläufe** – **Bots** – **Anzeigen**, **Bearbeiten**, **Erstellen**
+ Berechtigung **Analytik und Optimierung** – **Verlaufsmetriken** – **Zugriff**
# Erstellen Sie einen Bot mithilfe der Amazon Connect Admin-Website
Sie können komplette Lex-Bots auf der Amazon Connect Admin-Website erstellen, ohne jemals die Amazon Connect Connect-Oberfläche verlassen zu müssen. Für das Erstellen oder Bearbeiten von Bots in Amazon Connect fallen keine Gebühren an. Stattdessen wird Ihnen die Nutzung von Amazon Lex in Rechnung gestellt. Informationen zur Preisgestaltung finden Sie auf der [Preisseite für Amazon Lex](https://aws.amazon.com/lex/pricing/).
**So erstellen Sie einen Bot**
1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*instance name*.my.connect.aws/ an. Verwenden Sie ein Administratorkonto oder ein Konto, dessen Sicherheitsprofil über die Berechtigung **Kanäle und Abläufe** – **Bots** – **Erstellen** verfügt.
1. Wählen Sie im Navigationsmenü **Weiterleitung**, **Flows** aus.
1. Wählen Sie auf der Seite **Abläufe** die Option **Bots** und dann **Bot erstellen** aus.
![\[Die Seite „Abläufe“, die Registerkarte „Bots“ und die Schaltfläche „Bot erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/flows-bots-tab.png)
1. Geben Sie im Dialogfeld **Details** folgende Informationen ein:
+ **Botname**: Geben Sie einen eindeutigen Namen für den Bot ein.
+ **Beschreibung** (Optional): Geben Sie zusätzliche Informationen zum Zweck des Bots an.
+ **Gesetz zum Schutz der Privatsphäre von Kindern im Internet**: Wählen Sie, ob für den Bot der Child Online Privacy Protection Act (COPPA) gilt.
Die folgende Abbildung zeigt das Dialogfeld **Details** und diese Optionen.
![\[Detailseite zur Bot-Erstellung mit Name, Beschreibung und COPPA-Einstellungen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-create.png)
1. Wählen Sie **Erstellen** aus. Nachdem der Bot erstellt wurde, werden Sie zur Bot-Konfigurationsseite weitergeleitet. Das folgende Bild zeigt eine Beispielseite für einen neu erstellten Bot mit dem Namen. **HotelBookingBot**
![\[Eine Beispielkonfigurationsseite für einen nicht konfigurierten Bot.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/hotelbookingbot.png)
1. Wählen Sie auf der Bot-Konfigurationsseite die Option **Sprache hinzufügen** aus. Wählen Sie die Hauptsprache für Ihren Bot und Ihre bevorzugte Methode zur Erstellung dieser Sprache aus.
![\[Beispielseite „Ihren Bot definieren“ mit Dropdown-Feld „Sprache hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-language-create.png)
1. Nachdem Sie Ihre Sprache ausgewählt haben, werden Sie zum Abschnitt **Ihren Bot definieren** weitergeleitet. Die folgende Abbildung zeigt ein Beispiel für diesen Abschnitt. In diesem Abschnitt fügen Sie Absichten hinzu.
![\[Beispiel für den Abschnitt „Ihren Bot definieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/define-bot-page.png)
## Hinzufügen von Absichten zu Ihrem Bot
Im Abschnitt **Ihren Bot definieren** fügen Sie Absichten hinzu. Absichten sind die Ziele, die Ihre Benutzer erreichen möchten, z. B. Blumen bestellen oder ein Hotel buchen.
Ihr Bot muss mindestens über eine Absicht verfügen. Es gibt zwei Arten von Absichten:
+ Benutzerdefinierte Absichten: Sie erstellen Absichten, die die Aktionen oder Anfragen darstellen, die Ihr Bot bearbeiten soll. In diesem Thema wird erläutert, wie Sie benutzerdefinierte Absichten erstellen.
+ Integrierte Absichten: Standardmäßig enthalten alle Bots eine integrierte Absicht, die Fallback-Absicht. Diese Absicht wird verwendet, wenn der Bot keine andere Absicht erkennt. Wenn ein Benutzer beispielsweise bei einer Hotelbuchungsabsicht „Ich möchte Blumen bestellen“ sagt, wird die Fallback-Absicht ausgelöst. Die folgende Abbildung zeigt ein Beispiel für eine integrierte Absicht.
![\[Das Dialogfeld Integrierte Absicht verwenden, eine integrierte Absicht namens AMAZON. HelpIntent.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/built-in-intent.png)
**So erstellen Sie eine benutzerdefinierte Absicht.**
1. Wählen Sie **Absicht hinzufügen** und dann **Leere Absicht hinzufügen** aus.
1. Geben Sie im Dialogfeld **Absicht hinzufügen** einen Namen für Ihre Absicht und eine für Sie aussagekräftige Beschreibung ein. Wählen Sie **Hinzufügen** aus.
1. Geben Sie die folgenden Informationen ein, um Ihre Absicht zu konfigurieren:
+ Fügen Sie Beispiele für **Äußerungen** hinzu: Wählen Sie **Hinzufügen** aus und geben Sie dann Formulierungen oder Fragen ein, mit denen Benutzer diese Absicht zum Ausdruck bringen könnten. Wählen Sie **Speichern**.
+ Konfigurieren Sie **Slots**: Wählen Sie **Hinzufügen** aus und definieren Sie dann die Slots (Parameter), die zur Erfüllung der Absicht erforderlich sind. Jeder Slot hat einen Typ, der die Werte definiert, die in den Slot eingegeben werden können. Wählen Sie **Hinzufügen** aus, um den Slot hinzuzufügen. Wenn Sie alle Slots hinzugefügt haben, wählen Sie **Speichern** aus.
+ Erstellen Sie **Prompts**: Wählen Sie **Bearbeiten** aus und geben Sie dann Prompts ein, anhand derer der Bot nach Informationen fragt oder Benutzereingaben verdeutlicht. Wenn Sie fertig sind, wählen Sie **Speichern** aus.
+ **Erste Antwortnachricht**: Die erste Nachricht, die an den Benutzer gesendet wird, nachdem die Absicht aufgerufen wurde. Sie können Antworten angeben, Werte initialisieren und den nächsten Schritt definieren, den der Bot ausführt, um dem Benutzer zu Beginn der Absicht zu antworten.
+ **Bestätigungsprompt und Antworten**: Diese werden verwendet, um die Erfüllung der Absicht zu bestätigen oder abzulehnen. Im Bestätigungsprompt wird der Benutzer aufgefordert, die Slot-Werte zu überprüfen, z. B. „Ich habe für Freitag ein Hotelzimmer gebucht. Ist das richtig?“. Die Ablehnungsantwort wird an den Benutzer gesendet, wenn er die Bestätigung ablehnt.
+ **Abschließende Antwortnachricht**: Dies ist die Antwort, die an den Benutzer gesendet wird, nachdem die Absicht erfüllt wurde und alle anderen Nachrichten wiedergegeben wurden, z. B. „Danke, dass Sie ein Hotelzimmer gebucht haben.“.
Weitere Informationen zu Intents for Amazon Lex Bots, Intents und erweiterten Konfigurationen finden Sie unter [Adding Intents](https://docs.aws.amazon.com/lexv2/latest/dg/add-intents.html) im *Amazon Lex V2* Developer Guide.
# Erstellen eines Ablaufs und Hinzufügen Ihres KI-Konversations-Bots
In diesem Thema wird erläutert, wie Sie einen zuvor erstellten KI-Konversations-Bot zu einem Ablauf hinzufügen.
1. Wählen Sie im Navigationsmenü in Amazon Connect **Weiterleitung**, **Abläufe**, **Ablauf erstellen** aus und geben Sie einen Namen für den Ablauf ein.
1. Ziehen Sie unter **Interagieren** einen [Kundeneingabe abrufen](get-customer-input.md)-Block in den Designer und verbinden Sie ihn mit dem Block **Eintrittspunkt**.
1. Wählen Sie den [Kundeneingabe abrufen](get-customer-input.md)-Block aus, um ihn zu öffnen.
1. Verwenden Sie auf der Amazon-Lex-Registerkarte die Dropdown-Menüs, um den zuvor erstellten Bot und den Alias auszuwählen, wie in der folgenden Abbildung gezeigt.
![\[Eigenschaften des Blocks „Kundeneingabe abrufen“ und Registerkarte „Amazon Lex“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/get-customer-input-lextab.png)
1. **Wählen Text-to-speech Sie unter **Kundenaufforderung oder Bot-Initialisierung unseren Chat-Text** aus.**
1. Geben Sie eine Nachricht ein, die Anrufern Informationen über mögliche Aktionen bereitstellt. Verwenden Sie z. B. eine Nachricht, die den im Bot verwendeten Absichten entspricht, wie *Um Ihren Kontostand zu überprüfen, drücken oder sagen Sie 1. Um mit einem Mitarbeiter zu sprechen, drücken oder sagen Sie 2.* Die folgende Abbildung zeigt die Seite „Eigenschaften“ des [Kundeneingabe abrufen](get-customer-input.md)-Blocks.
![\[Der Abschnitt „Kundenaufforderung oder Bot-Initialisierung“ des Blocks „Kundeneingabe abrufen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/customer-prompt-bot-initialization.png)
1. Wählen Sie unter **Absichten** die Option **Absicht hinzufügen** aus und geben Sie dann die Kundenabsichten ein, die den Bot auslösen sollen, oder suchen Sie danach.
![\[Abschnitt „Absichten“, Schaltfläche „Absicht hinzufügen“ und Schaltfläche „Suchen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/add-intent.png)
Wenn Sie nach Absichten suchen, können Sie nach dem Gebietsschema filtern. Das Gebietsschema wird nur zum Filtern verwendet, es ist nicht an das Gebietsschema gebunden, wenn der Bot ausgelöst wird. Sie können die BookHotel Absicht beispielsweise anhand des Gebietsschemas Englisch (USA) finden, aber die Absicht kann erfolgreich sowohl in Englisch (USA) als auch in Englisch (GB) zurückgegeben werden.
Weitere Informationen zum Suchen von Absichten finden Sie unter [So finden Sie Absichten](#find-notlisted-intents).
Die folgende Abbildung zeigt das Dialogfeld zum Filtern von Absichten nach Gebietsschema.
![\[Suchoption, Dialogfeld „Mithilfe des Gebietsschemas filtern, um eine Absicht hinzuzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/filter-intents.png)
1. Wählen Sie **Speichern**.
**Wichtig**
Wenn Sie einen Amazon-Lex-V2-Bot verwenden, muss Ihr Sprachattribut in Amazon Connect dem Sprachmodell entsprechen, das für die Erstellung Ihres Lex-Bot verwendet wurde. Das ist anders als Amazon Lex (Classic). Verwenden Sie den Block [Set voice](set-voice.md#set-voice-lexv2bot), um das Amazon-Connect-Sprachmodell anzugeben, oder verwenden Sie einen [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md)-Block.
## So finden Sie Absichten für Amazon-Lex-V1-Bots, regionsübergreifende Bots oder dynamisch festgelegte Bots
Das Dropdown-Feld **Absichten** listet keine Absichten für Amazon-Lex-V1-Bots, regionsübergreifende Bots oder Bots auf, bei denen der Bot-ARN dynamisch festgelegt wird. Probieren Sie bei diesen Absichten die folgenden Optionen aus, um sie zu finden.
+ Prüfen Sie, ob das **AmazonConnectEnabled**Tag auf true gesetzt ist:
1. Öffnen Sie die Amazon-Lex-Konsole, wählen Sie **Bots** aus, wählen Sie den Bot und dann **Tags** aus.
1. Wenn das **AmazonConnectEnabled**Tag nicht vorhanden ist, füge **AmazonConnectEnabled = true** hinzu.
1. Kehren Sie zur Amazon Connect Admin-Website zurück. Aktualisieren Sie den Flow-Designer, um die Auswahl im Block **Kundeneingabe abrufen** anzuzeigen.
+ Prüfen Sie, ob die Version mit dem Alias verknüpft ist:
1. Wählen Sie auf der Amazon Connect Admin-Website **Routing**, **Flows**, The Bot, **Aliases** aus. Stellen Sie sicher, dass **In Abläufen und Ablaufmodulen verwenden** aktiviert ist, wie in der folgenden Abbildung dargestellt.
![\[Registerkarte „Aliasse“ mit dem Umschalter „In Flows und Flow-Modulen verwenden“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-alias-enabled.png)
1. Aktualisieren Sie den Flow-Designer, um die Auswahl im Block **Kundeneingabe abrufen** anzuzeigen.
# Sprachanbieter von Drittanbietern in Amazon Connect konfigurieren
Sie können Drittanbieter speech-to-text (STT) und text-to-speech (TTS) in Amazon Connect konfigurieren, um die Sprachabdeckung zu erweitern, die Erkennungsgenauigkeit zu verbessern und ausdrucksstärkere synthetisierte Sprache bereitzustellen. In diesem Abschnitt wird beschrieben, wie Sie STT-Drittanbieter für Bots und TTS-Drittanbieter für die Verwendung in Kontaktabläufen konfigurieren.
**Topics**
+ [Konfigurieren Sie Drittanbieter speech-to-text (STT)](configure-third-party-stt.md)
+ [Konfigurieren Sie Drittanbieter text-to-speech (TTS)](configure-third-party-tts.md)
+ [Endpunkte und Regionen für STT-Drittanbieter](endpoints-regions-third-party-stt.md)
+ [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md)
# Konfigurieren Sie Drittanbieter speech-to-text (STT)
Verwenden Sie die folgenden Anweisungen, um einen Drittanbieter speech-to-text (STT) zu konfigurieren.
## Voraussetzungen
+ Ein Bot mit einem vorhandenen Gebietsschema.
+ Ein API-Schlüssel eines STT-Anbieters eines Drittanbieters, der in gespeichert ist. AWS Secrets Manager Weitere Informationen zum Speichern von API-Schlüsseln als Secrets in Secrets Manager finden Sie unter [Create an AWS Secrets Manager Secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html).
+ Eine Secrets Manager Manager-Ressourcenrichtlinie, die es Amazon Connect ermöglicht, das Geheimnis abzurufen. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
+ AWS KMS key Berechtigungen, die eine Entschlüsselung ermöglichen. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
+ Eine Anbietermodell-ID und ein Secrets Manager Manager-ARN.
## Schritt 1: Öffnen Sie das Konfigurationsfenster für das Sprachmodell
1. Melden Sie sich auf der Amazon Connect Connect-Admin-Website an.
1. Wählen Sie **Bots** und dann den Bot aus.
1. Wählen Sie das Gebietsschema.
1. Wählen Sie im Abschnitt **Sprachmodell** die Option **Bearbeiten** aus, um das Konfigurationsmodal zu öffnen.
![\[Die Konfigurationsseite für Ihren Konversations-AI-Bot.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/01-airlinesbot.png)
## Schritt 2: Wählen Sie den Modelltyp
Wählen Sie in der Dropdownliste **Modelltyp** die Option **Speech-to-Text** (STT) aus. Dadurch wird sichergestellt, dass das Gebietsschema für die Transkription konfiguriert ist und nicht. speech-to-speech
![\[Das Dialogfeld „Sprachmodell“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/02-speech-model.png)
## Schritt 3: Überprüfen Sie die Standardeinstellungen für das Sprachmodell
Standardmäßig ist Amazon als speech-to-text Anbieter ausgewählt. Überprüfen Sie die aktuellen Einstellungen, bevor Sie zu einem Drittanbieter wechseln.
![\[Das Sprachmodell-Dialogfeld, in dem Amazon als Sprachanbieter ausgewählt wurde.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/03-speech-model-amazon.png)
## Schritt 4: Wählen Sie einen STT-Drittanbieter
Öffnen Sie das Drop-down-Menü für **Sprachanbieter** und wählen Sie einen unterstützten Drittanbieter speech-to-text aus.
![\[Das Dialogfeld mit dem Sprachmodell, in dem Deepgram als Sprachanbieter ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/04-speech-model-deepgram.png)
## Schritt 5: Geben Sie die Modell-ID und den Secrets Manager ARN ein
1. Geben Sie **unter Modell-ID** den Modellnamen des Anbieters ein.
+ Einige Anbieter verlangen eine Mindest- oder Höchstlänge.
+ Bei Modellen wird zwischen Groß- und Kleinschreibung IDs unterschieden und sie müssen mit der Dokumentation des Anbieters übereinstimmen.
1. Geben Sie in **Secrets Manager ARN** den ARN des Secrets ein, das den Provider-API-Schlüssel enthält.
+ Der geheime Schlüssel muss sich in derselben Region wie Ihre Amazon Connect Connect-Instance befinden.
+ Secrets Manager- und KMS-Schlüsselrichtlinien müssen Amazon Connect erlauben, auf den Schlüssel zuzugreifen und ihn zu entschlüsseln. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern.
## Erstellen und aktivieren Sie das Gebietsschema
**Wenn das Gebietsschema **Unbuilt changes** anzeigt, wählen Sie Build language aus.** Die neuen STT-Einstellungen werden nach einem erfolgreichen Build aktiv.
## Laufzeitverhalten (STT)
+ Amazon Connect leitet Audio an den ausgewählten speech-to-text Drittanbieter weiter.
+ Es sind keine Änderungen an Flows oder Lambda-Funktionen erforderlich.
+ Fehler wie ungültige Anmeldeinformationen oder ein ungültiges Modell IDs werden in den Protokollen angezeigt.
+ Metriken und Analysen funktionieren weiterhin normal.
## Fehlerbehebung (STT)
+ **Ungültige Modell-ID**: Bestätigen Sie den Wert anhand der Anbieterdokumentation.
+ **Zugriff verweigert**: Überprüfen Sie die Secrets Manager- und KMS-Berechtigungen.
+ Die **Erstellung des Gebietsschemas schlägt fehl**: Stellen Sie sicher, dass die erforderlichen Felder gültig sind.
+ **Hohe Latenz**: Überprüfen Sie die Konfiguration der Anbieterregion.
# Konfigurieren Sie Drittanbieter text-to-speech (TTS)
Verwenden Sie die folgenden Anweisungen, um einen Drittanbieter text-to-speech (TTS) zu konfigurieren.
## Voraussetzungen
+ Ein Kontaktablauf ist vorhanden (oder Sie sind berechtigt, einen zu erstellen).
+ Ein API-Schlüssel eines TTS-Anbieters eines Drittanbieters, der in AWS Secrets Manager gespeichert ist. Weitere Informationen zum Speichern von API-Schlüsseln als Secrets in Secrets Manager finden Sie unter [Create an AWS Secrets Manager Secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html).
+ Eine Secrets Manager Manager-Ressourcenrichtlinie, die es Amazon Connect ermöglicht, den Schlüssel abzurufen. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
+ AWS KMS key Berechtigungen, die eine Entschlüsselung ermöglichen. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
+ Anbieterspezifische Modell- und Sprachwerte.
## Schritt 1: Öffnen Sie den Kontaktablauf
1. Melden Sie sich auf der Amazon Connect Connect-Admin-Website an.
1. Wählen Sie **Flows**.
1. Wählen Sie einen vorhandenen Flow oder erstellen Sie einen neuen.
## Schritt 2: Füge einen Sprachblock hinzu oder wähle ihn aus
1. Suche im Flow Designer nach **Set Voice**.
1. Ziehe den Block auf die Leinwand oder wähle einen vorhandenen aus.
1. Wählen Sie den Block aus, um sein Konfigurationsfenster zu öffnen.
## Schritt 3: Wählen Sie einen TTS-Drittanbieter
Wählen Sie in der Dropdownliste **Sprachanbieter** den text-to-speech Drittanbieter aus, den Sie verwenden möchten.
![\[Der Konfigurationsbereich „Sprache einrichten“ zeigt eine Drop-down-Liste mit Sprachanbietern.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/08-set-voice-amazon.png)
## Schritt 4: Modell, Stimme, Secrets Manager ARN und Sprache angeben
1. Wählen Sie unter **Modell** die Option **Manuell festlegen** und geben Sie das Anbietermodell ein.
1. Wählen Sie unter **Sprache** die Option **Manuell festlegen** aus und geben Sie die Stimme des Anbieters ein.
1. Wählen Sie unter **Secrets Manager ARN** die Option **Manuell festlegen** und geben Sie den ARN des Provider-Secrets ein.
+ Das Geheimnis muss dasselbe sein AWS-Region.
+ AWS Secrets Manager und die KMS-Richtlinien müssen das Abrufen und Entschlüsseln zulassen. Weitere Informationen finden Sie unter [Verwaltung von Geheimnissen und Ressourcenrichtlinien](managing-secrets-resource-policies.md).
1. Wählen Sie unter **Sprache** die Option **Manuell festlegen** und wählen Sie eine Sprache aus, die von der Stimme des Anbieters unterstützt wird.
![\[Der Konfigurationsbereich „Sprachanbieter“ zeigt den ElevenLabs externen Sprachanbieter an.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/Lex/09-voice-provider-elevenlabs.png)
## Schritt 5: Speichern und veröffentlichen Sie den Flow
1. Wählen Sie im Flow-Designer **Speichern**.
1. Wählen Sie **Veröffentlichen**, um die aktualisierten Flow-Einstellungen zu aktivieren.
## Laufzeitverhalten (TTS)
+ Amazon Connect sendet Text zur Synthese an den TTS-Anbieter.
+ Das zurückgesendete Audio wird dem Kunden abgespielt.
+ Ausführungsprotokolle enthalten Anbieterfehler wie ungültige Anmeldeinformationen oder Modellwerte.
## Problembehandlung (TTS)
+ **Keine Audioausgabe**: Überprüfen Sie die Modell- und Sprachwerte.
+ **Authentifizierungsfehler**: Überprüfen Sie die Secrets Manager- und KMS-Berechtigungen.
+ **Dynamische Attribute**: Stellen Sie sicher, dass Laufzeitwerte in gültige Anbieterparameter aufgelöst werden.
+ **Hohe Latenz**: Überprüfen Sie die Ausrichtung der Anbieterregion.
# Endpunkte und Regionen für STT-Drittanbieter
Standardmäßig kommuniziert Amazon Connect mit den folgenden Endpunkten:
**Deepgram: [https://api.deepgram.com](https://api.deepgram.com)**
**ElevenLabs**[: https://api.elevenlabs.io](https://api.elevenlabs.io)
Sie können neben Ihrem API-Schlüssel als Teil des JSON-Objekts eine andere Anbieter-Region angeben:
```
{
"apiToken": "XXXXX",
"apiTokenRegion": "xx"
}
```
Die folgenden Regionen werden unterstützt:
| **Anbieter** | **apiTokenRegion** | **Endpunkt** |
| --- | --- | --- |
| Deepgram | eu | [https://api.eu.deepgram.com](https://api.eu.deepgram.com)(nur unterstützt für speech-to-text) |
| Deepgram | \$1SHORT\$1UID\$1. \$1REGION\$1SUBDOMAIN\$1 | https://\$1SHORT\$1UID\$1.\$1REGION\$1SUBDOMAIN\$1.api.deepgram.com(Dedizierte Deepgram-Endpunkte) |
| ElevenLabs | wir | [https://api.us.elevenlabs.io](https://api.us.elevenlabs.io) |
| ElevenLabs | eu | [https://api.eu.residency.elevenlabs.io](https://api.eu.residency.elevenlabs.io) |
| ElevenLabs | in | [https://api.in.residency.elevenlabs.io](https://api.in.residency.elevenlabs.io) |
# Verwaltung von Geheimnissen und Ressourcenrichtlinien
Wenn Sie [einen Sprachanbieter eines Drittanbieters konfigurieren](configure-third-party-speech-providers.md), müssen Sie in Secrets Manager ein Geheimnis erstellen, das den API-Schlüssel des Sprachanbieters enthält. Das Erstellen des Geheimnisses erfolgt in zwei Schritten:
+ Erstellen Sie das Geheimnis, das den API-Schlüssel enthält. Anweisungen finden Sie unter [Ein AWS Secrets Manager Geheimnis erstellen](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html).
+ Konfigurieren Sie die erforderlichen Berechtigungen:
+ Hängen Sie dem Geheimnis eine ressourcenbasierte Richtlinie an.
+ Hängen Sie dem KMS-Schlüssel (nicht dem API-Schlüssel), der dem Geheimnis zugeordnet ist, eine ressourcenbasierte Richtlinie an. Der KMS-Schlüssel schützt den API-Schlüssel im Secret.
Diese Richtlinien ermöglichen Amazon Connect den Zugriff auf den API-Schlüssel innerhalb des Secrets. Beachten Sie, dass Sie den `aws/secretsmanager` Standard-KMS-Schlüssel nicht verwenden können. Sie müssen einen neuen Schlüssel erstellen oder einen vorhandenen, vom Kunden verwalteten Schlüssel verwenden. Weitere Informationen darüber, wie KMS-Schlüssel geheime Schlüssel schützen, finden Sie unter [Secrets Ver- und Entschlüsselung in Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html).
Stellen Sie sicher, dass die ressourcenbasierte Richtlinie für den geheimen Schlüssel die Bedingungen `aws:SourceAccount` und `aws:SourceArn` verwirrter Stellvertreter enthält (siehe [Das Problem mit dem verwirrten Stellvertreter](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html)) und dass die ressourcenbasierte Richtlinie für den KMS-Schlüssel die Bedingung enthält. `kms:EncryptionContext:SecretARN` Dadurch wird sichergestellt, dass Amazon Connect nur im Kontext einer einzelnen spezifischen Instance auf Ihren geheimen API-Schlüssel zugreifen kann und nur im Kontext dieser Instance und des spezifischen Secrets auf Ihren KMS-Schlüssel zugreifen kann.
## Beispiel für eine ressourcenbasierte Richtlinie für Secrets Manager Manager-Geheimnisse
Im Folgenden finden Sie ein Beispiel für eine ressourcenbasierte Richtlinie, die Sie mit Ihrem Secret verknüpfen können.
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": [
"connect.amazonaws.com"
]
},
"Action": "secretsmanager:GetSecretValue",
"Resource": "*",
"Condition": {
"ArnLike": {
"aws:sourceArn": "///the ARN of your Amazon Connect instance///"
},
"StringEquals": {
"aws:sourceAccount": "///Your account ID///"
}
}
}
]
}
```
## Beispiel für eine ressourcenbasierte Richtlinie für s AWS KMS key
Im Folgenden finden Sie ein Beispiel für eine ressourcenbasierte Richtlinie, die Sie an Ihren KMS-Schlüssel anhängen können.
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": [
"connect.amazonaws.com"
]
},
"Action": "kms:Decrypt",
"Resource": "*",
"Condition": {
"ArnLike": {
"aws:sourceArn": "///the ARN of your Amazon Connect instance///"
},
"StringEquals": {
"aws:sourceAccount": "///Your account ID///",
"kms:EncryptionContext:SecretARN": "///the ARN of your secrets manager secret///"
}
}
}
]
}
```
## Eine ressourcenbasierte Richtlinie an Ihr Secrets Manager Manager-Geheimnis anhängen
[Um Ihrem Secret eine ressourcenbasierte Richtlinie anzuhängen, rufen Sie die Secrets Manager-Konsole in der auf AWS-Managementkonsole, navigieren Sie zu Ihrem Secret, wählen Sie **Berechtigungen bearbeiten** oder **Ressourcenberechtigungen** und fügen Sie dann die Ressourcenrichtlinie direkt auf der Seite hinzu oder ändern Sie sie, sodass sie dem Beispiel ähnelt.](#example-resource-policy-secrets-manager) Sie können die Ressourcenrichtlinie auch über den `put-resource-policy` Befehl AWS CLI's oder programmgesteuert mithilfe der API-Operation anhängen. [PutResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutResourcePolicy.html)
## Eine ressourcenbasierte Richtlinie an Ihren KMS-Schlüssel anhängen
[Um Ihrem KMS-Schlüssel eine ressourcenbasierte Richtlinie anzuhängen, rufen Sie die AWS Key Management Service Konsole in der auf AWS-Managementkonsole, navigieren Sie zu Ihrem KMS-Schlüssel und bearbeiten Sie Ihre Schlüsselrichtlinie so, dass sie wie im Beispiel aussieht.](#example-resource-policy-kms-keys) Sie können den Schlüssel auch über den `put-key-policy` Befehl AWS CLI's oder programmgesteuert mithilfe der API-Operation aktualisieren. [PutKeyPolicy](https://docs.aws.amazon.com/kms/latest/APIReference/API_PutKeyPolicy.html)
## Rotierende API-Schlüssel
Wir empfehlen, die API-Schlüssel mindestens alle 90 Tage zu rotieren, um das Risiko von Kompromissen zu minimieren und einen gut durchdachten Schlüsselrotationsprozess für Notfallsituationen aufrechtzuerhalten.
Um einen API-Schlüssel zu rotieren, müssen Sie das Geheimnis, in dem er enthalten ist, rotieren. Weitere Informationen zur [Rotation von Secrets Manager-Geheimnissen](https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html) finden Sie im *Secrets Manager Manager-Benutzerhandbuch* unter Rotation von Secrets Manager-Geheimnissen. Wenn Sie einen API-Schlüssel rotieren, sollten Sie warten, bis die Nutzung des vorherigen Schlüssels auf Null gesunken ist, bevor Sie den alten API-Schlüssel widerrufen, um sicherzustellen, dass laufende Anfragen nicht beeinträchtigt werden.
# Erstellen Sie eine Connect AI-Agentenabsicht aus einer Amazon Connect Connect-Instance
Sie können die generativen KI-Funktionen, die von Connect AI-Agenten unterstützt werden, für Ihren Bot nutzen, indem Sie [AMAZON aktivieren. QinConnectIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-qinconnect.html)in deinem Bot. Dies ist eine in Amazon Lex integrierte Absicht.
Gehen Sie wie folgt vor, um Connect AI-Agenten zu aktivieren.
1. Öffnen Sie den Bot, für den Sie den **AMAZON hinzufügen möchten. QinConnectIntent**Absicht.
1. Navigieren Sie in der Bot-Builder-Oberfläche zur Registerkarte **Konfiguration**.
1. Aktiviere den **AMAZON. QinConnectIntent**Absicht, indem Sie den Schalter auf Ein stellen. Die folgende Abbildung zeigt die Position des Schalters.
![\[Eine Beispielkonfigurationsseite für einen nicht konfigurierten Bot.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/enable-qic-bot.png)
Der **Absichtsumschalter für Connect-AI-Agenten** wird nur für Bots unterstützt, die direkt auf der Amazon Connect Admin-Website erstellt wurden. Um Amazon Q-Funktionen zu Intents for Bots hinzuzufügen, die außerhalb der Amazon Connect Admin-Website erstellt wurden, verwenden Sie die Amazon Lex Lex-Konsole, um die Konfiguration zu aktualisieren.
1. Wählen Sie im Dialogfeld „**Connect AI-Agenten aktivieren**“ im Dropdownmenü den Amazon-Ressourcennamen (ARN) der Connect AI-Agenten-Absicht aus.
![\[Ein Dialogfeld mit der Absicht „Connect AI-Agenten aktivieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/qic-intent-dropdownbox.png)
1. Wählen Sie **Bestätigen**, um **AMAZON hinzuzufügen. QinConnectIntent**Unterstützung von Absichten.
**Wichtig**
Sie können **AMAZON nicht verwenden. **QInConnectIntent**zusammen mit Absichten ohne spezifische Äußerungen wie **AIntentAmazon.QN**, AMAZON. BedrockAgentIntent**im gleichen Bot-Gebietsschema. Weitere Informationen finden Sie unter [AMAZON. QinConnectIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-qinconnect.html)im *Amazon Lex V2 Developer Guide*.
# Erstellen von Bot-Versionen und -Aliassen in Amazon Connect
Um zu steuern, welche Bot-Implementierung Ihr Client verwendet, erstellen Sie Versionen und Aliasse.
+ Eine Version dient als nummerierter Snapshot Ihrer Arbeit.
+ Sie können einen Alias auf die Version Ihres Bots verweisen lassen, die Ihren Kunden zur Verfügung stehen soll.
Zwischen der Erstellung von Versionen können Sie die Entwurfsversion Ihres Bots weiter aktualisieren, ohne das Kundenerlebnis zu beeinträchtigen. Dieser Prozess ist entscheidend für die Bereitstellung von Bots in einer Produktionsumgebung.
## Erstellen einer Version
Durch das Erstellen einer neuen Version wird der aktuelle Status Ihrer Bot-Konfiguration beibehalten. Gehen Sie wie folgt vor, um eine neue Version Ihres Amazon-Lex-Bots in Amazon Connect zu erstellen.
1. Öffnen Sie den Bot, für den Sie eine neue Version erstellen möchten.
1. Wählen Sie die Registerkarte **Versionen** und dann **Version erstellen** aus.
![\[Die Registerkarte „Versionen“ mit der Schaltfläche „Version erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-versionstab.png)
1. Gehen Sie im Dialogfeld **Version erstellen** wie folgt vor:
1. Geben Sie eine Versionsbeschreibung ein (optional, aber für die Nachverfolgung von Änderungen empfohlen).
1. Wählen Sie **Erstellen** aus. Die folgende Abbildung zeigt ein Beispiel für das Dialogfeld **Version erstellen**.
![\[Dialogfeld „Version erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/create-version-bot.png)
Nachdem die Version erstellt wurde, können Sie sie mit Aliassen verknüpfen oder sie verwenden, um zu einem früheren Status Ihres Bots zurückzukehren.
## Erstellen eines Alias
Ein Alias ist ein Zeiger auf eine bestimmte Bot-Version. Mit einem Alias können Sie einfach die Version aktualisieren, die Ihre Clientanwendungen verwenden. Beispielsweise können Sie einen Alias auf Version 1 Ihres Bot verweisen lassen. Wenn Sie bereit sind, den Bot zu aktualisieren, erstellen Sie Version 2 und ändern den Alias so, dass er auf die neue Version verweist. Da Ihre Anwendungen den Alias anstelle einer bestimmten Version verwenden, erhalten alle Ihre Clients die neuen Funktionen, ohne dafür aktualisiert werden zu müssen. Dies ermöglicht kontrollierte Rollouts und eine einfache Versionsverwaltung.
**Wichtig**
Wenn Sie den Bot in einem Ablauf verwenden möchten, achten Sie darauf, bei der Erstellung eines Alias die Option **Für die Verwendung in Abläufen und Ablaufmodulen aktivieren** auszuwählen.
Gehen Sie wie folgt vor, um einen Alias für Ihren Amazon-Lex-Bot zu erstellen.
1. Öffnen Sie den Bot, für den Sie den Alias hinzufügen möchten.
1. Wählen Sie die Registerkarte **Aliasse** und dann **Aliasse erstellen** aus.
![\[Die Registerkarte „Aliasse“ mit der Schaltfläche „Aliasse erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-aliases-button.png)
1. Führen Sie im Dialogfeld **Alias erstellen** die folgenden Schritte aus:
1. Geben Sie einen eindeutigen Namen für den Alias ein.
1. Geben Sie eine Beschreibung ein (optional, aber empfohlen).
1. Wählen Sie die Bot-Version aus, die Sie diesem Alias zuordnen möchten.
1. (Empfohlen) Wählen Sie **Für die Verwendung in Abläufen und Ablaufmodulen aktivieren** aus. Dies ist erforderlich, wenn Sie den Bot in einem Ablauf verwenden möchten.
1. Wählen Sie **Erstellen** aus. Die folgende Abbildung zeigt ein Beispiel für das Dialogfeld **Alias erstellen**.
![\[Dialogfeld „Alias erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-create-alias.png)
Weitere Informationen zu Versionsverwaltung und Aliassen in Amazon Lex V2 finden Sie unter [Versionsverwaltung und Aliasse mit Ihrem Lex-V2-Bot](https://docs.aws.amazon.com/lexv2/latest/dg/versions-aliases.html) im *Entwicklerhandbuch zu Amazon Lex V2*.
# Bewerten der Leistung Ihres Konversations-KI-Bots in Amazon Connect
Sie können die umfassenden Analysetools in Amazon Connect verwenden, um die Leistung Ihres Konversations-KI-Bots zu bewerten und zu optimieren. Diese Erkenntnisse ermöglichen es Ihnen, erfolgreiche Interaktionen zu identifizieren, Schwachstellen zu lokalisieren und Gesprächsmuster zu visualisieren, um das Kundenerlebnis kontinuierlich zu verbessern.
Das Analytik-Dashboard enthält wichtige Metriken wie die Erkennungsrate von Äußerungen und die Konversationsleistung. Diese Metriken helfen Ihnen dabei, sowohl die Erfolgs- als auch die Misserfolgsraten der Interaktionen Ihres Bots mit Kunden zu verstehen.
**Anmerkung**
Auf der Seite mit Bot-Analysen werden Daten für Konversationen angezeigt, die nur durch Abläufe ausgelöst wurden. Sie können Bots extern mithilfe von Lex APIs oder benutzerdefinierten Integrationen auslösen, aber die Daten für diese Konversationen werden auf dieser Seite nicht wiedergegeben.
**So zeigen Sie Analysen für Ihren Bot an**
1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*instance name*.my.connect.aws/ an. Verwenden Sie ein Administratorkonto oder ein Konto mit den folgenden Berechtigungen im Sicherheitsprofil:
+ **Kanäle und Abläufe** – **Bots** – **Anzeigen**
+ **Kanäle und Abläufe** – **Bots** – **Bearbeiten**
+ **Analytik und Optimierung** – **Verlaufsmetriken** – **Zugriff**
1. Wählen Sie im Navigationsmenü **Weiterleitung**, **Flows** aus.
1. Wählen Sie auf der Seite **Abläufe** die Option **Bots** aus, wählen Sie den Bot aus, dessen Leistung Sie bewerten möchten, und wählen Sie dann **Analytik** aus.
![\[Die Seite „Abläufe“ und die Registerkarte „Analytik“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-analytics1.png)
In der folgenden Abbildung sehen Sie Beispielanalytikdaten.
![\[Die Registerkarte „Analytik“ mit Beispielanalysedaten für einen Bot.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-analytics.png)
Verwenden Sie diese Analysen, um Verbesserungsmöglichkeiten zu identifizieren, die Antworten Ihres Bots zu präzisieren und das allgemeine Kundenerlebnis zu verbessern.
Zusätzliche Metriken und erweiterte Analyseverfahren speziell für Amazon Lex finden Sie unter [Überwachen der Bot-Leistung in Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/monitoring-bot-performance.html).
# Bot-Metriken und -Analytik in Amazon Connect
[Die folgenden Flow-gesteuerten Metriken sind auf der und der V2 verfügbar. [Dashboard „Leistung der Flows und Gesprächs-Bots“](flows-performance-dashboard.md) GetMetricData](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html)
## Durchschnittliche Bot-Gesprächszeit
Diese Metrik misst die durchschnittliche Dauer abgeschlossener Konversationen, für die die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde.
**Metriktyp**: Zeichenfolge (*hh:mm:ss*)
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `AVG_BOT_CONVERSATION_TIME`
Dies kann mit dem `BOT_CONVERSATION_OUTCOME_TYPE`-Filter auf Metrikebene nach bestimmten Gesprächsergebnissen gefiltert werden.
**Berechnungslogik**:
+ Summe (Startzeit der Konversation – Endzeit der Konversation aller gefilterten Konversationen)/(Anzahl aller gefilterten Konversationen)
**Hinweise:**
+ Daten für diese Metrik sind ab dem 2. Dezember 2024, 0.00 Uhr GMT verfügbar.
## Durchschnittliche Anzahl der Bot-Gesprächswechsel
Diese Metrik misst die durchschnittliche Anzahl der Gesprächsabschnitte für abgeschlossene Konversationen, bei denen die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde.
Ein Gesprächswechsel ist eine Anfrage der Client-Anwendung und eine Antwort des Bots.
**Metriktyp**: Doppelt
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `AVG_BOT_CONVERSATION_TURNS`
Dies kann mit dem `BOT_CONVERSATION_OUTCOME_TYPE`-Filter auf Metrikebene nach bestimmten Gesprächsergebnissen gefiltert werden.
**Berechnungslogik**:
+ Summe (Gesprächswechsel aller gefilterten Gespräche) / (Anzahl aller gefilterten Gespräche)
**Hinweise:**
+ Daten für diese Metrik sind ab dem 2. Dezember 2024, 0.00 Uhr GMT verfügbar.
## Abgeschlossene Bot-Konversationen
Diese Metrik gibt die Anzahl der abgeschlossenen Konversationen an, bei denen die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde. Die Endzeit der Konversation kann nach der angegebenen Endzeit liegen.
Wenn Sie diese Metrik beispielsweise mit der Startzeit um 9 Uhr und der Endzeit 10 Uhr anfordern, umfasst das Ergebnis Konversationen, bei denen die aufrufende Ressource (Flow- oder Flow-Modul):
+ um 9:15 Uhr gestartet und um 9:40 Uhr beendet wurde
+ um 9:50 Uhr gestartet und um 10:10 Uhr beendet wurde
Es schließt jedoch Konversationen aus, für die die aufrufende Ressource (Flow oder Flow-Modul):
+ um 8:50 Uhr gestartet und um 9:10 Uhr beendet wurde
**Metriktyp**: Ganzzahl
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `BOT_CONVERSATIONS_COMPLETED`
Diese kann mit dem `BOT_CONVERSATION_OUTCOME_TYPE`-Filter auf Metrikebene nach den folgenden Gesprächsergebnissen gefiltert werden.
+ SUCCESS: Die endgültige Absicht in der Konversation wird als *Erfolg* eingestuft.
+ FAILED: Die letzte Absicht in der Konversation ist fehlgeschlagen. Die Konversation schlägt auch fehl, wenn Amazon Lex V2 standardmäßig `AMAZON.FallbackIntent` verwendet.
+ DROPPED: Der Kunde reagiert erst, nachdem die Konversation als *Erfolg* oder *Fehlgeschlagen* eingestuft wurde.
**Berechnungslogik**:
+ Gesamtzahl der Konversationen.
**Hinweise:**
+ Daten für diese Metrik sind ab dem 2. Dezember 2024, 0.00 Uhr GMT verfügbar.
## Abgeschlossene Bot-Absichten
Diese Metrik gibt die Anzahl der abgeschlossenen Absichten an. Sie enthält Absichten für abgeschlossene Konversationen, bei denen die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde.
**Metriktyp**: Ganzzahl
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `BOT_INTENTS_COMPLETED`
Diese kann mit dem `BOT_CONVERSATION_OUTCOME_TYPE`-Filter auf Metrikebene nach den folgenden Gesprächsergebnissen gefiltert werden.
Diese kann mit dem `BOT_INTENTS_OUTCOME_TYPE`-Filter auf Metrikebene nach den folgenden Absichtsergebnissen gefiltert werden.
+ SUCCESS: Der Bot hat die Absicht erfolgreich erfüllt. Eine der folgenden Situationen liegt vor:
+ Der *Absichtsstatus* ist *ReadyForFulfillment*und der Typ von *DialogAction* ist *Close*.
+ `state` der Absicht ist `Fulfilled` und der Typ von `dialogAction` ist `Close`.
+ FAILED: Der Bot konnte die Absicht nicht erfüllen. Der Status der Absicht. Eine der folgenden Situationen liegt vor:
+ `state` der Absicht ist `Failed` und der `type` von `dialogAction` ist `Close` (z. B. hat der Benutzer den Bestätigungsprompt abgelehnt).
+ Der Bot wechselt zu `AMAZON.FallbackIntent`, bevor die Absicht abgeschlossen wird.
+ SWITCHED: Der Bot erkennt eine andere Absicht und wechselt stattdessen zu dieser Absicht, bevor die ursprüngliche Absicht als *Erfolg* oder *Fehlgeschlagen* eingestuft wird.
+ DROPPED: Der Kunde reagiert erst, wenn die Absicht als *Erfolg* oder *Fehlgeschlagen* eingestuft wurde.
**Berechnungslogik**:
+ Gesamtzahl der Absichten.
**Hinweise:**
+ Daten für diese Metrik sind ab dem 2. Dezember 2024, 0.00 Uhr GMT verfügbar.
## Ergebnis der Bot-Konversationen in Prozent
Diese Metrik gibt den Prozentsatz der gesamten Konversationen an, die mit dem spezifischen Ergebnistyp beendet wurden, der im Filter auf Metrikebene (`BOT_CONVERSATION_OUTCOME_TYPE`) angegeben ist. Sie enthält nur abgeschlossene Konversationen, bei denen die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde.
**Metriktyp**: Prozent
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `PERCENT_BOT_CONVERSATIONS_OUTCOME`
**So greifen Sie über die Amazon Connect Admin-Website** zu:
**Berechnungslogik**:
+ (Anzahl der Konversationen mit BOT\$1CONVERSATION\$1OUTCOME\$1TYPE) / (Gesamtzahl der Konversationen) x 100
**Hinweise:**
+ Daten für diese Metrik sind ab dem 2. Dezember 2024, 0.00 Uhr GMT verfügbar.
## Ergebnis von Bot-Absichten in Prozent
Diese Metrik gibt den Prozentsatz der Absichten an, die mit dem spezifischen Ergebnistyp beendet wurden, der im Filter auf Metrikebene (`BOT_INTENT_OUTCOME_TYPE`) angegeben ist. Sie umfasst Absichten für abgeschlossene Konversationen, bei denen die aufrufende Ressource (Flow oder Flow-Modul) zwischen der angegebenen Start- und Endzeit gestartet wurde.
**Metriktyp**: Prozent
**Metrikkategorie**: Flow-gesteuerte Metrik
**So greifen Sie über die Amazon-Connect-API zu**:
+ [GetMetricDataV2-API-Metrik-ID](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `PERCENT_BOT_INTENTS_OUTCOME`
**So greifen Sie über die Amazon Connect Admin-Website** zu:
**Berechnungslogik**:
+ (Anzahl der Absichten mit BOT\$1INTENT\$1OUTCOME\$1TYPE) / (Gesamtzahl der Absichten) x 100
# Unterstützung bei der erweiterten Bot-Konfiguration von Amazon Connect
Mit dem Feature für die erweiterte Konfiguration können Sie detaillierte Anpassungen an Ihrem Bot vornehmen, ohne die Amazon-Lex-Konsole aufrufen zu müssen.
1. Wählen Sie auf der Amazon Connect Admin-Website in der linken Navigationsleiste **Flows** aus. Wählen Sie die Registerkarte **Bots** und dann den Bot aus, mit dem Sie arbeiten möchten.
1. Wählen Sie die Schaltfläche **Erweiterte Konfigurationen** aus, wie in der folgenden Abbildung dargestellt.
![\[Die Schaltfläche „Erweiterte Konfigurationen“ auf einer Bot-Detailseite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-advanced-config.png)
Durch diese Aktion wird die Ansicht auf eine detailliertere Oberfläche umgestellt, über die Sie auf weitere Features zum Anpassen Ihres Bots zugreifen können.
1. Um zur einfachen Bot-Benutzeroberfläche zurückzukehren, wählen Sie **Konfigurationsübersicht** aus, wie in der folgenden Abbildung dargestellt.
![\[Seite „Erweiterte Konfiguration“ mit der Schaltfläche „Konfigurationsübersicht“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/bot-adv-config2.png)
# Einen Amazon-Lex-Bot zu Amazon Connect hinzufügen
**Wichtig**
**Hinweis zum Ende des Supports**: Am 15. September 2025 AWS wird der Support für Amazon Lex V1 eingestellt. Nach dem 15. September 2025 können Sie nicht mehr auf die Amazon-Lex-V1-Konsole oder die Amazon-Lex-V1-Ressourcen zugreifen. Weitere Informationen zur Migration zu Amazon Lex V2 finden Sie unter [Migrieren von Bots](https://docs.aws.amazon.com/lex/latest/dg/migrate.html).
In diesem Artikel begleiten wir Sie durch die Schritte zum Hinzufügen eines Amazon-Lex-Bots zu Amazon Connect.
Mit Amazon Lex können Sie Konversationsinteraktionen (Bots) aufbauen, die sich für Ihre Kunden natürlich anfühlen. Bots von Amazon Connect mit Amazon Lex können Kundeneingaben auch als Ziffern erfassen, die Kunden auf ihrer Zehnertastatur eingeben, wenn sie in einem Amazon-Connect-Flow verwendet werden. Auf diese Weise können Kunden entscheiden, wie sie vertrauliche Informationen eingeben möchten, wie z. B. Kontonummern.
Für diese detaillierte Anleitung benötigen Sie Folgendes:
+ Ein aktives AWS Konto.
+ Eine Amazon-Connect-Instance.
**Tipp**
Sie können Amazon Lex auch verwenden, um interaktive Nachrichten für den Amazon-Connect-Chat bereitzustellen. Interaktive Nachrichten sind umfangreiche Nachrichten, die eine Aufforderung und vorkonfigurierte Anzeigeoptionen enthalten, die der Kunde auswählen kann. Diese Nachrichten werden von Amazon Lex bereitgestellt und über Amazon Lex mithilfe eines Lambda konfiguriert. Weitere Informationen finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md).
## Erstellen Sie einen Amazon-Lex-Bot
In diesem Schritt erstellen Sie einen benutzerdefinierten Bot, um die Integration von „Drücken“ oder „Sagen“ in Amazon Connect vorzuführen. Der Bot fordert Anrufer auf, eine Zahl zu drücken oder zu sagen, die mit der Menüoption für die zu absolvierende Aufgabe übereinstimmt. In diesem Fall überprüft die Eingabe ihren Kontostand.
------
#### [ Amazon Lex ]
1. Öffnen Sie die [Amazon Lex-Konsole](https://console.aws.amazon.com/lexv2/home).
1. Wählen Sie **Create bot** aus.
1. Wählen Sie auf der Seite **Bot-Einstellungen konfigurieren** die Option **Erstellen – Leeren Bot erstellen** und geben Sie die folgenden Informationen ein:
+ **Bot-Name — Geben** Sie für diese exemplarische Vorgehensweise einen Namen für den Bot **AccountBalance**ein.
+ **IAM permissions** – Wählen Sie eine Rolle aus, falls Sie eine erstellt haben. Andernfalls wählen Sie **Create a role with basic Amazon Lex permissions**.
+ **COPPA**: Wählen Sie, ob der Bot abhängig vom Child Online Privacy Protection Act ist.
+ **Session timeout (Sitzungstimeout)**: Wählen Sie, wie lange der Bot warten soll, bis er Daten von einem Anrufer erhält, bevor die Sitzung beendet wird.
1. Wählen Sie **Weiter**.
1. Geben Sie sprach- und sprachspezifische Informationen an:
+ **Language** – Wählen Sie Sprache und Region aus der Liste der [von Amazon Lex unterstützten Sprachen und Gebietsschemas](https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html) aus.
+ **Voice interaction**: Wählen Sie die Stimme aus, mit der Ihr Bot zu Anrufern spricht. Die standardmäßige Stimme für Amazon Connect ist Joana.
1. Wählen Sie **Fertig** aus. Der AccountBalance Bot wird erstellt und die **Intent-Seite** wird angezeigt.
------
#### [ Amazon Lex (Classic) ]
1. Öffnen Sie die [Amazon Lex-Konsole](https://console.aws.amazon.com/lex/).
1. Wenn Sie Ihren ersten Bot erstellen, wählen Sie **Get Started** aus. Wählen Sie andernfalls **Bots, Create (Erstellen)**.
1. Wählen Sie auf der Seite **Create your bot (Ihren Bot erstellen)** die Option **Custom bot (Benutzerdefinierter Bot)** aus und stellen Sie die folgenden Informationen bereit:
+ **Bot-Name** — Für diese exemplarische Vorgehensweise geben Sie dem Bot **AccountBalance**einen Namen.
+ **Output voice**: Wählen Sie die Stimme aus, mit der Ihr Bot zu Anrufern spricht. Die standardmäßige Stimme für Amazon Connect ist Joana.
+ **Session timeout (Sitzungstimeout)**: Wählen Sie, wie lange der Bot warten soll, bis er Daten von einem Anrufer erhält, bevor die Sitzung beendet wird.
+ **COPPA**: Wählen Sie, ob der Bot abhängig vom Child Online Privacy Protection Act ist.
1. Wählen Sie **Erstellen** aus.
------
## Den Amazon-Lex-Bot konfigurieren
In diesem Schritt bestimmen Sie, wie der Bot auf Kunden reagiert, indem Sie Absichten, Beispieläußerungen, Eingabeslots und Fehlerbehandlung angeben.
In diesem Beispiel konfigurieren Sie den Bot mit zwei Absichten: eine zum Nachschlagen von Kontoinformationen und eine zum Sprechen mit einem Agent.
### Absicht erstellen AccountLookup
------
#### [ Amazon Lex ]
1. Nachdem Sie den Bot erstellt haben, befinden Sie sich auf der **Intents**-Seite der Amazon Lex-Konsole. Wenn du noch nicht da bist, kannst du dorthin gelangen, indem du **Bots**, **Bot-Versionen **AccountBalance****, **Entwurfsversion**, **Absichten** auswählst. Wählen Sie **Add intent**, **Add empty intent**.
1. Geben **AccountLookup**Sie im Feld **Name der Absicht** den Text ein.
1. Scrollen Sie auf der Seite nach unten zu **Sample utterances**. In diesem Schritt geben Sie Äußerungen ein, die es dem Kunden ermöglichen, die Absicht zu ergründen. AccountLookup Geben Sie die folgenden Äußerungen ein und wählen Sie nach jeder Äußerung die Option Äußerung **hinzufügen**.
+ **Überprüfen meines Kontostands**
+ **Eins**: Dadurch wird der Absicht die Äußerung „Eins“ oder der Tastendruck von „1“ zugewiesen. **AccountLookup**
Die folgende Abbildung zeigt, wo die Äußerung im Abschnitt **Sample utterances** hinzugefügt werden kann.
![\[Der Abschnitt mit den Beispieläußerungen auf der Seite Intents.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-enter-utterances.png)
1. Scrollen Sie zum Abschnitt **Slots** und wählen Sie **Add slot**. Füllen Sie diese wie folgt aus:
1. **Required for this intent** = ausgewählt.
1. **Name =**. **AccountNumber**
1. **Slot type** = **AMAZON.Number**.
1. **Prompts** = der Text, der gesprochen werden soll, wenn der Anruf entgegengenommen wird. Sie können Anrufer beispielsweise bitten, ihre Kontonummer mit der Tastatur einzugeben: **Geben Sie Ihre Kontonummer über das Tastenfeld Ihres Telefons ein**. Wählen Sie **Hinzufügen** aus.
Die folgende Abbildung zeigt den abgeschlossenen Abschnitt **Add slot**.
![\[Der Abschnitt „Slot hinzufügen“ auf der Seite Intents.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-add-slots.png)
1. Scrollen Sie zum Abschnitt **Closing responses**. Fügen Sie eine Nachricht hinzu, die der Bot dem Kunden sagen soll. Beispiel: **Ihr Kontostand beträgt 1.234,56 US\$1.** (Für diese exemplarische Vorgehensweise werden wir die Daten nicht wirklich abrufen, was Sie in der Realität tun würden.)
Die folgende Abbildung veranschaulicht die Bearbeitung eines Abschnitts mit **Closing responses**.
![\[Der Abschnitt mit den abschließenden Antworten auf der Seite „Intents“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-response1.png)
1. Wählen Sie **Absicht speichern**.
------
#### [ Amazon Lex (Classic) ]
1. Klicken Sie in der Amazon Lex-Konsole auf das **\$1**-Symbol neben **Intents** und anschließend auf **Create new intent** (Neue Absicht erstellen).
1. Nennen Sie die Absicht **AccountLookup**.
1. Fügen Sie eine Beispieläußerung hinzu, wie z. B. *Überprüfen Sie meinen Kontostand*, und klicken Sie auf das **\$1**-Symbol.
1. Fügen Sie eine zweite Äußerung, wie z. B. *Eins* und klicken Sie auf das **\$1**-Symbol. Dadurch wird der Absicht die Äußerung „Eins“ oder der Tastendruck von „1“ zugewiesen. **AccountLookup**
**Tipp**
Sie müssen die Äußerung "Eins" im Bot hinzufügen, nicht die Zahl "1". Dies liegt daran, dass Amazon Lex numerische Eingaben nicht direkt unterstützt. Um dies zu umgehen, verwenden Sie später in dieser exemplarischen Vorgehensweise numerische Eingaben, um mit einem Lex-Bot zu interagieren, der von einem Flow aufgerufen wird.
1. Fügen Sie unter **Steckplätze** einen Steckplatz mit dem Namen hinzu. **AccountNumber**
Die folgende Abbildung zeigt die Position des Abschnitts **Slots** auf der Seite.
![\[Der Slot-Bereich auf der Intents-Seite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-slots.png)
1. Verwenden Sie für **Slot type (Slot-Typ)** das Dropdown-Feld, um **AMAZON.NUMBER** auszuwählen.
1. Fügen Sie für **Prompt (Eingabeaufforderung)** den Text hinzu, der gesprochen werden soll, wenn der Anruf entgegengenommen wird. Sie können Anrufer beispielsweise bitten, ihre Kontonummer mit der Tastatur einzugeben: *Geben Sie Ihre Kontonummer über das Tastenfeld Ihres Telefons ein*.
1. Klicken Sie auf das Pluszeichen (\$1).
1. Stellen Sie sicher, dass das Kontrollkästchen **Required (Erforderlich)** ausgewählt ist.
1. Fügen Sie im Abschnitt **Response (Antwort)** eine Nachricht hinzu, die der Bot zu den Kunden sagen soll. Beispiel: **Ihr Kontostand beträgt 1.234,56 US\$1.**
1. Wählen Sie **Absicht speichern**.
------
### SpeakToAgent Absicht erstellen
------
#### [ Amazon Lex ]
1. Gehen Sie zur Seite **Intents**: Wählen Sie **Back to intents list**.
1. Wählen Sie **Add intent**, **Add empty intent**.
1. Geben Sie in das Feld **Absichtsname** den Text ein **SpeakToAgent**, und wählen Sie dann **Hinzufügen** aus.
1. Scrollen Sie nach unten zum Abschnitt **Sample utterances**. Geben Sie die folgenden Äußerungen ein, anhand derer der Kunde die Absicht ausdrücken kann: SpeakToAgent
+ **Sprechen Sie mit einem Kundendienstmitarbeiter**
+ **Zwei**
1. Scrollen Sie nach unten bis zum Abschnitt **Closing responses**. Fügen Sie eine Nachricht hinzu, die der Bot dem Kunden sagen soll. Beispiel: **Ein Kundendienstmitarbeiter wird sich in Kürze mit Ihnen in Verbindung setzen**.
1. Wählen Sie **Absicht speichern**.
------
#### [ Amazon Lex (Classic) ]
1. Klicken Sie in der Amazon Lex-Konsole auf das **\$1**-Symbol neben **Intents** und anschließend auf **Create new intent** (Neue Absicht erstellen).
1. Nennen Sie die Absicht. **SpeakToAgent**
1. Wählen Sie **SpeakToAgent**.
1. Fügen Sie eine Beispieläußerung hinzu, wie z. B. *Sprechen Sie mit einem Agenten*, und klicken Sie auf **\$1**.
1. Fügen Sie eine zweite Äußerung hinzu, wie z. B. *Zwei*, und klicken Sie auf **\$1**.
1. Fügen Sie eine Nachricht hinzu, die Anrufer informiert, dass ihr Anruf an einen Kundendienstmitarbeiter weitergeleitet wird. Beispiel: „Ein Kundendienstmitarbeiter wird sich in Kürze mit Ihnen in Verbindung setzen.“
1. Wählen Sie **Absicht speichern**.
------
## Erstellen und testen Sie den Amazon-Lex-Bot
Nachdem Sie Ihren Bot erstellt haben, stellen Sie sicher, dass er wie vorgesehen funktioniert.
------
#### [ Amazon Lex ]
1. Wählen Sie unten auf der Seite **Build** aus. Es kann einige Minuten dauern. Die folgende Abbildung zeigt, wo sich die **Build**-Schaltfläche befindet.
![\[Die Position der Build-Schaltfläche auf der Seite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-build-test-intent.png)
1. Wenn Sie mit dem Erstellen fertig sind, wählen Sie **Test**.
1. Lassen Sie uns die **AccountLookup**Absicht testen: Geben Sie im Bereich **Entwurfsversion testen** im Feld **Nachricht eingeben den Wert **1** ein** und drücken Sie die Eingabetaste. Geben Sie dann eine fiktive Kontonummer ein und drücken Sie die Eingabetaste. Die folgende Abbildung veranschaulicht die Eingabe von Intent.
![\[Das Feld, in das Sie die zu testende Absicht eingeben.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-test1.png)
1. Löschen Sie das Testfeld.
1. Geben Sie die Absichten ein, die Sie testen möchten.
1. Um zu überprüfen, ob die **SpeakToAgent**Absicht funktioniert, löschen Sie das Testfeld, geben Sie **2** ein und drücken Sie die Eingabetaste. Die folgende Abbildung zeigt, wie der Test aussieht, nachdem Sie ihn gelöscht und dann 2 eingegeben haben.
![\[Die Testbox.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-test2.png)
1. Schließen Sie den Bereich **Test Draft version**.
------
#### [ Amazon Lex (Classic) ]
1. Wählen Sie **Build** aus. Es kann einige Minuten dauern.
1. Wenn die Erstellung abgeschlossen ist, wählen Sie **Test Chatbot** aus, wie in der folgenden Abbildung gezeigt.
![\[Die Test-Chatbot-Schaltfläche rechts auf der Seite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-test-chatbot.png)
1. Lassen Sie uns die **AccountLookup**Absicht testen: Geben Sie im Bereich „**Chatbot testen**“ im Feld **Mit Ihrem Bot chatten** den Wert **1** ein. Geben Sie dann eine fiktive Kontonummer ein. In der folgenden Abbildung zeigt der Pfeil auf das Feld, in das Sie 1 eingeben.
![\[Der Test-Bot, das Feld zum Eingeben Ihrer Nachricht.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-test-run.png)
1. Wählen Sie **Clear chat history (Chat-Verlauf leeren)**.
1. Um zu bestätigen, dass die **SpeakToAgent**Absicht funktioniert, geben Sie **2** ein.
------
## Erstellen Sie eine Bot-Version (optional)
In diesem Schritt erstellen Sie eine neue Bot-Version zur Verwendung in einem Alias. So erstellen Sie einen Alias, der in einer Produktionsumgebung verwendet werden kann. Für Test-Aliasse gelten niedrigere Drosselungsgrenzen. Obwohl es sich um eine exemplarische Vorgehensweise für einen Test handelt, ist das Erstellen einer Version eine bewährte Methode.
------
#### [ Amazon Lex ]
1. Wenn Sie sich auf der **Intents**-Seite befinden, wählen Sie **Back to intents list** aus.
1. Wählen Sie im linken Menü **Bot versions** aus.
1. Wählen Sie **Create version**.
1. Überprüfen Sie die Details des **AccountBalance**Bots und wählen Sie dann **Create** aus.
Dadurch wird eine Version Ihres Bots (Version 1) erstellt. Sie können die Versionen eines Alias, das kein Test-Alias ist, wechseln, ohne nachverfolgen zu müssen, welche Version veröffentlicht wird.
![\[Die Versionsseite, auf der Version 1 aufgeführt ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-version1.png)
------
## Erstellen eines Alias für den Bot
------
#### [ Amazon Lex ]
1. Wählen Sie im linken Menü **Aliasses** aus.
1. Wählen Sie auf der Seite **Aliasses** **Alias erstellen**.
1. Geben Sie im Feld **Alias name** einen Namen ein, z. B. **Test**. Später in dieser exemplarischen Vorgehensweise verwenden Sie diesen Alias, um diese Version des Bots in Ihrem Flow anzugeben.
**Wichtig**
Verwenden Sie in einer Produktionsumgebung immer einen anderen Alias als **TestBotAlias**für Amazon Lex und **\$1LATEST** für Amazon Lex classic. **TestBotAlias**und **\$1LATEST** unterstützen eine begrenzte Anzahl gleichzeitiger Aufrufe an einen Amazon Lex Lex-Bot. Weitere Informationen finden Sie unter [Runtime quotas](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html#quotas-service).
1. **Wählen Sie unter **Associated version** die Version aus, die Sie gerade erstellt haben, z. B. Version 1.**
1. Wählen Sie **Erstellen** aus.
------
#### [ Amazon Lex (Classic) ]
1. Wählen Sie **Publish**.
1. Geben Sie einen Alias für Ihren Bot an. Verwenden Sie den Alias, um diese Version des Bots im Flow anzugeben, z. B. **Test**.
**Wichtig**
Verwenden Sie in einer Produktionsumgebung immer einen anderen Alias als **TestBotAlias**für Amazon Lex und **\$1LATEST** für Amazon Lex classic. **TestBotAlias**und **\$1LATEST** unterstützen eine begrenzte Anzahl gleichzeitiger Aufrufe an einen Amazon Lex Lex-Bot. Weitere Informationen finden Sie unter [Runtime Servicekontingente](https://docs.aws.amazon.com/lex/latest/dg/gl-limits.html#gl-limits-runtime).
1. Wählen Sie **Publish**.
------
## Fügen Sie den Amazon-Lex-Bot zu Ihrer Amazon-Connect-Instance hinzu
------
#### [ Amazon Lex ]
1. Verwenden Sie die [Amazon Connect console](https://console.aws.amazon.com/connect/).
1. Wählen Sie die Amazon-Connect-Instance aus, die Sie in Ihren Amazon-Lex-Bot integrieren möchten.
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)
1. Wählen Sie im Navigationsmenü **Flows**.
1. Verwenden Sie unter **Amazon Lex** die Dropdownliste, um die Region Ihres Amazon Lex Lex-Bot auszuwählen, und wählen Sie dann Ihren Amazon Lex Lex-Bot aus. **AccountBalance**
1. Wählen Sie den Amazon-Lex-Bot-Aliasnamen aus der Dropdownliste (**Test**) aus und wählen Sie dann **\$1 Lex Bot hinzufügen**. Die folgende Abbildung zeigt den Amazon Lex-Bereich nach der Konfiguration.
![\[Der Abschnitt Amazon Lex auf der Flows-Seite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-region-bot.png)
**Anmerkung**
Amazon Connect verwendet ressourcenbasierte Richtlinien von Amazon Lex, um Anrufe an Ihren Amazon-Lex-Bot zu tätigen. Wenn Sie Ihrer Amazon-Connect-Instance einen Amazon-Lex-Bot zuordnen, wird die ressourcenbasierte Richtlinie für den Bot aktualisiert, sodass Amazon Connect die Erlaubnis erhält, den Bot aufzurufen. Weitere Informationen zu ressourcenbasierten Richtlinien von Amazon Lex finden Sie unter [How Amazon Lex works with IAM](https://docs.aws.amazon.com/lexv2/latest/dg/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies).
------
#### [ Amazon Lex (Classic) ]
1. Verwenden Sie die [Amazon Connect console](https://console.aws.amazon.com/connect/).
1. Wählen Sie die Amazon-Connect-Instance aus, die Sie in Ihren Amazon-Lex-Bot integrieren möchten.
1. Wählen Sie im Navigationsmenü **Contact flows**.
1. Wählen Sie unter **Amazon Lex** die Region Ihres Amazon Lex-Classic-Bot aus der Drop-down-Liste und wählen Sie dann Ihren Amazon Lex-Classic-Bot aus. Sein Name wird das Suffix „(Classic)“ haben. Wählen Sie dann **Add Lex Bot**.
------
## Erstellen Sie einen Flow und fügen Sie Ihren Amazon-Lex-Bot hinzu
**Wichtig**
Wenn Sie einen Amazon Lex V2-Bot verwenden, muss Ihr Sprachattribut in Amazon Connect dem Sprachmodell entsprechen, das für die Erstellung Ihres Lex-Bot verwendet wurde. Das ist anders als Amazon Lex (Classic). Verwenden Sie den Block [Set voice](set-voice.md#set-voice-lexv2bot), um das Amazon-Connect-Sprachmodell anzugeben, oder verwenden Sie einen [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md)-Block.
Als Nächstes erstellen Sie einen neuen Flow, der Ihren Amazon-Lex-Bot verwendet. Wenn Sie den Flow erstellen, konfigurieren Sie die für Anrufer abgespielte Nachricht.
1. Melden Sie sich bei Ihrer Amazon-Connect-Instance mit einem Konto an, das über Berechtigungen für KontaktFlows und Amazon Lex Bots verfügt.
1. Wählen Sie im Navigationsmenü **Routing, Flows, Create Flow** aus und geben Sie einen Namen für den Flow ein.
1. Ziehen Sie unter **Interact** (Interagieren) einen [Kundeneingabe abrufen](get-customer-input.md)-Block auf den Designer und verbinden Sie ihn mit dem Block **Entry point** (Eintrittspunkt).
1. Wählen Sie den Block **Get customer input (Kundeneingabe abrufen)**, um ihn zu öffnen. Wählen Sie **Text to speech or chat text, Enter text**.
1. Geben Sie eine Nachricht ein, die Anrufern Informationen über mögliche Aktionen bereitstellt. Verwenden Sie z. B. eine Nachricht, die den im Bot verwendeten Absichten entspricht, z. B. „Um Ihren Kontostand zu überprüfen, drücken oder sagen Sie 1. Um mit einem Kundendienstmitarbeiter zu sprechen, drücken Sie oder sagen Sie 2. Die folgende Abbildung zeigt diese Nachricht auf der Seite „Eigenschaften“ des Blocks **Kundeneingabe abrufen**.
![\[Die Seite „Eigenschaften“ des Blocks Kundeneingabe abrufen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-get-customer-input.png)
1. Wählen Sie die Registerkarte **Amazon Lex** aus, wie in der folgenden Abbildung gezeigt.
![\[Die Registerkarte Amazon Lex auf der Seite „Eigenschaften“ des Blocks Kundeneingabe abrufen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lexv2-get-customer-input2.png)
1. Wählen Sie in der Dropdownliste **Name** den **AccountBalance**Bot aus, den Sie zuvor erstellt haben.
1. Wenn Sie einen Amazon-Lex-Bot ausgewählt haben, verwenden Sie unter **Alias** das Drop-down-Menü, um den Bot-Alias **Test** auszuwählen. von
1. Amazon Lex Classic-Bots haben das Suffix „(Classic)“ an ihren Namen angehängt. Wenn Sie einen Classic-Bot ausgewählt haben, geben Sie den Alias, den Sie verwenden möchten, in das Feld **Alias** ein.
1. Für Amazon Lex V2-Bots haben Sie auch die Möglichkeit, manuell einen Bot-Alias-ARN festzulegen. Wählen Sie **Set manually** und geben Sie dann entweder den ARN des Bot-Alias ein, den Sie verwenden möchten, oder legen Sie den ARN mithilfe eines dynamischen Attributs fest.
1. Wählen Sie unter **Intents (Absichten)** **Add an intent (Eine Absicht hinzufügen)**.
1. Geben Sie eine weitere Absicht ein **AccountLookup**und wählen **Sie Weitere Absicht hinzufügen**. Die folgende Abbildung zeigt den Abschnitt **Intents**, der mit diesen Informationen konfiguriert wurde.
![\[Der Bereich Intents auf der Registerkarte Amazon Lex.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-get-customer-input3.png)
1. Geben Sie ein **SpeakToAgent**und wählen Sie **Speichern**.
### Beende den Flow-Prozess
In diesem Schritt beenden Sie das Hinzufügen von Teilen zum Flow, die ausgeführt werden, nachdem der Anrufer mit dem Bot interagiert hat:
1. Wenn der Anrufer 1 drückt, um seinen Kontostand abzufragen, verwenden Sie eine **Prompt (Aufforderung)** zum Abspielen einer Nachricht und zum Trennen des Anrufs.
1. Wenn der Anrufer 2 drückt, um mit einem Kundendienstmitarbeitern zu sprechen, verwenden Sie den Block **Set queue (Warteschlange festlegen)**, um die Warteschlange festzulegen und den Anrufer an die Warteschlange weiterzuleiten, die den Flow beendet.
Hier sind die Schritte zum Erstellen des Flows:
1. Ziehen Sie unter **Interact** einen **Play-Prompt-Block** in den Designer und verbinden Sie den **AccountLookup**Knoten des Blocks **Kundeneingabe abrufen** damit. Nachdem der Kunde seinen Kontostand vom Amazon-Lex-Bot erhalten hat, wird die Nachricht im **Play Prompt**-Block abgespielt.
1. Ziehen Sie unter **Terminate/Transfer (Beenden/Weiterleiten)** einen Block vom Typ **Disconnect (Trennen)** auf den Designer und verbinden Sie den Block **Play prompt (Aufforderung wiedergeben)** damit. Nach dem Abspielen der Nachricht wird der Anruf beendet.
Um die **SpeakToAgent**Absicht zu vervollständigen:
1. Fügen Sie einen Block **„Arbeitswarteschlange einrichten**“ hinzu und verbinden Sie ihn mit dem **SpeakToAgent**Knoten des Blocks **Kundeneingabe abrufen**.
1. Fügen Sie einen Block vom Typ **Transfer to queue (An Warteschlange weiterleiten)** hinzu.
1. Verbinden Sie den Success-Knoten des Blocks **Set customer queue flow** an **Transfer to queue**.
1. Wählen Sie **Save (Speichern)** und dann **Publish (Veröffentlichen)**.
Der fertige Flow sieht in etwa wie das folgende Bild aus. Der Flow beginnt mit dem Block **Get customer input**. Dieser Block führt zu „**Play prompt**“ oder „**Set customer queue**“.
![\[Der fertige Flow im Flow-Designer.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/lex-contactflow-designer.png)
**Tipp**
Wenn Ihr Unternehmen mehrere Gebietsschemas in einem einzigen Bot verwendet, fügen Sie am Anfang Ihres Flows einen [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md)-Block hinzu. Konfigurieren Sie diesen Block so, dass er [\$1 verwendet. LanguageCode](connect-attrib-list.md#attribs-system-table)Systemattribut.
## Zuweisen des Flows zu einer Telefonnummer
Wenn Kunden in Ihrem Contact Center anrufen, werden sie in den Flow geschickt, der der angerufenen Telefonnummer zugeordnet ist. Um den neuen Flow aktiv zu schalten, weisen Sie Ihrer Instance eine Telefonnummer zu.
1. Verwenden Sie die Amazon Connect console.
1. Klicken Sie auf **Weiterleitung, Telefonnummern**.
1. Wählen Sie auf der Seite „**Manage Phone numbers**“ die Telefonnummer aus, die Sie dem Flow zuweisen möchten.
1. Fügen Sie eine Beschreibung hinzu.
1. Wählen Sie im Menü **Flow/IVR** den Flow, den Sie gerade erstellt haben.
1. Wählen Sie **Speichern**.
## Versuchen Sie es\$1
Zum Testen des Bots und des GesprächsFlows rufen Sie die dem Flow zugewiesene Telefonnummer an. Folgen Sie den Anweisungen.
# Bewährte Methoden für das Arbeiten mit dem Chat-Kanal und Amazon Lex
Im Folgenden finden Sie einige bewährte Methoden für das Arbeiten mit dem Chat-Kanal und Amazon Lex.
+ Sie können für Sprach- und Chat-Kanal den gleichen Bot verwenden. Möglicherweise möchten Sie jedoch, dass der Bot kanalabhängig unterschiedlich reagiert. Beispiel: Sie möchten SSML für den Sprachkanal zurückgeben, damit eine Nummer als Telefonnummer gelesen wird, für den Chat soll aber normaler Text zurückgegeben werden. Dies ist möglich, indem Sie das Attribut **Channel (Kanal)** übergeben. Detaillierte Anweisungen finden Sie unter [So verwenden Sie denselben Amazon-Lex-Bot für Sprache und Chat](one-bot-voice-chat.md).
+ Für Sprache werden einige Wörter bestmöglich phonetisch geschrieben, um eine richtige Aussprache zu ermöglichen (z. B. bei Nachnamen). Wenn dies in Ihrem Szenario der Fall ist, berücksichtigen Sie es im Design des Bots. Sie können Sprach- und Chat-Bots auch getrennt halten.
+ Informieren Sie die Kundendienstmitarbeiter über den Bot. Wenn ein Kontakt mit dem Kundendienstmitarbeiter verbunden wird, sieht der Kundendienstmitarbeiter das gesamte Transkript in seinem Fenster. Das Transkript enthält Text sowohl vom Kunden als auch vom Bot.
# Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat
Interaktive Nachrichten sind umfangreiche Nachrichten, die eine Aufforderung und vorkonfigurierte Anzeigeoptionen enthalten, aus denen der Kunde wählen kann. Diese Nachrichten werden von Amazon Lex bereitgestellt und über Amazon Lex mithilfe einer AWS Lambda Funktion konfiguriert.
**Tipp**
Wenn Sie Apple Messages for Business integriert haben, finden Sie weitere Informationen unter [Interaktive Nachrichtentypen](https://register.apple.com/resources/messages/msp-rest-api/type-interactive) auf der Apple-Website.
## Gültigkeitsbeschränkungen
Es wird erwartet, dass die Grenzwerte für Zeichenfolgefelder (z. B. Titel, Untertitel usw.) vom Client durchgesetzt werden (d. h. von einer benutzerdefinierten Oberfläche oder dem gehosteten Kommunikations-Widget). Die [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)API prüft nur, ob die Gesamtgröße der Zeichenfolge weniger als 20 KB beträgt.
+ Wenn Sie das gehostete Kommunikations-Widget verwenden, ohne es anzupassen, und die Zeichenfolge die Feldgrenzen überschreitet, wird sie auf der Benutzeroberfläche gekürzt und ein Auslassungszeichen (...) wird angehängt. Sie können festlegen, wie Feldbeschränkungen durchgesetzt werden, indem Sie das Widget anpassen.
+ Wenn Sie die Integration mit anderen Plattformen (wie Apple Messages for Business) durchführen, lesen Sie sich die Beschränkungen in diesem Thema für Amazon Connect und die Grenzwerte in der Dokumentation für die andere Plattform durch. Beispielsweise werden Schnellantworten auf älteren Versionen von iOS nicht unterstützt.
Alle anderen Feldgrenzen müssen eingehalten werden, damit die Nachricht erfolgreich gesendet werden kann.
## Vorlagen für die Anzeige von Nachrichten
Amazon Connect bietet die folgenden Vorlagen für die Nachrichtenanzeige. Verwenden Sie sie, um Kunden in einem Chat Informationen zur Verfügung zu stellen:
+ [Listenauswahl](#list-picker)
+ [Zeitauswahl](#time-picker)
+ [Panel](#panel)
+ [Schnelle Antwort](#quick-reply-template)
+ [Karussell](#carousel-template)
+ [Apple-Formularvorlage](#apple-form-template)
+ [Apple-Pay-Vorlage](#apple-pay-template)
+ [iMessage-App-Vorlage](#imessage-app-template)
+ [WhatsApp Liste](#whatsapp-list)
+ [WhatsApp Schaltfläche „Antworten“](#whatsapp-reply-button)
+ [Umfangreiche Formatierung von Titeln und Untertiteln](#rich-link-formatting)
Diese Vorlagen definieren, wie die Informationen gerendert werden und welche Informationen in der Chat-Oberfläche angezeigt werden. Wenn interaktive Nachrichten über den Chat gesendet werden, überprüfen Flows, ob das Nachrichtenformat einer dieser Vorlagen entspricht.
## Listen-Picker-Vorlage
Verwenden Sie die Vorlage für die Listenauswahl, um dem Kunden eine Liste mit bis zu sechs Auswahlmöglichkeiten zu präsentieren. Jede Auswahl kann ein eigenes Bild haben.
Die folgenden Bilder zeigen zwei Beispiele dafür, wie die Vorlage für die Listenauswahl Informationen in einem Chat wiedergibt.
+ Ein Bild zeigt drei Schaltflächen, jede mit dem Namen einer Frucht im Text: Apfel, Orange, Banane.
+ Das zweite Bild zeigt ein Bild eines Ladens und darunter drei Schaltflächen, jeweils mit dem Namen, dem Bild und dem Preis der Frucht.
![\[Die Listenauswahl-Vorlage, die Informationen in einem Chat wiedergibt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/interactive-messages-listpicker-images2.png)
Der folgende Code ist die Listenauswahlvorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
+ **Fettgedruckter Text** gibt einen obligatorischen Parameter an.
+ In einigen Fällen ist das übergeordnete Element eines Felds nicht obligatorisch, die Felder darin aber schon. Dann ist das Feld ein Pflichtfeld. Sehen Sie sich zum Beispiel die `data.replyMessage`-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist `title` erforderlich. Andernfalls ist eine vollständige `replyMessage` optional.
```
{
"templateType":"ListPicker",
"version":"1.0",
"data":{
"replyMessage":{
"title":"Thanks for selecting!",
"subtitle":"Produce selected",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg",
"imageDescription":"Select a produce to buy"
},
"content":{
"title":"What produce would you like to buy?",
"subtitle":"Tap to select option",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg",
"imageDescription":"Select a produce to buy",
"elements":[
{
"title":"Apple",
"subtitle":"$1.00",
"imageType":"URL",
"imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg"
},
{
"title":"Orange",
"subtitle":"$1.50",
"imageType":"URL",
"imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/orange_17.7kb.jpg",
},
{
"title":"Banana",
"subtitle":"$10.00",
"imageType":"URL",
"imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/banana_7.9kb.jpg",
"imageDescription":"Banana"
}
]
}
```
### Limits für die Auswahl auflisten
In der folgenden Tabelle sind die Grenzwerte für jedes der Listenauswahlelemente aufgeführt, falls Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Um unbegrenzt viele Optionen zu senden, implementieren Sie Aktionsschaltflächen in Ihrer Anwendung. Weitere Informationen finden Sie unter [Implementation of action buttons in interactive message list picker/panel](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md).
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/interactive-messages.html)
**Anmerkung**
Wenn Sie das `targetForLinks`-Feld und das Amazon-Connect-Kommunikations-Widget verwenden, müssen Sie zum Öffnen von Links auf derselben Browser-Registerkarte das folgende Attribut zum Widget-Codeausschnitt hinzufügen, damit der aktuelle iframe Links innerhalb derselben Registerkarte öffnen und darin navigieren kann:
```
amazon_connect('updateSandboxAttributes', 'allow-scripts allow-same-origin allow-popups allow-downloads allow-top-navigation-by-user-activation')
```
## Vorlage für die Zeitauswahl
Die Vorlage für die Zeitauswahl ist nützlich, damit Kunden Termine planen können. Sie können dem Kunden in einem Chat bis zu 40 Zeitfenster zur Verfügung stellen.
Die folgenden Bilder zeigen zwei Beispiele dafür, wie die Vorlage für die Zeitauswahl Informationen in einem Chat wiedergibt.
+ Ein Bild zeigt ein Datum und darunter ein Zeitfenster.
+ Das zweite Bild zeigt ein Datum und darunter zwei Zeitfenster.
![\[Die Zeitauswahl-Vorlage, die Informationen in einem Chat wiedergibt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/interactive-messages-timepicker.png)
Die folgende Abbildung zeigt die Zeitauswahl mit einem Bild.
**Anmerkung**
Wenn Sie diese Nachrichtenvorlage mit dem Kanal [Apple Messages for Business](apple-messages-for-business.md) verwenden und kein Bild hinzufügen, fügt Amazon Connect sowohl in der Antwort als auch in der Antwortnachricht ein Standardbild hinzu.
![\[Die Zeitauswahl mit einem Bild.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/interactive-messages-timepicker-with-image.png)
Der folgende Code ist die Zeitauswahlvorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
+ **Fettgedruckter Text** gibt einen obligatorischen Parameter an.
+ In einigen Fällen ist das übergeordnete Element eines Felds nicht obligatorisch, die Felder darin aber schon. Dann ist das Feld ein Pflichtfeld. Sehen Sie sich zum Beispiel die `data.replyMessage`-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist `title` erforderlich. Andernfalls ist eine vollständige `replyMessage` optional.
```
{
"templateType":"TimePicker",
"version":"1.0",
"data":{
"replyMessage":{
"title":"Thanks for selecting",
"subtitle":"Appointment selected",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/booked.jpg",
"imageDescription":"Appointment booked"
},
"content":{
"title":"Schedule appointment",
"subtitle":"Tap to select option",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/calendar.jpg",
"imageDescription":"Appointment booked",
"timeZoneOffset":-450,
"location":{
"latitude":47.616299,
"longitude":-122.4311,
"title":"Oscar",
"radius":1,
},
"timeslots":[
{
"date" : "2020-10-31T17:00+00:00",
"duration": 60,
},
{
"date" : "2020-11-15T13:00+00:00",
"duration": 60,
},
{
"date" : "2020-11-15T16:00+00:00",
"duration": 60,
}
],
}
}
}
}
```
### Limits für die Zeitauswahl
In der folgenden Tabelle sind die Grenzwerte für jedes der Time-Picker-Elemente aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/interactive-messages.html)
## Panel-Vorlage
Mithilfe der Panel-Vorlage können Sie dem Kunden unter einer Frage bis zu 10 Auswahlmöglichkeiten anbieten. Sie können jedoch nur ein Bild und nicht jeder Auswahl ein Bild hinzufügen.
Die folgende Abbildung zeigt ein Beispiel dafür, wie die Panel-Vorlage Informationen in einem Chat wiedergibt. Es zeigt ein Bild oben in der Nachricht und unter dem Bild wird eine Aufforderung angezeigt, in der gefragt wird, *wie kann ich helfen? Tippen Sie, um eine Option auszuwählen*. Nach der Aufforderung werden dem Kunden drei Optionen angezeigt: **Check self-service options**, **Talk to an agent**, **End chat**.
![\[Die Panel-Vorlage, die Informationen in einem Chat wiedergibt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/interactive-messages-panel1.png)
Der folgende Code ist die Panel-Vorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
+ **Fettgedruckter Text** gibt einen obligatorischen Parameter an.
+ In einigen Fällen ist das übergeordnete Element eines Felds nicht obligatorisch, die Felder darin aber schon. Dann ist das Feld ein Pflichtfeld. Sehen Sie sich zum Beispiel die `data.replyMessage`-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist ein `title` erforderlich. Andernfalls ist eine vollständige `replyMessage` optional.
```
{
"templateType":"Panel",
"version":"1.0",
"data":{
"replyMessage":{
"title":"Thanks for selecting!",
"subtitle":"Option selected",
},
"content":{
"title":"How can I help you?",
"subtitle":"Tap to select option",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/company.jpg",
"imageDescription":"Select an option",
"elements":[
{
"title":"Check self-service options",
},
{
"title":"Talk to an agent",
},
{
"title":"End chat",
}
]
}
}
}
```
### Grenzwerte für das Panel
In der folgenden Tabelle sind die Grenzwerte für jedes der Panel-Elemente aufgeführt, falls Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Um unbegrenzt viele Optionen zu senden, implementieren Sie Aktionsschaltflächen in Ihrer Anwendung. Weitere Informationen finden Sie unter [Implementation of action buttons in interactive message list picker/panel](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/master/.github/docs/InteractiveMessageActionButtonImplementation.md).
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/interactive-messages.html)
## Schnellantwort-Vorlage
Verwenden Sie Schnellantwortnachrichten, um einfache Antworten von Kunden und von Ihnen an Kunden in einer Inline-Liste zu erhalten. Bilder werden für Schnellantworten nicht unterstützt.
Die Schnellantwort-Vorlage zeigt in einem Beispiel, wie die Schnellantwort-Vorlage Informationen in einem Chat wiedergibt.
![\[Die Panel-Vorlage, die Informationen in einem Chat wiedergibt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/quick-reply-template.png)
Der folgende Code ist die Schnellantwortvorlage, die Sie in Ihrem Lambda verwenden können.
```
{
"templateType": "QuickReply",
"version": "1.0",
"data": {
"replyMessage": {
"title": "Thanks for selecting!"
},
"content": {
"title": "Which department would you like?",
"elements": [{
"title": "Billing"
},
{
"title": "Cancellation"
},
{
"title": "New Service"
}
]
}
}
}
```
### Schnellantwort-Limits
In der folgenden Tabelle sind die Grenzwerte für jedes der Schnellantwortelemente aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/interactive-messages.html)
## Karussell-Vorlage
Verwenden Sie Karussells, um Kunden bis zu 5 Listenauswahlfelder oder Panels in einer einzigen Nachricht anzuzeigen. Ähnlich wie bei der Listenauswahl und der Zeitauswahl können Sie dem Karussell mithilfe des SHOW\$1MORE-Features weitere Optionen hinzufügen.
Das folgende GIF zeigt ein Beispiel dafür, wie die Karussellvorlage Informationen in einem Chat wiedergibt. Kunden scrollen mithilfe der Pfeiltasten nach links und rechts durch das Bilderkarussell.
![\[Ein Karussell im Chat-Erlebnis eines Kunden.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/carousel-interactive.gif)
Die folgende Abbildung zeigt zwei Hyperlinks für **Learn More**, bei denen es sich um Beispiele für Hyperlink-Elemente in der Karussellauswahl handelt.
![\[Ein Karussell-Picker mit Hyperlinks.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/carousel-interactive1.png)
Der folgende Code ist die Karussellvorlage, die Sie in Ihrem Lambda verwenden können.
```
{
"templateType": "Carousel",
"version": "1.0",
"data": {
"content": {
"title": "View our popular destinations",
"elements": [
{
"templateIdentifier": "template0",
"templateType": "Panel",
"version": "1.0",
"data": {
"content": {
"title": "California",
"subtitle": "Tap to select option",
"elements": [
{
"title": "Book flights"
},
{
"title": "Book hotels"
},
{
"title": "Talk to agent"
}
]
}
}
},
{
"templateIdentifier": "template1",
"templateType": "Panel",
"version": "1.0",
"data": {
"content": {
"title": "New York",
"subtitle": "Tap to select option",
"elements": [
{
"title": "Book flights"
},
{
"title": "Book hotels"
},
{
"title": "Talk to agent"
}
]
}
}
}
]
}
}
}
```
Für Benutzer des Widgets für gehostete Kommunikation:
+ Die Auswahlen in der Karussellvorlage führen zu einer JSON-Zeichenkettenantwort, die wie im folgenden Beispiel strukturiert ist und an Lambda zurückgesendet wird (andere interaktive Nachrichtentypen geben eine reguläre Zeichenkettenantwort mit nur einem `selectionText`-Wert zurück):
```
{
templateIdentifier: "template0",
listTitle: "California",
selectionText: "Book hotels"
}
```
+ In Karussells können Sie Hyperlinks in den Listenelementen angeben. picker/panel Um einen Hyperlink anstelle einer Schaltfläche zu erstellen, fügen Sie die folgenden zusätzlichen Felder für das Element hinzu, bei dem es sich um einen Hyperlink handeln soll:
```
{
title: "Book flights",
...
type: "hyperlink",
url: "https://www.example.com/Flights"
}
```
### Karussell-Limits
Die Limits für jedes Karussellelement sind in der folgenden Tabelle aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/interactive-messages.html)
## Apple-Formularvorlage
**Anmerkung**
Diese Vorlage gilt nur für Gesprächsabläufe mit Apple Messages for Business.
Ein Unternehmen kann seinen Endkunden eine interaktive Formularnachricht über eine einzelne Nachricht senden, die mehrere Seiten mit angeforderten Eingaben enthält. Wenn die Nachricht auf dem Apple-Gerät eines Endkunden eingeht, kann dieser das Formular öffnen, durch die Seiten navigieren und für jede Seite eine Antwort angeben, bevor er alle Antworten am Ende des Formulars absendet.
Beispielsweise können Unternehmen Apple-Formulare für verschiedene Zwecke wie Auswahlprozesse, Kundenbefragungen und Kontoerstellung/-registrierung verwenden.
**Warnung**
Interaktive Nachrichteninhalte und Antworten von Endkunden werden im Transkript der Kontaktdatensätze gespeichert und können von anderen Chat-Teilnehmern und Kontaktanalysten mit Zugriff auf die Transkripte eingesehen werden. Um zu verhindern, dass personenbezogene Daten **nach Beendigung des Kontakts in Ihrem Kontaktdatensatz erscheinen, sollten Sie den** [Block Aufzeichnungs- und Analyseverhalten festlegen](set-recording-behavior.md) in Ihrem step-by-step Guide-Flow verwenden und die Schwärzung [Contact Lensvertraulicher](sensitive-data-redaction.md) Daten aktivieren und aktivieren. Vollständige Informationen zur Aktivierung der PII-Schwärzung finden Sie unter [Aktivieren der Schwärzung sensibler Daten](enable-analytics.md#enable-redaction).
Folgende Seitentypen werden unterstützt:
+ **ListPicker**: eine Liste von Optionen, aus denen der Benutzer mit Bildunterstützung auswählen muss.
+ **WheelPicker**: Ähnlich wie, ListPicker aber die Auswahl erfolgt über ein scrollbares Optionsrad.
+ **DatePicker**: eine Kalenderansicht, in der der Benutzer ein Datum auswählen kann.
+ **Input**: Ein Textfeld, das der Benutzer ausfüllen muss.
Der folgende Code ist ein Beispiel für eine Apple-Formularvorlage, die Sie in Ihrer Lambda-Funktion verwenden können.
**Anmerkung**
**Fettgedruckter Text** ist ein obligatorischer Parameter.
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder.
Beispiel für ein einfaches Umfrageformular:
```
{
"templateType": "AppleForm",
"version": "1.0",
"data": {
"content": {
"title": "Survey",
"pages": [
{
"pageType": "DatePicker",
"title": "Date you visited",
"subtitle": "When did you last visit?",
"minDate": "2024-01-02"
},
{
"pageType": "ListPicker",
"title": "Rating",
"subtitle": "How do you rate the experience?",
"items": [
{
"title": "Good",
"imageType": "URL",
"imageData": "https://mybucket.s3.us-west-2.amazonaws.com/good.jpg"
},
{
"title": "Okay",
"imageType": "URL",
"imageData": "https://mybucket.s3.us-west-2.amazonaws.com/okay.jpg"
},
{
"title": "Poor",
"imageType": "URL",
"imageData": "https://mybucket.s3.us-west-2.amazonaws.com/poor.jpg"
}
]
},
{
"pageType": "ListPicker",
"title": "Dine type",
"subtitle": "Select all dine types that apply",
"multiSelect": true,
"items": [
{
"title": "Pickup"
},
{
"title": "Dine-in"
},
{
"title": "Delivery"
}
]
},
{
"pageType": "WheelPicker",
"title": "Visits",
"subtitle": "How often do you visit?",
"items": [
{
"title": "Often"
}
{
"title": "Sometimes"
},
{
"title": "Rarely"
}
]
},
{
"pageType": "Input",
"title": "Additional notes",
"subtitle": "Anything else you'd like to mention about your visit?",
"multiLine": true
}
]
}
}
}
```
### Einschränkungen für Apple-Formulare
#### InteractiveMessage
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| Version | Zeichenfolge | Ja | Versionsnummer. Zulässiger Wert: „1.0“ |
| templateType | TemplateType | Ja | Typ der interaktiven Nachrichtenvorlage. Zulässige Werte: [“ ListPicker „," TimePicker „, „Panel“, "QuickReply„, „Carousel“, "ViewResource„," AppleForm„] |
| daten | InteractiveMessageData | Ja | Daten zu interaktivem Messaging |
#### InteractiveMessageData
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| Inhalt | InteractiveMessageContent | Ja | Hauptinhalt der interaktiven Nachricht |
| replyMessage | ReplyMessage | Nein | Konfiguration der Nachrichtenanzeige nach dem Senden einer Antwort auf eine interaktive Nachricht |
#### AppleFormContent
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| title | Zeichenfolge | Ja | Titel der obersten Ebene für das Formular. Wird in Apple in der Sprechblase für empfangene Nachrichten und beim Rendern von Transkripten angezeigt |
| subtitle | Zeichenfolge | Nein | Wird als Untertitel verwendet in ReceivedMessage |
| imageType | Zeichenfolge | Nein | Gültige Werte: „URL“ Wird für das Bild verwendet in ReceivedMessage |
| imageData | Zeichenfolge | Nein | S3-Bild-URL Wird für Bild in verwendet ReceivedMessage |
| pages | AppleFormPage[] | Ja | Liste der Formularseiten |
| showSummary | Boolesch | Nein | Gibt an, ob eine Übersichtsseite mit Antworten angezeigt werden soll, die vor dem Absenden überprüft werden sollen. Standardeinstellung: Falsch (keine confirmation/summary Seite) |
| splashPage | AppleFormSplashPage | Nein | Erste Splash-Seite, die vor den eigentlichen Seiten angezeigt wird. Standard: Keine Splash-Seite |
#### AppleFormSplashPage
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| title | Zeichenfolge | Ja | Titel der Splash-Seite |
| subtitle | Zeichenfolge | Nein | Untertitel/Hauptteil der Splash-Seite |
| imageType | ImageType | Nein | Wird angezeigt, wenn das Bild auf der Splash-Seite angezeigt wird. Zulässiger Wert: „URL“. Standard: Kein Bild wird angezeigt |
| imageData | Zeichenfolge | Nein | Für imageType=„URL“ ist dies der URL-Wert. Standard: Kein Bild wird angezeigt |
| buttonTitle | Zeichenfolge | Ja | Text der Schaltfläche „Weiter“. Von Apple benötigt. Standardtext mit Lokalisierung wird nicht unterstützt |
#### AppleFormPage
+ Basismodell für Formularseiten. Spezifische Seitentypen erweitern dieses Modell.
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| pageType | ApplePageType | Ja | Enum für Seitentyp. Zulässige Werte: ["Eingabe“, "DatePicker„," WheelPicker „," ListPicker „] |
| title | Zeichenfolge | Ja | Seitentitel |
| subtitle | Zeichenfolge | Ja | Seiten-Untertitel. Wird auf der Bestätigungsseite verwendet. |
#### AppleFormDatePickerPage
**AppleFormDatePickerPage**erweitert [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| pageType | ApplePageType | Ja | Wert: "DatePicker“ |
| labelText | Zeichenfolge | Nein | Text, der neben der Datumseingabe angezeigt wird. Siehe Beispiel-Screenshots im Anhang |
| helperText | Zeichenfolge | Nein | Hilfstext, der unter der Datumseingabe angezeigt wird. Siehe Beispiel-Screenshots im Anhang. Standard: Kein Hilfstext |
| dateFormat | Zeichenfolge | Nein | ISO-8601-Datumsformat. Standard: MM/dd/yyyy |
| startDate | Zeichenfolge | Nein | Anfängliches/voreingestelltes ausgewähltes Datum im gültigen Datumsformat. Standard: Aktuelles Datum für den Endbenutzer, an dem die Nachricht gesendet wird |
| minDate | Zeichenfolge | Nein | Das Mindestdatum, das im gültigen Datumsformat ausgewählt werden darf. Standard: Kein Mindestdatum |
| maxDate | Zeichenfolge | Nein | Maximales Datum, das im gültigen Datumsformat ausgewählt werden darf. Standard: Aktuelles Datum für den Endbenutzer, an dem die Nachricht gesendet wird |
#### AppleFormListPickerPage
**AppleFormListPickerPage**erweitert [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| pageType | ApplePageType | Ja | Wert: "ListPicker“ |
| multiSelect | Boolesch | Nein | Ermöglicht die Auswahl mehrerer Elemente. Standard: falsch (Einzelauswahl) |
| items | AppleFormListPickerPageItem[] | Ja | Liste der Elemente auf der Listenseite |
#### AppleFormListPickerPageItem
**AppleFormListPickerPageItem**erweitert [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| title | Zeichenfolge | Ja | Anzeigetext des Elements |
| imageType | ImageType | Nein | Wird angezeigt, wenn ein Bild innerhalb eines Elements angezeigt wird: Zulässiger Wert: „URL“. Standard: Es wird kein Bild angezeigt |
| imageData | Zeichenfolge | Nein | Für imageType=„URL“ ist dies der URL-Wert. Standard: Kein Bild wird angezeigt |
**Anmerkung**
Ähnliches Bildmodell wie bestehende interaktive Nachrichtenmodelle (ListPicker), außer dass `imageDescription` es nicht enthalten ist. Es wird für Bild-Alt-Text in Chat-Widgets/Web-Chats verwendet und für interaktive Apple-Nachrichten ignoriert.
#### AppleFormWheelPickerPage
**AppleFormWheelPickerPage**erweitert [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| pageType | ApplePageType | Ja | Wert: "WheelPicker“ |
| items | AppleFormWheelPickerPageItem[] | Ja | Liste der Wheelpicker-Elemente |
| labelText | Zeichenfolge | Nein | Text, der neben der Eingabe angezeigt wird. Siehe Beispiel-Screenshots im Anhang |
#### AppleFormWheelPickerPageItem
**AppleFormWheelPickerPageItem**erweitert [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| title | Zeichenfolge | Ja | Anzeigetext des Auswahlelements |
#### AppleFormInputPage
**AppleFormInputPage**dehnt [AppleFormPage](#apple-forms-limits-appleformpage)
| Feld | Typ | Erforderlich | Beschreibung/Hinweise |
| --- | --- | --- | --- |
| pageType | ApplePageType | Ja | Wert: „Input“ |
| labelText | Zeichenfolge | Nein | Text, der neben dem Eingabefeld angezeigt wird. Siehe Beispiel-Screenshots im Anhang |
| helperText | Zeichenfolge | Nein | Zusätzlicher Text, der unter dem Eingabefeld angezeigt wird. Standard: Kein Hilfstext |
| placeholderText | Zeichenfolge | Nein | Platzhaltertext, der anfänglich angezeigt werden soll, wenn keine Eingabe vorhanden ist. Standard: Platzhaltertext „(Optional)“ oder „(Erforderlich)“ |
| prefixText | Zeichenfolge | Nein | Präfixtext, der neben der Eingabe angezeigt werden soll. Beispiel: '\$1', wenn die Eingabe ein Geldwert ist. Standard: Kein Präfixtext |
| erforderlich | Boolesch | Nein | Gibt an, ob der Endbenutzer Eingaben bereitstellen muss. Standard: false |
| multiLine | Boolesch | Nein | Gibt an, ob mehrzeilige Eingaben bereitgestellt werden können. Standard: false (einzeilig) |
| maxCharCount | Zahl | Nein | Maximale Zeichenanzahl der Eingabe. Auf dem Apple-Client erzwungen. Standard: Keine Begrenzung |
| Regex | Zeichenfolge | Nein | Regex-Zeichenfolge, um Einschränkungen für die Eingabe festzulegen. Standard: Keine Regex-Einschränkungen |
| keyboardType | Zeichenfolge | Nein | Legt fest, welcher Tastaturtyp angezeigt wird, wenn der Endbenutzer die Eingabe bereitstellt. Zulässige Werte: Entspricht Apple. Siehe [docs](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message). Einige zulässige Werte: numberPad, phonePad, emailAddress |
| textContentType | Zeichenfolge | Nein | Unterstützung bei Vorschlägen zum automatischen Ausfüllen auf Apple-Geräten. Zulässige Werte: Wie bei Apple. Siehe [docs](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#form-message). Einige der zulässigen Werte: TelephoneNumber, FamilyName fullStreetAddress |
## Apple-Pay-Vorlage
**Anmerkung**
Diese Vorlage gilt nur für Gesprächsabläufe mit Apple Messages for Business.
Verwenden Sie die Apple-Pay-Vorlage, um Kunden eine einfache und sichere Möglichkeit zu bieten, Waren und Services über Apple Messages for Business mit Apple Pay zu kaufen.
Der folgende Code ist die Apple-Pay-Vorlage, die Sie in Ihrer Lambda-Funktion verwenden können.
**Anmerkung**
**Fettgedruckter Text** ist ein obligatorischer Parameter.
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder.
```
{
"templateType":"ApplePay",
"version":"1.0",
"data":{
"content":{
"title":"Halibut",
"subtitle":"$63.99 at Sam's Fish",
"imageType":"URL",
"imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fish.jpg",
"payment": {
"endpoints": {
"orderTrackingUrl": "https://sams.example.com/orderTrackingUrl/",
"paymentGatewayUrl": "https://sams.example.com/paymentGateway/",
"paymentMethodUpdateUrl": "https://sams.example.com/paymentMethodUpdate/",
"shippingContactUpdateUrl": "https://sams.example.com/shippingContactUpdate/",
"shippingMethodUpdateUrl": "https://sams.example.com/shippingMethodUpdate/",
"fallbackUrl": "https://sams.example.com/paymentGateway/"
},
"merchantSession": {
"epochTimestamp": 1525730094057,
"expiresAt": 1525730094057,
"merchantSessionIdentifier": "PSH40080EF4D6.........9NOE9FD",
"nonce": "fe72cd0f",
"merchantIdentifier": "merchant.com.sams.fish",
"displayName": "Sam's Fish",
"signature": "308006092a8.......09F0W8EGH00",
"initiative": "messaging",
"initiativeContext": "https://sams.example.com/paymentGateway/",
"signedFields": [
"merchantIdentifier",
"merchantSessionIdentifier",
"initiative",
"initiativeContext",
"displayName",
"nonce"
],
},
"paymentRequest": {
"applePay": {
"merchantCapabilities": [
"supports3DS",
"supportsDebit",
"supportsCredit"
],
"merchantIdentifier": "merchant.com.sams.fish",
"supportedNetworks": [
"amex",
"visa",
"discover",
"masterCard"
]
},
"countryCode": "US",
"currencyCode": "USD",
"lineItems": [
{
"amount": "59.00",
"label": "Halibut",
"type": "final"
},
{
"amount": "4.99",
"label": "Shipping",
"type": "final"
}
],
"requiredBillingContactFields": [
"postalAddress"
],
"requiredShippingContactFields": [
"postalAddress",
"phone",
"email",
"name"
],
"shippingMethods": [
{
"amount": "0.00",
"detail": "Available within an hour",
"identifier": "in_store_pickup",
"label": "In-Store Pickup"
},
{
"amount": "4.99",
"detail": "5-8 Business Days",
"identifier": "flat_rate_shipping_id_2",
"label": "UPS Ground"
},
{
"amount": "29.99",
"detail": "1-3 Business Days",
"identifier": "flat_rate_shipping_id_1",
"label": "FedEx Priority Mail"
}
],
"total": {
"amount": "63.99",
"label": "Sam's Fish",
"type": "final"
},
"supportedCountries" : [
"US",
"CA",
"UK",
"JP",
"CN"
]
}
},
"requestIdentifier" : "6b2ca008-1388-4261-a9df-fe04cd1c23a9"
}
}
}
```
### Einschränkungen für Apple Pay
| Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
| --- | --- | --- | --- | --- | --- |
| | templateType | Ja | | | Gültiger Vorlagentyp |
| | Daten | Ja | | | |
| | Version | Ja | | | Muss „1.0“ sein. |
| Daten | Inhalt | Ja | | | |
| Inhalt | title | Ja | 1 | 512 | Der Titel der Sprechblase für die empfangene Nachricht |
| | subtitle | Nein | 0 | 512 | Untertitel, der unter dem Titel der Sprechblase für empfangene Nachrichten angezeigt werden soll |
| | imageData | Nein | 0 | 200 | Muss eine gültige öffentlich zugängliche URL sein |
| | imageType | Nein | 0 | 50 | Muss „URL“ sein |
| | Bezahlung | Ja | | | Ein Wörterbuch mit Feldern, die die Einzelheiten einer Apple-Pay-Anfrage enthalten. |
| | requestIdentifier | Nein | | | Zeichenfolge, Eine Kennung für die ApplePay Anfrage. Falls nicht angegeben, wird eine UUID generiert und verwendet. |
| Zahlung | Endpunkte | Ja | | | Ein Wörterbuch mit den Endpunkten für Zahlungsabwicklung, Kontaktaktualisierungen und Auftragsverfolgung. |
| | merchantSession | Ja | | | Ein Wörterbuch mit der Zahlungssitzung, das von Apple Pay nach der Anforderung einer neuen Zahlungssitzung bereitgestellt wird. |
| | paymentRequest | Ja | | | Ein Wörterbuch mit Informationen zur Zahlungsanforderung |
| Endpunkte | paymentGatewayUrl | Ja | | | Zeichenfolge. Wird von Apple Pay aufgerufen, um die Zahlung über den Zahlungsanbieter abzuwickeln. Die URL sollte mit der URL im Feld „initiativeContext“ der Händlersitzung übereinstimmen. |
| | fallbackUrl | Nein | | | Eine URL, die in einem Webbrowser geöffnet wird, damit der Kunde den Kauf abschließen kann, falls auf seinem Gerät keine Zahlungen mit Apple Pay möglich sind. Falls angegeben, muss fallbackUrl übereinstimmen. paymentGatewayUrl |
| | orderTrackingUrl | Nein | | | Wird nach Abschluss der Bestellung von Messages for Business aufgerufen und bietet Ihnen die Möglichkeit, die Bestellinformationen in Ihrem System zu aktualisieren. |
| | paymentMethodUpdateUrl | Nein | | | Wird von Apple Pay aufgerufen, wenn der Kunde die Zahlungsmethode ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt. |
| | shippingContactUpdateUrl | Nein | | | Wird von Apple Pay aufgerufen, wenn der Kunde seine Lieferadresse ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt. |
| | shippingMethodUpdateUrl | Nein | | | Wird von Apple Pay aufgerufen, wenn der Kunde die Versandmethode ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt. |
| merchantSession | displayName | Ja | 1 | 64 | Zeichenfolge. Der kanonische Name für Ihren Shop, der zur Anzeige geeignet ist. Lokalisieren Sie den Namen nicht. |
| | initiative | Ja | | | Zeichenfolge. Muss „messaging“ sein |
| | initiativeContext | Ja | | | Zeichenfolge. Übergeben Sie die URL Ihres Zahlungsgateways. |
| | merchantIdentifier | Ja | | | Zeichenfolge. Eine eindeutige Kennung, die einen Händler für Apple Pay darstellt. |
| | merchantSessionIdentifier | Ja | | | Zeichenfolge. Eine eindeutige Kennung, die die Sitzung eines Händlers für Apple Pay darstellt. |
| | epochTimestamp | Ja | | | Zeichenfolge. Die Zeitdarstellung als Anzahl der Sekunden, die seit 0.00 Uhr UTC am Donnerstag, 1. Januar 1970 vergangen sind. |
| | expiresAt | Ja | | | Zeichenfolge. Die Zeitdarstellung als Anzahl der Sekunden, die seit 0.00 Uhr UTC am Donnerstag, 1. Januar 1970 vergangen sind. |
| | nonce | Nein | | | Binary. Eine einmalig verwendbare Zeichenfolge, die die Integrität der Interaktion überprüft. |
| | signature | Nein | | | Binary. Ein Hash des öffentlichen Schlüssels, der zum Signieren der Interaktionen verwendet wird. |
| | signedFields | Nein | | | Liste von Zeichenfolgen, die die signierten Eigenschaften enthält. |
| paymentRequest | applePay | Ja | | | Ein Wörterbuch, das die Apple-Pay-Konfiguration beschreibt. |
| | countryCode | Ja | | | Zeichenfolge. Der zweibuchstabige ISO-3166-Ländercode des Händlers. |
| | currencyCode | Ja | | | Zeichenfolge. Der dreibuchstabige ISO-4217-Währungscode für die Zahlung. |
| | lineItems | Nein | | | Eine Reihe von Zeilenelementen, die Zahlungen und zusätzliche Gebühren erläutern. Zeilenelemente sind nicht erforderlich. Das Array darf jedoch nicht leer sein, wenn der lineItems-Schlüssel vorhanden ist. |
| | total | Ja | | | Ein Wörterbuch, das die Summe enthält. Der Gesamtbetrag muss größer als Null sein, um die Validierung zu bestehen. |
| | requiredBillingContactFelder | Nein | | | Die Liste der erforderlichen Rechnungsinformationen des Kunden, die zur Bearbeitung der Transaktion benötigt werden. Eine Liste der möglichen Zeichenketten finden Sie unter [requiredBillingContactFelder](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216120-requiredbillingcontactfields). Es sind nur die Kontaktfelder erforderlich, die für die Zahlungsabwicklung benötigt werden. Die Anforderung unnötiger Felder erhöht die Komplexität der Transaktion, was die Wahrscheinlichkeit erhöhen kann, dass der Kunde die Zahlungsanforderung abbricht. |
| | requiredShippingContactFelder | Nein | | | Die Liste der Versand- oder Kontaktinformationen, die der Kunde zur Ausführung der Bestellung angeben muss. Wenn Sie beispielsweise die E-Mail-Adresse oder Telefonnummer des Kunden benötigen, schließen Sie diesen Schlüssel ein. Eine Liste der möglichen Zeichenketten finden Sie unter [requiredShippingContactFelder](https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/2216121-requiredshippingcontactfields). |
| | shippingMethods | Nein | | | Ein Array, das die verfügbaren Versandmethoden auflistet. Auf dem Apple Pay-Zahlungsblatt wird die erste Versandart aus dem Array als Standardversandart angezeigt. |
| | supportedCountries | Nein | | | Ein Array von Ländern, die unterstützt werden sollen. Führen Sie jedes Land mit seinem ISO-3166-Ländercode auf. |
| applePay | merchantIdentifier | Ja | | | Eine eindeutige Kennung, die einen Händler für Apple Pay darstellt. |
| | merchantCapabilities | Ja | | | Ein Array von Zahlungsmöglichkeiten, die vom Händler unterstützt werden. Das Array muss „supports3DS“ enthalten und kann optional „supportsCredit“, „supportsDebit“ und „supportsEMV“ enthalten. |
| | supportedNetworks | Ja | | | Ein Array von Zahlungsnetzwerken, die vom Händler unterstützt werden. Das Array muss einen oder mehrere der folgenden Werte enthalten: „amex“, „discover“, „jcb“, „masterCard“, „privateLabel“ oder „visa“ |
| lineItem | amount | Ja | | | Der Geldbetrag für den Einzelposten. |
| | label | Ja | | | Eine kurze, lokalisierte Beschreibung des Einzelpostens. |
| | geben Sie ein | Nein | | | Ein Wert, der angibt, ob der Einzelposten abgeschlossen oder ausstehend ist. |
| total | amount | Ja | | | Der Gesamtbetrag der Zahlung. |
| | label | Ja | | | Eine kurze, lokalisierte Beschreibung der Zahlung. |
| | Typ | Nein | | | Ein Wert, der angibt, ob die Zahlung abgeschlossen oder ausstehend ist. |
| shippingMethods | amount | Ja | | | Zeichenfolge. Die mit dieser Versandart verbundenen nicht negativen Kosten. |
| | detail | Ja | | | Zeichenfolge. Zusätzliche Beschreibung der Versandart. |
| | label | Ja | | | Zeichenfolge. Eine kurze Beschreibung der Versandart. |
| | identifier | Ja | | | Zeichenfolge. Ein vom Kunden definierter Wert, der zur Identifizierung dieser Versandart verwendet wird. |
## iMessage-App-Vorlage
**Anmerkung**
Diese Vorlage gilt nur für Gesprächsabläufe mit Apple Messages for Business.
Verwenden Sie die iMessage-Apps-Vorlage, um dem Kunden Ihre benutzerdefinierte iMessage-App anzuzeigen.
Der folgende Code ist ein Beispiel für eine iMessage-App-Vorlage, die Sie in Ihrer Lambda-Funktion verwenden können.
```
{
templateType: AppleCustomInteractiveMessage,
version: "1.0",
data: {
content: {
appIconUrl: "https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg",
appId: "123456789",
appName: "Package Delivery",
title: "Bubble Title CIM",
bid: "com.apple.messages.MSMessageExtensionBalloonPlugin:{team-id}:{ext-bundle-id}",
dataUrl: "?deliveryDate=26-01-2024&destinationName=Home&street=1infiniteloop&state=CA&city=Cupertino&country=USA&postalCode=12345&latitude=37.331686&longitude=-122.030656&isMyLocation=false&isFinalDestination=true",
subtitle: "Bubble package",
},
replyMessage: {
title: "Custom reply message title",
subtitle: "Custom reply message subtitle",
imageType: "URL",
imageData: "https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg",
}
}
}
```
### Limits für die iMessage-App
| **Übergeordnetes Feld** | **Feld** | **Erforderlich** | **Typ** | **Andere Hinweise** |
| --- | --- | --- | --- | --- |
| | templateType | Ja | TemplateType | Gültiger Vorlagentyp, "AppleCustomInteractiveMessage“ |
| | data | Ja | InteractiveMessageData | Enthält die Wörterbücher „content“ und „receivedMessage“ |
| | Version | Ja | Zeichenfolge | Muss „1.0“ sein. |
| data | Inhalt | Ja | InteractiveMessageContent | Interaktiver Inhalt der iMessage-App |
| | replyMessage | Ja | ReplyMessage | Konfiguration der Nachrichtenanzeige nach dem Senden einer Antwort auf eine interaktive Nachricht |
| Inhalt | appIconUrl | Ja | Zeichenfolge | AWS-S3-URL |
| | appId | Ja | Zeichenfolge | IMessage App-ID für Unternehmen |
| | Name der App | Ja | Zeichenfolge | Name der IMessage Geschäfts-App |
| | bid | Ja | Zeichenfolge | Angebot für IMessage Geschäfts-Apps. Muster: com.apple.messages. MSMessageExtensionBalloonPlugin: \$1Team-ID\$1: \$1\$1 ext-bundle-id |
| | dataUrl | Ja | Zeichenfolge | Daten, die an die iMessage-App übergeben werden |
| | useLiveLayout | Nein | boolesch | Standard: True |
| | Titel | Ja | Zeichenfolge | Titel der iMessage-App-Sprechblase |
| | untertitel | Nein | Zeichenfolge | Untertitel der iMessage-App-Sprechblase |
| replyMessage | Titel | Nein | Zeichenfolge | |
| | untertitel | Nein | Zeichenfolge | |
| | Bild-Typ | Nein | Zeichenfolge | Muss eine gültige öffentlich zugängliche URL sein |
| | Bilddaten | Nein | Zeichenfolge | Kann ohne ein Bild nicht existieren |
## WhatsApp Liste
**Anmerkung**
Sie verwenden diese Vorlage nur für WhatsApp Nachrichtenflüsse. Weitere Informationen zur Integration WhatsApp mit Amazon Connect finden Sie [WhatsApp Business Messaging einrichten](whatsapp-integration.md) weiter oben in diesem Handbuch.
Sie verwenden die WhatsApp Listenvorlage in WhatsApp Chats, um Kunden eine Liste mit Optionen zur Verfügung zu stellen.
Das folgende Beispiel zeigt eine Liste von Optionen für eine Bankdienstleistung.
```
{
"templateType": "WhatsAppInteractiveList",
"version": "1.0",
"data": {
"content": {
"title": "Which account do you need help with?",
"body": {
"text": "Which account do you need help with?"
},
"action": {
"button": "Options",
"sections": [
{
"title": "Your accounts",
"rows": [
{
"id": "11111111",
"title": "11111111",
"description": "PERSONAL CHECKING"
},
{
"id": "22223333",
"title": "22223333",
"description": "PERSONAL SAVINGS"
}
]
},
{
"title": "Other",
"rows": [
{
"id": "other",
"title": "I can't find my account"
}
]
}
]
}
}
}
}
```
Die folgende Abbildung zeigt einen typischen Bildschirm vor und nach dem Öffnen einer Liste durch einen Kunden.
![\[Abbildung einer Liste von Optionen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/whatsapp-options-results.png)
### WhatsApp Optionen, Grenzen.
| Übergeordnetes Feld | Feld | Erforderlich | Mindestlänge | Maximale Länge | Weitere Voraussetzungen |
| --- | --- | --- | --- | --- | --- |
| | templateType | Ja | | | Muss "WhatsAppInteractiveList“ sein |
| | data | Ja | | | |
| | Version | Ja | | | Muss „1.0“ sein. |
| data | Inhalt | Ja | | | |
| Inhalt | Titel | Ja | | | |
| | Kopfzeile | Nein | | | |
| | body | Ja | | | |
| | footer | Nein | | | |
| | Aktion | Ja | | | |
| Kopfzeile | Typ | Ja | | | Muss „text“ sein |
| | Text | Ja | 1 | 60 | |
| body | Text | Ja | 1 | 4096 | |
| footer | Text | Ja | 1 | 60 | |
| Aktion | sections | Ja | 1 | 10 | |
| | knopf | Ja | 1 | 20 | |
| Abschnitt | Titel | Ja | 1 | 24 | |
| | Reihen | Ja | 1 | 10 | Maximal 10 Zeilen in allen Abschnitten |
| row | id | Ja | 1 | 200 | Muss zeilenübergreifend eindeutig sein |
| | Titel | Ja | 1 | 24 | |
| | description | Nein | 1 | 72 | |
## WhatsApp Schaltfläche „Antworten“
**Anmerkung**
Sie verwenden diese Vorlage nur für WhatsApp Nachrichtenflüsse.
Sie können die Vorlage für WhatsApp Antwortschaltflächen verwenden, um Kunden eine Inline-Liste mit Optionen zu präsentieren.
```
{
"templateType": "WhatsAppInteractiveReplyButton",
"version": "1.0",
"data": {
"content": {
"title": "What would you like to do?",
"body": {
"text": "What would you like to do?"
},
"action": {
"buttons": [
{
"type": "reply",
"reply": {
"id": "agent",
"title": "Continue to agent"
}
},
{
"type": "reply",
"reply": {
"id": "end_chat",
"title": "End chat"
}
}
]
}
}
}
}
```
Die folgende Abbildung zeigt eine typische Benutzererfahrung.
![\[Abbildung einer Antwort in einer Chat-Sitzung.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/whatsapp-reply-template.png)
### WhatsApp Beschränkungen für Antwortschaltflächen
Die WhatsApp Antwortvorlage hat die folgenden Beschränkungen.
| Übergeordnetes Feld | Feld | Erforderlich | Mindestlänge | Maximale Länge | Weitere Voraussetzungen |
| --- | --- | --- | --- | --- | --- |
| | templateType | Ja | | | Muss "WhatsAppInteractiveReplyButton“ sein |
| | data | Ja | | | |
| | Version | Ja | | | Muss „1.0“ sein. |
| data | Inhalt | Ja | | | |
| Inhalt | title | Ja | | | |
| | Kopfzeile | Nein | | | |
| | body | Ja | | | |
| | footer | Nein | | | |
| | Aktion | Ja | | | |
| Kopfzeile | Typ | Ja | | | Zulässige Werte: „text“, „document“, „image“, „video“ |
| | Text | Nein | 1 | 60 | |
| | Bild | Nein | | | |
| | Video | Nein | | | |
| | Dokument | Nein | | | |
| Bild | Link | Ja | | | Muss eine öffentlich zugängliche Medien-URL sein, die mit „https“/„http“ beginnt |
| Video | Link | Ja | | | Muss eine öffentlich zugängliche Medien-URL sein, die mit „https“/„http“ beginnt |
| Dokument | Link | Ja | | | Muss eine öffentlich zugängliche Medien-URL sein, die mit „https“/„http“ beginnt |
| body | Text | Ja | 1 | 1024 | |
| footer | Text | Ja | 1 | 60 | |
| Aktion | Knöpfe | Ja | 1 | 3 | |
| knopf | Typ | Ja | | | Muss „reply“ sein |
| | reply.id | Ja | 1 | 256 | Muss für alle Schaltflächen eindeutig sein |
| | reply.title | Ja | 1 | 20 | |
## Umfangreiche Formatierung von Titeln und Untertiteln
Sie können den Titeln und Untertiteln Ihrer Chat-Nachrichten umfangreiche Formatierungen hinzufügen. Sie können beispielsweise Links, kursive, fett gedruckte, nummerierte Listen und Aufzählungen hinzufügen. Sie können [Markdown]( https://commonmark.org/help/) verwenden, um Ihren Text zu formatieren.
Die folgende Abbildung einer Chatbox zeigt ein Beispiel für eine Listenauswahl mit umfangreicher Formatierung im Titel und Untertitel.
+ Der Titel **How can we help? aws.amazon.com** ist fett gedruckt und enthält einen Link.
+ Der Untertitel enthält kursiv und fett formatierten Text, eine Aufzählung und eine nummerierte Liste. Außerdem werden ein einfacher Link, ein Textlink und ein Beispielcode angezeigt.
+ Am unteren Rand des Chat-Felds werden drei Elemente zur Listenauswahl angezeigt.
![\[Eine Chatbox, ein Titel mit einem Link, ein Untertitel mit Listen und Links.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/rich-link-formatting-example1a.png)
### Wie formatiert man Text mit Markdown
Sie können Titel- und Untertitelzeichenfolgen in einem mehrzeiligen Format oder in einer einzigen Zeile mit ``\r\n`` Zeilenumbruchzeichen schreiben.
+ **Mehrzeiliges Format**: Das folgende Codebeispiel zeigt, wie Sie Listen im Markdown-Format in einem mehrzeiligen Format erstellen.
```
const MultiLinePickerSubtitle = `This is some *emphasized text* and some **strongly emphasized text**
This is a bulleted list (multiline):
* item 1
* item 2
* item 3
This is a numbered list:
1. item 1
2. item 2
3. item 3
Questions? Visit https://plainlink.com/faq
[This is a link](https://aws.amazon.com)
This is \`\`
`
const PickerTemplate = {
templateType: "ListPicker|Panel",
version: "1.0",
data: {
content: {
title: "How can we help?",
subtitle: MultiLinePickerSubtitle,
elements: [ /* ... */ ]
}
}
}
```
+ **Einzeiliges Format**: Das folgende Beispiel zeigt, wie Sie mithilfe von ``\r\n``-Zeilenumbruchzeichen einen Untertitel in einer einzigen Zeile erstellen.
```
const SingleLinePickerSubtitle = "This is some *emphasized text* and some **strongly emphasized text**\r\nThis is a bulleted list:\n* item 1\n* item 2\n* item 3\n\nThis is a numbered list:\n1. item 1\n2. item 2\n3. item 3\n\nQuestions? Visit https://plainlink.com/faq\r\n[This is a link](https://aws.amazon.com)\r\nThis is `