Unterstützte Widget-Snippet-Felder in Amazon Connect, die anpassbar sind - Amazon Connect

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.

Unterstützte Widget-Snippet-Felder in Amazon Connect, die anpassbar sind

In der folgenden Tabelle werden die Snippet-Felder des Kommunikations-Widgets aufgeführt, die Sie anpassen können. Der Beispielcode hinter der Tabelle zeigt, wie die Code-Snippet-Felder verwendet werden.

Feld „Snippet“ Typ Beschreibung Ergänzende Dokumentation

snippetId

String

Obligatorisch, automatisch generiert

–

styles

String

Obligatorisch, automatisch generiert

–

supportedMessagingContentTypes

Array

Obligatorisch, automatisch generiert

–

customLaunchBehavior

Object

Passen Sie an, wie Ihre Website das gehostete Widget-Symbol rendert und startet

Anpassen des Startverhaltens und des Schaltflächensymbols für das Widget auf Ihrer Website, die in Amazon Connect gehostet wird, weiter unten in diesem Thema

authenticate

Funktion

Rückruffunktion zur Aktivierung der JWT-Sicherheit auf Ihrer Website

Schritt 2: Angeben der Website-Domains an, auf denen das Kommunikations-Widget angezeigt werden soll, weiter oben in diesem Abschnitt.

customerDisplayName

Funktion

Übergeben des Anzeigenamens des Kunden bei der Initialisierung eines Kontakts

Übergeben des Anzeigenamens des Kunden beim Start eines Amazon-Connect-Chats, weiter unten in diesem Abschnitt.

customStyles

Object

Überschreiben der Standard-CSS-Stile

Übergeben von benutzerdefinierten Eigenschaften zum Überschreiben der Standardeinstellungen im Kommunikations-Widget in Amazon Connect, weiter unten in diesem Abschnitt.

chatDurationInMinutes

Anzahl

Die Gesamtdauer der neu gestarteten Chat-Sitzung

Standard: 1500 - Min. 60, Max.: 10080

enableLogs

Boolesch

Aktivieren der Debugging-Protokolle

Standard: false

language

String

Amazon Connect kann Übersetzungen für unterstützte Sprachcodes im ISO-639-Format durchführen. Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes.

Anmerkung

Dadurch würden benutzerdefinierte Textüberschreibungen und Nachrichteninhalte (sowohl gesendet als auch empfangen) nicht übersetzt.

Standard: en_US. Unterstützt werden: „cs_CZ“, „da_DK“, „de_DE“, „en_AU“, „en_CA“, „en_GB“, „en_US“, „es_ES“, „fi_FI“, „fr_FR“, „hu_HU“, „id_ID“, „it_IT“, „ja_JP“, „ko_KR“, „nl_NL“, „nn_NO“ „pt_BR“, „pt_PT“, „sk_SK“, „sv_SE“, „zh_CN“, „zh_TW“

disableCSM

Boolesch

Deaktivieren Sie das Tracking der clientseitigen Metriken über das Kommunikations-Widget.

Standard: false

nonce

String

Handshake-Wert zwischen iframe und CSP-Richtlinie für die Kundenwebsite. Beispiel: Kunden-CSP erlaubt den Nonce-Wert 1234. Ein iframe, der ein anderes Skript abruft, muss denselben 1234-Nonce-Wert haben, damit der Browser weiß, dass es sich um ein vertrauenswürdiges Skript der übergeordneten iframe-Website handelt.

Standard: undefiniert

customizationObject

Object

Anpassen des Layouts und des Transkripts des Widgets

Weitere Informationen finden Sie unter Zusätzliche Anpassungen für Ihr Chat-Widget von Amazon Connect, weiter unten in diesem Abschnitt.

contactAttributes

Object

Übergeben von Attributen direkt aus dem Codeausschnitt an den Kontaktablauf, ohne dass eine JWT-Einrichtung erforderlich ist

Weitere Informationen finden Sie unter Übergeben von Kontaktattributen, wenn ein Chat initialisiert wird.

customDisplayNames

Object

Überschreiben Sie die Einstellungen für den Anzeigenamen und das Logo des Systems oder des Bots, die auf der Admin-Website von Amazon Connect festgelegt wurden.

Weitere Informationen finden Sie unter So übergeben Sie das Überschreiben von System- und Bot-Anzeigenamen und Logos für das Kommunikations-Widget.

