StartseiteDokumentation

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

  1. Gehen Sie zu den Einstellungen Ihres Chatbots
  2. Navigieren Sie zum Einbetten-Tab
  3. 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

EinstellungBeschreibungWo zu konfigurieren
Farben & StylingPrimär-, Hintergrund- und Textfarben, RandradiusDashboard → FAQs → Einstellungen
BreiteWählen Sie zwischen 100% (volle Breite) oder einer benutzerdefinierten Pixelbreite (400–1200px)Dashboard → FAQs → Einstellungen
SortierungAnzeige-Reihenfolge: Datum (neueste zuerst), Name (alphabetisch) oder Benutzerdefiniert (manuelles Ziehen & Ablegen)Dashboard → FAQs → Einstellungen → Verhalten
KategoriefilterZeigen Sie nur bestimmte Kategorien im Widget anEmbed-Code data-categories Attribut
Eigener ContainerRendern Sie das Widget innerhalb Ihres eigenen Elements statt des standardmäßigen chatreact-faq divEmbed-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-VerhaltenErlauben Sie mehrere gleichzeitig geöffnete FAQs oder automatisches Aufklappen der ersten FAQDashboard → 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:

  1. Installieren Sie ein beliebiges "Header/Footer Scripts"-Plugin
  2. Fügen Sie den Embed-Code in den Footer-Bereich ein
  3. Speichern und veröffentlichen

Webflow

  1. Gehen Sie zu Project Settings → Custom Code
  2. Fügen Sie es zum Footer Code hinzu
  3. 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:

  1. Nutzen Sie die Vorschau-Funktion in Ihrem Dashboard
  2. Testen Sie verschiedene Szenarien
  3. 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

  1. Prüfen Sie die Browser-Konsole auf Fehler
  2. Vergewissern Sie sich, dass die Chatbot-ID korrekt ist
  3. Stellen Sie sicher, dass der Chatbot aktiv ist (nicht deaktiviert)
  4. Prüfen Sie, ob Werbeblocker eingreifen
  5. Ü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