Widget-Einbettung
Fügen Sie Ihren AI-Chatbot in Sekunden zu jeder Website hinzu – mit unserem einfachen Embed-Code.
Schnellstart
Fügen Sie diesen Code vor dem schließenden </body>-Tag ein:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Das war's! Ihr Chatbot ist nun auf Ihrer Website live.
So finden Sie Ihre Chatbot-ID
- Gehen Sie zu den Einstellungen Ihres Chatbots
- Navigieren Sie zum Einbetten-Tab
- Kopieren Sie den Embed-Code (enthält Ihre ID)
Die Chatbot-ID im Embed-Code ist nicht identisch mit dem Namen in Ihrer Dashboard-URL. Kopieren Sie die ID immer aus dem Einbetten-Tab.
Anpassung des Widgets
Das Erscheinungsbild und Verhalten des Widgets werden im Dashboard konfiguriert — nicht im Embed-Code. Gehen Sie zu Dashboard → Chatbots → [Ihr Chatbot] → Widget, um Folgendes anzupassen:
- Position — unten rechts, unten links oder inline
- Farben — Primär-, Hintergrund- und Textfarben sowie Randradius
- Größe — Breite und Höhe des Widgets
Um den Chat nach einer konfigurierbaren Verzögerung automatisch zu öffnen, aktivieren Sie Automatisch öffnen im Verhalten-Tab derselben Einstellungsseite. Bei White-Label-Plänen wird das ChatReact-Branding standardmäßig ausgeblendet — im gleichen Verhalten-Tab befindet sich ein "Powered by ChatReact" anzeigen-Umschalter, wenn Sie es trotzdem in der Widget-Fußzeile anzeigen möchten.
Änderungen werden automatisch auf Ihrer Website wirksam — ein Aktualisieren des Embed-Codes ist nicht erforderlich. Siehe die Anleitung Widget Customization für alle verfügbaren Optionen.
Die Widget-Sprache wird automatisch aus dem Browser des Besuchers erkannt, basierend auf den Sprachen, die Sie im Sprachen-Tab Ihres Chatbots aktivieren.
Wählen Sie die Inline-Position, um den Chat direkt an der Stelle einzubetten, an der das Script-Tag platziert ist. Das Widget ist dann immer geöffnet, ohne Bubble oder Schließen-Button — ideal für dedizierte Chat-Seiten oder Support-Bereiche.
FAQ-Widget
Zeigen Sie FAQs als Akkordeon auf jeder Seite an:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Das FAQ-Widget zeigt veröffentlichte FAQs Ihres Chatbots an. Farben und Styling (Primär-, Hintergrund- und Textfarben, Randradius) werden in Dashboard → FAQs → Einstellungen konfiguriert.
Optionen des FAQ-Widgets
| Einstellung | Beschreibung | Wo zu konfigurieren |
|---|---|---|
| Farben & Styling | Primär-, Hintergrund- und Textfarben, Randradius | Dashboard → FAQs → Einstellungen |
| Breite | Wählen Sie zwischen 100% (volle Breite) oder einer benutzerdefinierten Pixelbreite (400–1200px) | Dashboard → FAQs → Einstellungen |
| Sortierung | Anzeige-Reihenfolge: Datum (neueste zuerst), Name (alphabetisch) oder Benutzerdefiniert (manuelles Ziehen & Ablegen) | Dashboard → FAQs → Einstellungen → Verhalten |
| Kategoriefilter | Zeigen Sie nur bestimmte Kategorien im Widget an | Embed-Code data-categories Attribut |
| Eigener Container | Rendern Sie das Widget innerhalb Ihres eigenen Elements statt des standardmäßigen chatreact-faq div | Embed-Code data-container Attribut |
| Sprache | Überschreiben Sie die Widget-Sprache (Standard ist das <html lang>-Attribut Ihrer Seite, danach die Sprache des Browsers des Besuchers) | Embed-Code data-lang Attribut |
| Akkordeon-Verhalten | Erlauben Sie mehrere gleichzeitig geöffnete FAQs oder automatisches Aufklappen der ersten FAQ | Dashboard → FAQs → Einstellungen → Verhalten |
Beispiel für einen Kategorie-Filter
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Wenn das Widget auf eine einzelne Kategorie gefiltert ist, überschreibt die Sortierreihenfolge dieser Kategorie (festgelegt in Dashboard → FAQs → Kategorien) die globale Sortierung.
Mobile Optimierung
Das Chat-Widget ist vollständig für mobile Geräte optimiert:
- Vollbreiten-Layout auf kleinen Bildschirmen
- Hochfahr-Animation beim Öffnen
- iOS-Tastaturbehandlung (Widget passt sich an die Bildschirmtastatur an)
- Safe-Area-Unterstützung für iPhone-Notch und Home-Indikator
- Größere Touch-Ziele für bessere Bedienbarkeit
- Eingabe-Schriftgröße verhindert iOS-Auto-Zoom
Plattform-spezifische Anleitungen
WordPress
Empfohlen: Verwenden Sie das offizielle ChatReact WordPress Plugin für die einfachste Integration mit Gutenberg-Blöcken, Elementor-Widgets und Shortcodes.
Alternative: Manuelles Einbetten über ein "Header/Footer Scripts"-Plugin:
- Installieren Sie ein beliebiges "Header/Footer Scripts"-Plugin
- Fügen Sie den Embed-Code in den Footer-Bereich ein
- Speichern und veröffentlichen
Webflow
- Gehen Sie zu Project Settings → Custom Code
- Fügen Sie es zum Footer Code hinzu
- Veröffentlichen Sie die Seite
Next.js / React
Verwenden Sie die Script-Komponente:
import Script from 'next/script';
export default function Layout({ children }) {
return (
<>
{children}
<Script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
strategy="lazyOnload"
/>
</>
);
}
Vue.js
Fügen Sie es zu Ihrer Haupt-App.vue oder Ihrem Layout hinzu:
<script setup>
import { onMounted } from 'vue';
onMounted(() => {
const script = document.createElement('script');
script.src = 'https://www.chatreact.ai/embed/widget.js';
script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
script.async = true;
document.body.appendChild(script);
});
</script>
JavaScript-API
Interagieren Sie programmgesteuert mit dem Widget:
// Open the chat
ChatReact.open();
// Close the chat
ChatReact.close();
// Toggle open/closed
ChatReact.toggle();
// Start a fresh conversation
ChatReact.newChat();
// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();
Testen
Vorschau-Modus
Bevor Sie live einbetten:
- Nutzen Sie die Vorschau-Funktion in Ihrem Dashboard
- Testen Sie verschiedene Szenarien
- Verifizieren Sie, dass die Antworten korrekt sind
Testen auf einer lokalen Entwicklungsseite? Verwenden Sie den Standard-Embed-Code unverändert — er funktioniert auch auf localhost-Seiten.
Fehlerbehebung
Widget erscheint nicht
- Prüfen Sie die Browser-Konsole auf Fehler
- Vergewissern Sie sich, dass die Chatbot-ID korrekt ist
- Stellen Sie sicher, dass der Chatbot aktiv ist (nicht deaktiviert)
- Prüfen Sie, ob Werbeblocker eingreifen
- Überprüfen Sie Ihre Plan-Nutzung — das Widget pausiert, wenn das monatliche Limit Ihres Plans erreicht ist
Caching- & Optimierungs-Plugins
Manche Caching- oder Script-Optimierungs-Plugins schreiben Script-URLs um, wodurch das Widget nicht geladen wird. Sollte das passieren, fügen Sie eine explizite API-URL zum Script-Tag hinzu:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Dasselbe Attribut funktioniert auch bei den FAQ- und Formular-Widget-Scripts.
Styling-Konflikte
Wenn das CSS Ihrer Seite Konflikte verursacht:
- Das Widget kapselt seine Styles in seinem eigenen Container und verwendet prioritäre Regeln, um Konflikten zu widerstehen
- Prüfen Sie die z-index-Werte von Elementen, die das Widget überlagern
- Vermeiden Sie zu allgemeine
!important-Regeln in Ihrem Site-CSS, die generische Elemente ansprechen
Performance
Das Widget wurde für minimale Auswirkungen konzipiert:
- Lädt asynchron — blockiert niemals das Rendering Ihrer Seite
- Leichtgewichtig: etwa 30 KB komprimierter Transfer
Nächste Schritte
- Widget Customization →
- WordPress Plugin →
- FAQ Management →
- Smart Contact Forms → — betten Sie eigenständige Formulare mit dem Formular-Widget ein