contactMetadataHandler

Funktion

Rückruffunktion für den Zugriff auf contactId Fügen Sie beispielsweise einen Event-Listener hinzu, um Szenarien wie das Aufrufen der StopContact-Funktion mit der contactId zu verarbeiten, wenn die Browser-Registerkarte geschlossen ist, oder die Aufrechterhaltung der Chat-Persistenz mit einer vorherigen contactId.

registerCallback

Object

Auf diese Weise können Rückrufe für die exponierten Lebenszyklusereignisse ausgeführt werden.

Weitere Informationen finden Sie unter amazon-connect-chatjs.

  • Exponierte Systemereignisse sind 'PARTICIPANT_IDLE', 'CHAT_ENDED', 'PARTICIPANT_RETURNED', 'PARTICIPANT_JOINED', 'PARTICIPANT_LEFT', 'CONNECTION_ESTABLISHED', 'CONNECTION_LOST' und 'AUTHENTICATION_INITIATED'. Der Rückruf AUTHENTICATION_INITIATED wird ausgeführt, wenn der Kontakt den Flow-Block Kundenauthentifizierung erreicht.

  • Benutzerdefinierte exponierte Ereignisse sind WIDGET_FRAME_CLOSED.

initialMessage

String

Nachricht, die an den neu erstellten Chat gesendet werden soll. Längenbeschränkungen: Minimum 1, Maximum 1 024.

Wenn Sie den im Kontaktablauf konfigurierten Lex-Bot mit einer ersten Nachricht aufrufen möchten, ändern Sie den Flow-Block Kundeneingabe abrufen, indem Sie die Option Bot mit Nachricht initialisieren auswählen. Weitere Informationen finden Sie unter So konfigurieren Sie den Flow-Block „Kundeneingabe abrufen“.

authenticationParameters

Object

Dadurch wird der Flow-Block Kundenauthentifizierung aktiviert

Weitere Informationen finden Sie unter Aktivieren der Kundenauthentifizierung.

mockLexBotTyping

Boolesch

Aktivieren Sie die Anzeige für Mocking-Tippen für Lex-Bot-Nachrichten.

Standard: false

customStartChat

Funktion

Rückruffunktion zum Aufrufen der Start-Chat-API von Ihrem Backend aus.

Weitere Informationen finden Sie unter Benutzeroberfläche für gehostete Widgets mit benutzerdefinierter Start-Chat-API.

Das folgende Beispiel zeigt, wie Sie dem HTML-Skript, das das Chat-Widget zu Ihrer Website hinzufügt, Snippet-Felder hinzufügen.

(function(w, d, x, id) {   /* ... */})(window, document, 
'amazon_connect', 'widgetId');
 amazon_connect('snippetId', 'snippetId');
 amazon_connect('styles', /* ... */);
 amazon_connect('registerCallback', {
    // Custom event example
    // WIDGET_FRAME_CLOSED
    /**
     * This event is triggered when user clicks on the chat widget close button, 
     * either widget close button was clicked when error in the chat session or normally by the user. 
     * This event can be used for webview use cases to go back to main app
     * 
     * @param {string} status - The reason for widget closure
     *   - "error_chat": Indicates the user clicked on widget close button due to an error in the chat session
     *   - "close_chat": Indicates the user clicked on widget close button normally by the user
     */
    'WIDGET_FRAME_CLOSED': (eventName, { status }) => {
        // You can implement custom logic based on the status value(error_chat or close_chat)
        if (status == "error_chat") {
            // handle error chat
        } else if (status == "close_chat") {
            // handle close chat  
        } 
    },
    // System event example
    /**
     * chatDetails: { 
     *     contactId: string, 
     *     participantId: string,
     *     participantToken: string,
     * }
     * data: {
     *     AbsoluteTime?: string,
     *     ContentType?: string,
     *     Type?: string,
     *     ParticipantId?: string,
     *     DisplayName?: string,
     *     ParticipantRole?: string,
     *     InitialContactId?: string
     * }
     */
    'PARTICIPANT_JOINED': (eventName, { chatDetails, data }) => {
        alert(`${data.ParticipantRole} joined the chat.`);
    },
    'event_Name_3': callback(function),
    'event_Name_4': callback(function),
    // ...
}); 
amazon_connect('initialMessage', 'Your initial message string');
// ... 
amazon_connect('snippetFieldHere', /* ... */);
<script/>