In diesem Abschnitt werden sämtliche verfügbaren Parameter zur Gestaltung und Funktionsweise des Chat-Widgets beschrieben. Diese Einstellungen ermöglichen eine gezielte Anpassung des Widgets an das gewünschte Design, Verhalten und die Nutzererfahrung.
Grundkonfiguration
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.chatflowid | String | ID des Chatbots. |
| globalThis.apiHost | String | URL des Chatbots |
| globalThis.useFullInit | Boolean | Modus (Bubble oder Embed) des Chatbots, default = false (Bubble). |
| globalThis.starterPrompts | Array | Array mit vordefinierten Einstiegsprompts (startPrompts = [ "Frage 1", "Frage 2" ]; |
| globalThis.chatWindow_customCSS | String | Benutzerdefinierter CSS-Code zur individuellen Gestaltung des Chat-Widgets |
Chatbot
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.chatWindow_showTitle | Boolean | Legt fest, ob der Titel im Chatfenster angezeigt wird (true = anzeigen, false = ausblenden). |
| globalThis.chatWindow_showAgentMessages | Boolean | Steuert, ob Nachrichten des Agenten (z. B. Begrüßung, Hinweise) im Chatfenster angezeigt werden (true = anzeigen, false = ausblenden). |
| globalThis.chatWindow_title | String | Text, der als Titel im Chatfenster angezeigt wird (z. B. „Audit-Assistent“). |
| globalThis.chatWindow_subTitle | String | Untertitel oder ergänzender Text unter dem Chat-Titel – z. B. zur Beschreibung des Chatbots oder zur Anleitung. |
| globalThis.chatWindow_titleAvatarSrc | String | URL oder Pfad zum Avatarbild, das im Titelbereich des Chatfensters angezeigt wird. |
| globalThis.chatWindow_welcomeMessage | String | Begrüßungstext, der automatisch beim Öffnen des Chatfensters angezeigt wird – dient als Einstieg für den Nutzer. |
| globalThis.chatWindow_errorMessage | String | Text, der angezeigt wird, wenn ein Fehler im Chat auftritt (z. B. bei fehlender Serverantwort). |
| globalThis.chatWindow_backgroundColor | String | Hintergrundfarbe des Chatfensters – wird als Hex-Code oder Farbwert definiert (z. B. #ffffff für Weiß). |
| globalThis.chatWindow_backgroundImage | String | URL oder Pfad zu einem Hintergrundbild, das im Chatfenster angezeigt wird – ersetzt oder ergänzt die Hintergrundfarbe. |
| globalThis.chatWindow_height | Integer | Höhe des Chatfensters in Pixel |
| globalThis.chatWindow_width | Integer | Breite des Chatfensters in Pixel |
| lobalThis.chatWindow_fontSize | Integer | Schriftgröße für Texte im Chatfenster – angegeben in CSS-Einheiten wie Pixel |
| globalThis.chatWindow_starterPromptFontSize | Integer | Schriftgröße für den Start-Prompt bzw. die erste Eingabeaufforderung im Chat in Pixel |
| globalThis.chatWindow_clearChatOnReload | Boolean | Legt fest, ob der Chatverlauf beim Neuladen der Seite gelöscht wird (true = Verlauf wird gelöscht, false = Verlauf bleibt erhalten). |
| globalThis.chatWindow_sourceDocsTitle | String | Titel oder Überschrift für den Abschnitt, in dem Quell- oder Referenzdokumente zum Chatverlauf angezeigt werden. |
Buttons
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.button_backgroundColor | String | Hintergrundfarbe des Bubbles |
| globalThis.button_right | Integer | Abstand des Bubbles zum rechten Rand. Default-Wert sind 20px. |
| globalThis.button_bottom | Integer | Abstand des Bubbles zum unteren Rand. Default-Wert sind 20px. |
| globalThis.button_size | Integer | Größe in Pixel des Bubbles. |
| globalThis.button_dragAndDrop | Boolean | Aktiviert (true) Drag & Drop des Chatfensters. Default-Wert ist false. |
| globalThis.button_iconColor | String | Farbe des Bubble Icons. |
| globalThis.button_customIconSrc | String | Eigener Avatar, wird zentriert im Bubble dargestellt. Max. Größe: 180px, Formate: jpg, gif, png, webp, svg. |
| globalThis.button_autoOpen | Boolean | Öffnet den Chatbot automatisch beim Aufruf der Seite. |
| globalThis.button_openDelay | Integer | Verzögerung in Sekunden beim automatischen Öffnen des Chatbots. |
| globalThis.button_autoOpenOnMobile | Boolean | Automatisches Öffnen des Chatbots auf mobilen Endgeräten (true/false). |
Tooltip
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.tooltip_showTooltip | Boolean | Legt fest, ob Tooltip angezeigt wird (true = anzeigen, false = ausblenden). |
| globalThis.tooltip_message | String | Text, der im Tooltip angezeigt wird. |
| globalThis.tooltip_backgroundColor | String | Hintergrundfarbe des Tooltips – angegeben als Farbwert (z. B. #333) |
| globalThis.tooltip_textColor | String | Schriftfarbe des Tooltips – angegeben als Farbwert (z. B. #fff) |
| globalThis.tooltip_fontSize | Integer | Schriftgröße des Tooltip-Textes – angegeben in Pixel. |
Disclaimer
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.disclaimer_title | String | Titel des Disclaimers. |
| globalThis.disclaimer_message | String | Hinweistext zum Datenschutz. |
| globalThis.disclaimer_textColor | String | Schriftfarbe (z. B. #333) des Disclaimer Textes. |
| globalThis.disclaimer_buttonText | String | Hintergrundfarbe (z. B. #333) des Disclaimer Buttons. |
| globalThis.disclaimer_buttonTextColor | String | Textfarbe (z. B. #333) des Disclaimer Buttons. |
| globalThis.disclaimer_blurredBackgroundColor | String | Hintergrundeffekt, wenn Disclaimer geöffnet ist. |
| globalThis.disclaimer_backgroundColor | String | Hintergrundfarbe (z. B. #333) des Disclaimer-Fensters. |
Nachrichten
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.botMessage_backgroundColor | String | Hintergrundfarbe (z. B. #333333) der Bot-Nachrichten. |
| globalThis.botMessage_textColor | String | Textfarbe (z. B. #333333) der Bot-Nachrichten. |
| globalThis.botMessage_showAvatar | Boolean | Avatar anzeigen (true/false) |
| globalThis.botMessage_avatarSrc | String | Eigener Avatar, wird links neben der Bot-Nachricht dargestellt. Max. Größe: 180px, Formate: jpg, gif, png, webp, svg. |
| globalThis.userMessage_backgroundColor | String | Hintergrundfarbe (z. B. #333333) der User-Nachrichten. |
| globalThis.userMessage_textColor | String | Textfarbe (z. B. #333333) der User-Nachrichten. |
| globalThis.userMessage_showAvatar | String | Avatar anzeigen (true/false) |
| globalThis.userMessage_avatarSrc | String | Eigener Avatar, wird links neben der User-Nachricht dargestellt. Max. Größe: 180px, Formate: jpg, gif, png, webp, svg. |
Texteingabe
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.textInput_placeholder | String | Platzhalter-Text für das Eingabefeld. |
| globalThis.textInput_backgroundColor | String | Hintergrundfarbe (z. B. #333333) des Eingabefelds. |
| globalThis.textInput_textColor | String | Schriftfarbe (z. B. #333333) des Eingabefelds. |
| globalThis.textInput_sendButtonColor | String | Farbe (z. B. #333333) des Sende-Icons. |
| globalThis.textInput_maxChars | Integer | Maximal erlaubte Zeichen im Eingabefeld (default 250). |
| globalThis.textInput_maxCharsWarningMessage | String | Warnhinweis wenn die maximale Anzahl an Zeichen im Eingabefeld überschritten werden. |
| globalThis.textInput_autoFocus | Boolean | Automatischer Focus auf das Eingabefeld beim Öffnen des Chatfensters (default ist true). |
| globalThis.textInput_sendMessageSound | Boolean | Sound beim Senden einer Nachricht an den Bot abspielen (true/false, default ist false) |
| globalThis.textInput_sendSoundLocation | String | Sound URL im MP3-Format. |
| globalThis.textInput_receiveMessageSound | Boolean | Sound beim Empfangen einer Nachricht vom Bot abspielen (true/false, default ist false) |
| globalThis.textInput_receiveSoundLocation | String | Sound URL im MP3-Format. |
Fußzeile
| Parameter | Typ | Beschreibung |
|---|---|---|
| globalThis.footerDisclaimer | String | Text in der Fußzeile. |