Eigenschaften & Konfiguration
Vollständige Referenz für alle verfügbaren Eigenschaften zur Anpassung von Styling, Übersetzungen und Funktionalität des Evolo Chatbots.
Haupt-Eigenschaften
| Prop | Type | Default |
|---|---|---|
supportUrl? | string | - |
showPoweredBy? | boolean | true |
apiEndpoint | ApiEndpoints | - |
style? | StyleConfig | - |
translations? | TranslationSet | defaultTranslations |
language? | string | "en" |
Styling-Eigenschaften
Theme-Konfiguration
Die style-Eigenschaft ermöglicht es Ihnen, Themes und Positionierung zu konfigurieren:
interface StyleConfig {
active: "light" | "dark";
light?: EvoloChatTheme;
dark?: EvoloChatTheme;
position: EvoloChatPosition;
}Theme-Eigenschaften
| Prop | Type | Default |
|---|---|---|
errorBorderColor? | string | "#fecaca" |
errorTextColor? | string | "#b91c1c" |
errorBgColor? | string | "#fef2f2" |
assistantMessageColor? | string | "#1f2937" |
assistantMessageBg? | string | "#f3f4f6" |
userMessageColor? | string | "#ffffff" |
userMessageBg? | string | "#54acbc" |
borderRadius? | string | "15px" |
borderColor? | string | "#e5e7eb" |
secondaryTextColor? | string | "#6c757d" |
textColor? | string | "#1f2937" |
backgroundColor? | string | "#ffffff" |
accentColor? | string | "#ccc" |
primaryColor? | string | "#54acbc" |
headerTextColor? | string | "#ffffff" |
headerBgColor? | string | "#54acbc" |
Positions-Konfiguration
| Prop | Type | Default |
|---|---|---|
bottom? | number | 20 |
left? | number | - |
right? | number | 20 |
side? | "bottom-right" | "bottom-left" | "bottom-right" |
Styling-Beispiele
<EvoloChatbot
language="en"
style={{
active: "light",
light: {
headerBgColor: "#2563eb",
headerTextColor: "#ffffff",
primaryColor: "#2563eb",
backgroundColor: "#ffffff",
textColor: "#1f2937",
borderRadius: "12px",
userMessageBg: "#2563eb",
userMessageColor: "#ffffff",
assistantMessageBg: "#f8fafc",
assistantMessageColor: "#334155"
},
position: {
side: "bottom-right",
right: 20,
bottom: 20
}
}}
apiEndpoint={apiEndpoint}
/><EvoloChatbot
language="en"
style={{
active: "dark",
dark: {
headerBgColor: "#1e1e1e",
headerTextColor: "#ffffff",
primaryColor: "#60a5fa",
backgroundColor: "#1e1e1e",
textColor: "#f1f5f9",
secondaryTextColor: "#94a3b8",
borderColor: "#334155",
borderRadius: "16px",
userMessageBg: "#60a5fa",
userMessageColor: "#ffffff",
assistantMessageBg: "#2d2d2d",
assistantMessageColor: "#f1f5f9"
},
position: {
side: "bottom-right",
right: 24,
bottom: 24
}
}}
apiEndpoint={apiEndpoint}
/><EvoloChatbot
language="en"
style={{
active: "light",
light: {
headerBgColor: "#059669",
headerTextColor: "#ffffff",
primaryColor: "#059669",
accentColor: "#d1d5db",
backgroundColor: "#ffffff",
textColor: "#111827",
borderColor: "#e5e7eb",
borderRadius: "20px",
userMessageBg: "#059669",
userMessageColor: "#ffffff",
assistantMessageBg: "#f0fdf4",
assistantMessageColor: "#14532d"
},
position: {
side: "bottom-right",
right: 16,
bottom: 16
}
}}
apiEndpoint={apiEndpoint}
/>// Unten-links Positionierung
<EvoloChatbot
language="en"
style={{
active: "light",
position: {
side: "bottom-left",
left: 24,
bottom: 24
}
}}
apiEndpoint={apiEndpoint}
/>
// Benutzerdefinierte unten-rechts Positionierung
<EvoloChatbot
language="en"
style={{
active: "light",
position: {
side: "bottom-right",
right: 32,
bottom: 32
}
}}
apiEndpoint={apiEndpoint}
/>Übersetzungs-Eigenschaften
Übersetzungsstruktur
interface TranslationSet {
cookies?: {
title?: string;
description?: string;
policyText?: string;
policyUrl?: string;
acceptText?: string;
declineText?: string;
};
header?: {
title?: string;
subtitle?: string;
};
messages?: {
assistantName?: string;
userName?: string;
initialMessage?: string;
warning?: string;
placeholder?: string;
error?: string;
};
footer?: {
support?: string;
};
}Standard-Übersetzungen
Die Bibliothek enthält eingebaute Übersetzungen für Englisch (en) und Deutsch (de):
{
"cookies": {
"title": "Cookie Consent",
"description": "We use session tracking to improve your experience. Do you consent to this?",
"acceptText": "Accept Cookies",
"declineText": "Only Essential"
},
"header": {
"title": "Your Assistant",
"subtitle": "Ask me anything, I'm here to help you"
},
"messages": {
"userName": "You",
"assistantName": "Assistant",
"placeholder": "Type your message here...",
"initialMessage": "Hello! How can I help you today?",
"warning": "AI can make mistakes",
"error": "An error occurred while processing your request."
},
"footer": {
"support": "Visit our help center"
}
}{
"cookies": {
"title": "Cookie-Zustimmung",
"description": "Cookies helfen uns mit Ihren Daten Ihre Erfahrung zu verbessern. Stimmen Sie dem zu?",
"acceptText": "Cookies akzeptieren",
"declineText": "Nur wesentlich"
},
"header": {
"title": "Ihr Assistent",
"subtitle": "Frag mich alles, ich bin hier um zu helfen"
},
"messages": {
"userName": "Sie",
"assistantName": "Assistent",
"placeholder": "Geben Sie Ihre Nachricht hier ein...",
"initialMessage": "Hallo! Wie kann ich Ihnen heute helfen?",
"warning": "KI kann Fehler machen",
"error": "Ein Fehler ist aufgetreten, während Ihre Anfrage verarbeitet wurde."
},
"footer": {
"support": "Support"
}
}<EvoloChatbot
language="es"
translations={{
es: {
cookies: {
title: "Consentimiento de Cookies",
description: "Usamos seguimiento de sesión para mejorar su experiencia. ¿Consiente a esto?",
acceptText: "Aceptar Cookies",
declineText: "Solo Esenciales"
},
header: {
title: "Su Asistente",
subtitle: "Pregúnteme cualquier cosa, estoy aquí para ayudarle"
},
messages: {
userName: "Usted",
assistantName: "Asistente",
placeholder: "Escriba su mensaje aquí...",
initialMessage: "¡Hola! ¿Cómo puedo ayudarle hoy?",
warning: "La IA puede cometer errores",
error: "Ocurrió un error al procesar su solicitud."
},
footer: {
support: "Visite nuestro centro de ayuda"
}
}
}}
apiEndpoint={apiEndpoint}
/>Funktionale Eigenschaften
API-Endpunkt-Konfiguration
| Prop | Type | Default |
|---|---|---|
apiEndpoint.chat | string | - |
apiEndpoint.consent | string | - |
apiEndpoint.session | string | - |
Optionale Konfiguration
| Prop | Type | Default |
|---|---|---|
language? | string | "en" |
supportUrl? | string | - |
showPoweredBy? | boolean | true |
Vollständiges Konfigurationsbeispiel
<EvoloChatbot
language="en"
translations={{
en: {
cookies: {
title: "Cookie Preferences",
description: "We use cookies to enhance your experience. Allow cookies?",
acceptText: "Allow All",
declineText: "Essential Only"
},
header: {
title: "Support Assistant",
subtitle: "I'm here to help with any questions"
},
messages: {
userName: "You",
assistantName: "Support Bot",
placeholder: "How can I help you today?",
initialMessage: "Hi there! What can I assist you with?",
warning: "AI responses may not always be accurate",
error: "Something went wrong. Please try again."
},
footer: {
support: "Need more help?"
}
}
}}
style={{
active: "light",
light: {
headerBgColor: "#1e40af",
headerTextColor: "#ffffff",
primaryColor: "#1e40af",
backgroundColor: "#ffffff",
textColor: "#1f2937",
borderRadius: "12px"
},
position: {
side: "bottom-right",
right: 20,
bottom: 20
}
}}
apiEndpoint={{
session: "https://api.yoursite.com/chatbot/session",
consent: "https://api.yoursite.com/chatbot/consent",
chat: "https://api.yoursite.com/chatbot/chat"
}}
showPoweredBy={false}
supportUrl="https://yoursite.com/support"
/>Alle Styling-Eigenschaften unterstützen CSS-Farbwerte (hex, rgb, hsl) und CSS-Längeneinheiten (px, rem, em) wo anwendbar.
Erste Schritte
Diese Anleitung hilft Ihnen dabei, Evolo Chatbot in Ihrem Projekt zu installieren und zu konfigurieren. Die Bibliothek unterstützt sowohl React-Anwendungen als auch direkte Browser-Verwendung.
API-Nutzung
Lernen Sie die erforderlichen API-Endpunkte und Server-Einrichtung für die Integration des Evolo Chatbot mit Ihrem Backend kennen.