KI-Chat-Agent für Ihre Joomla-Website

Was Sie brauchen

Hazelchat in sechs Schritten zu Joomla hinzufügen

1. In Hazelchat

   Agenten vorbereiten

   Fügen Sie Ihre Inhalte hinzu, prüfen Sie die Angaben und probieren Sie Ihren Agenten aus. Tragen Sie unter Website → Auf Ihrer Website installieren die Domain Ihrer Website ein.

2. In Hazelchat

   Installationscode kopieren

   Kopieren Sie den Installationscode. Er enthält Ihren öffentlichen Widget-Schlüssel, der kein Passwort ist.

3. In Joomla

   Erweiterung installieren

   Laden Sie die Zip-Datei herunter. Gehen Sie im Joomla-Administrator auf System → Installieren → Erweiterungen, öffnen Sie Paketdatei hochladen und ziehen Sie die Zip-Datei hinein. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In Joomla

   Code einfügen und aktivieren

   Gehen Sie auf System → Verwalten → Plugins, suchen Sie nach Hazelchat und öffnen Sie System - Hazelchat. Fügen Sie den Code in das Feld Installationscode ein, setzen Sie den Status auf Aktiviert und klicken Sie auf Speichern & Schließen. Gespeichert wird nur der Schlüssel.

5. In Joomla

   Alte Code-Schnipsel entfernen, Cache leeren

   Haben Sie früher schon ein Hazelchat-Skript in Ihr Template oder ein eigenes Modul eingefügt, entfernen Sie es, damit der Chat nur einmal lädt. Ist das Plugin System - Seitencache aktiv, leeren Sie den Cache unter System → Wartung → Cache leeren.

6. Auf Ihrer Website

   Einschalten und testen

   Klicken Sie in Hazelchat auf Veröffentlichen und einschalten (oder Einschalten, wenn Ihr veröffentlichter Agent unverändert ist). Hazelchat prüft, ob das Skript auf Ihrer Website ist, bevor der Agent live geht. Öffnen Sie dann Ihre Website, stellen Sie im Chat eine Frage, kehren Sie zu Hazelchat zurück und klicken Sie auf Ja, ich habe diese Antwort gesehen.

Was die Erweiterung macht

Sie fügt Ihren öffentlichen Seiten ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.

Die Erweiterung ist ein einzelnes System-Plugin. Sie setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel in den Head Ihrer öffentlichen HTML-Seiten. Sie speichert nur diesen Schlüssel und eine Einwilligungs-Einstellung, hat keine Datenbanktabellen und sendet nichts von Joomla an Hazelchat. Administrator, Feeds, Druckansichten und Modalfenster laden den Chat nie. Ihre Optionen gibt es auf Deutsch und Englisch, und sie ist freie Software unter der GPL, Version 2 oder neuer.

Einwilligung der Besucher

Joomla hat kein eigenes Cookie-Banner. Muss Ihr Einwilligungs-Tool den Chat erst erlauben, schalten Sie in System - Hazelchat die Option Auf meinen Consent-Manager warten ein. Der Chat bleibt dann geschlossen und sendet keine Anfragen, bis Ihr Einwilligungs-Tool ihn startet:

window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));

Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Die Erweiterung richtet Einwilligungs-Tools nicht für Sie ein. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren.

Cache und Sicherheits-Header

• Seitencache leeren

  Nach dem Installieren, Ändern des Codes oder Entfernen der Erweiterung.

• Skript unverändert lassen

  Nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen, Umschreiben oder verzögerten Laden von Skripten aus. Das Skript muss seine eigene Adresse und seinen Schlüssel behalten.

• Content-Security-Policy

  Schalten Sie sie in System - HTTP-Header ein, erlauben Sie https://app.hazelchat.co in script-src, connect-src und frame-src. Mit Nonces fügt Joomla die Nonce selbst zum Tag hinzu.

Ändern oder entfernen

Updates und Änderungen

Joomla prüft diese Update-Datei und bietet neue Versionen unter System → Aktualisieren → Erweiterungen an. Alle Versionen stehen im Changelog.

1.0.0 (17. Oktober 2026): bringt den Hazelchat-Chat mit einem Installationscode auf jede öffentliche Seite; optional wartet er auf Ihren Consent-Manager; Deutsch und Englisch.