Dokumentation

WordPress

Fügen Sie Ihren Agenten zu WordPress-Websites hinzu.

Fügen Sie Ihren KI-Agenten mithilfe des Einbettungscodes zu WordPress-Websites hinzu. Funktioniert mit jedem WordPress-Theme.

Öffnen Sie Kanäle > Website-Einbindung, wählen Sie Chat-Widget und kopieren Sie den vollständigen Code mit beiden Script-Tags. Übernehmen Sie die Widget-URL und Chatbot-ID unverändert. Für eine seitenweite Installation ohne Theme-Änderung eignet sich das WPCode-Footer-Feld in Methode 3.

Aktivieren Sie den Chat-Widget-Kanal, bevor Sie die öffentliche Website testen.

Fügen Sie das Widget über Ihr Theme auf allen Seiten hinzu:

  1. Gehen Sie zu Design → Theme-Editor (oder Theme-Datei-Editor)
  2. Suchen Sie footer.php in Ihren Theme-Dateien
  3. Fügen Sie Ihren Einbettungscode direkt vor </body> ein
  4. Klicken Sie auf Datei aktualisieren

Das Widget erscheint nun auf allen Seiten.

Methode 2: Benutzerdefinierter HTML-Block

Fügen Sie es mit dem Block-Editor zu bestimmten Seiten hinzu:

  1. Bearbeiten Sie die Seite, auf der das Widget erscheinen soll
  2. Fügen Sie einen Block Benutzerdefiniertes HTML hinzu
  3. Fügen Sie Ihren Einbettungscode aus Kanäle > Website-Einbindung ein
  4. Speichern Sie die Seite

Ein benutzerdefinierter HTML-Block funktioniert nur, wenn Ihr WordPress-Konto Scripts veröffentlichen darf. Prüfen Sie nach dem Speichern, ob beide Tags im gerenderten Quelltext stehen. Ohne unfiltered_html kann WordPress sie entfernen, besonders bei Multisite. WordPress erläutert die Berechtigung.

Methode 3: Plugin (Header-/Footer-Skripte)

Verwenden Sie ein Plugin, um Skripte website-weit hinzuzufügen:

  1. Installieren Sie WPCode, früher Insert Headers and Footers von WPBeginner.
  2. Öffnen Sie die Plugin-Einstellungen
  3. Suchen Sie den Bereich „Footer“
  4. Fügen Sie Ihren Einbettungscode aus Kanäle > Website-Einbindung ein
  5. Speichern Sie die Änderungen

Bei dieser Methode müssen keine Theme-Dateien bearbeitet werden.

Methode 4: Child-Theme

Verwenden Sie für Themes, die häufig aktualisiert werden, ein Child-Theme:

  1. Erstellen Sie ein Child-Theme für Ihr aktuelles Theme
  2. Ein Entwickler kann beide generierten Script-Tags über wp_footer ausgeben. Testen Sie nach Theme-Updates.

Diese Lösung übersteht Theme-Updates.

WooCommerce-Websites

Das Widget funktioniert auf WooCommerce-Websites automatisch. Denken Sie an Folgendes:

  • Auf Produktseiten einbinden, um Produktfragen zu beantworten
  • Beim Checkout einbinden, um Bestellsupport anzubieten
  • Über Benutzerdefinierte-HTML-Blöcke auf bestimmten Seiten einsetzen

Page-Builder

Manche Editoren entfernen Scripts aus Seiteninhalten. Prüfen Sie den gerenderten Quelltext. Fehlt ein Tag, verwenden Sie das WPCode-Footer-Feld.

Multisite

Für WordPress-Multisite:

  • Fügen Sie den Code auf jeder Website einzeln hinzu, oder
  • Verwenden Sie ein netzwerkweit aktiviertes Plugin, um ihn allen Websites hinzuzufügen

Caching-Plugins

Wenn Sie Caching-Plugins verwenden (WP Super Cache, W3 Total Cache usw.):

  1. Fügen Sie den Widget-Code hinzu
  2. Leeren Sie alle Caches
  3. Testen Sie das Widget

Fehlerbehebung

Widget erscheint nicht

  • Leeren Sie Ihren WordPress-Cache
  • Prüfen Sie die Browser-Konsole auf Fehler
  • Prüfen Sie, ob die Agent-ID korrekt ist

Theme-Editor nicht verfügbar

  • Manche Hoster deaktivieren die Theme-Bearbeitung
  • Verwenden Sie stattdessen eine der Plugin-Methoden
  • Oder bearbeiten Sie die Dateien per FTP

Widget-Position falsch

  • Passen Sie dies in den Design-Einstellungen Ihres Agenten an
  • Prüfen Sie auf CSS-Konflikte mit dem Theme

Testen

Nach der Installation:

  1. Öffnen Sie Ihre WordPress-Website in einem Inkognito-Fenster
  2. Achten Sie auf die Chat-Blase
  3. Senden Sie eine Testnachricht
  4. Prüfen Sie die Antwort

Prüfen Sie im gerenderten Quelltext beide Tags und im Netzwerk-Tab die konfigurierte Widget-URL. Fehlt ein Tag, prüfen Sie Script-Berechtigungen und Cache.

Nächste Schritte