KI-Chat-Agent für Ihre MODX®-Website

Was Sie brauchen

Hazelchat in fünf Schritten zu MODX 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 MODX

   Extra installieren

   Das Verzeichnis von MODX führt das Extra noch nicht, darum laden Sie es selbst hoch. Laden Sie das Paket herunter. Öffnen Sie im Manager Extras → Installer, klicken Sie auf den Pfeil neben Download Extras, wählen Sie Upload a package und dann die Datei (unter MODX 2.8: Choose file(s), Datei wählen, Upload, Close). Klicken Sie in der Liste neben hazelchat auf Install, dann auf Continue und OK. Das Installieren allein fügt Ihrer Website noch nichts hinzu. (Die Bezeichnungen stehen hier wie in der englischen Oberfläche.)

4. In MODX

   Code einfügen

   Öffnen Sie Extras → Hazelchat, fügen Sie den Code in das Feld Installationscode ein und klicken Sie auf Speichern. Haben Sie früher schon ein Hazelchat-Skript in ein Template oder einen Chunk eingefügt, entfernen Sie es, damit der Chat nur einmal lädt.

5. 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.

An Ihre Entwickler schicken

Jemand anderes betreut Ihre Website? Kopieren Sie diese Nachricht, setzen Sie an der markierten Stelle Ihren Installationscode ein und schicken Sie sie ab.

Bitte fügt den Hazelchat-Chat zu unserer MODX-Website hinzu:

1. Das Paket herunterladen:
   https://github.com/hazelchat-co/modx-hazelchat/releases/latest
2. Extras → Installer, Pfeil neben Download Extras,
   Upload a package. Dann in der Liste installieren.
3. Extras → Hazelchat, einfügen:
   [unser Installationscode aus Hazelchat]
   und speichern.

Anleitung: https://hazelchat.co/de/integrations/modx/

Was das Extra macht

Es fügt den Seiten Ihrer Website ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.

Das Extra setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in jede HTML-Seite, auch in Ihre Fehlerseite. Der Manager, AJAX-Anfragen, JSON, XML, Feeds, Datei-Downloads und Ausgaben ohne </body> bleiben unverändert. Es arbeitet nach dem Seiten-Cache von MODX, ein geänderter Code erreicht also auch zwischengespeicherte Seiten innerhalb von Sekunden. Die Adresse des Skripts steht fest im Extra und lässt sich in den Einstellungen nicht ändern. Gespeichert wird nur ein gültiger Schlüssel: Alles andere, etwa ein API-Schlüssel, wird beim Klick auf Speichern abgelehnt. Ändern können ihn nur Benutzer mit dem MODX-Recht settings. Das Extra speichert nur den Schlüssel und einen Schalter in zwei Systemeinstellungen, legt keine Tabellen und keine öffentlichen Dateien an, stellt keine Anfragen von MODX an Hazelchat und sendet nichts. Es ist freie Software unter der MIT-Lizenz; seine Seite im Manager gibt es auf Englisch und Deutsch.

Mehrere Websites in einem MODX: Eine Kontexteinstellung namens hazelchat.installation_code mit dem reinen 64-stelligen Schlüssel gibt diesem Kontext einen eigenen Code.

Einwilligung der Besucher

Der Chat setzt keine Cookies und speichert nur einen Verweis auf das Gespräch, bis der Tab geschlossen wird. Sollen Besucher den Chat erst erlauben, schalten Sie unter Extras → Hazelchat Auf meinen Consent-Manager warten ein.

Der Chat bleibt dann geschlossen und sendet keine Anfragen, bis Ihr Einwilligungs-Tool es erlaubt. Mehrere Tools funktionieren ohne weitere Schritte; bei den anderen lassen Sie Ihr Tool diese Zeile ausführen (sie wirkt auch, wenn das Tool eine gespeicherte Wahl beim Laden der Seite erneut meldet):

(function (start) { document.readyState === 'loading' ? document.addEventListener('DOMContentLoaded', start) : start(); })(function () { window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true })); });

Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Die Skriptdatei selbst lädt trotzdem mit der Seite, sodass die IP-Adresse eines Besuchers Hazelchat erreicht, bevor er zustimmt. Muss Ihre Website auch das verhindern, lassen Sie Ihr Einwilligungs-Tool das Skript blockieren. Fertige Einstellungen für verbreitete Cookie-Banner finden Sie unter Cookie-Banner.

Daten und Löschung

Das Extra tut nichts, bis Sie einen Code speichern, und das ist Ihre Entscheidung. Danach laden die Browser Ihrer Besucher den Chat von app.hazelchat.co (Hazelchat, Deutschland). Hazelchat erfasst die Fragen, die Besucher eingeben, und, wenn sie eine Anfrage hinterlassen, ihren Namen, ihre E-Mail-Adresse und ihre Nachricht. Gespräche können außerdem die Seite festhalten, auf der sie begonnen haben, und Kampagnen-Parameter in deren Adresse. Hazelchat nutzt das, um Besuchern zu antworten und Ihnen die Gespräche zu zeigen; siehe die Datenschutzerklärung.

Gespräche können Sie in Hazelchat löschen. Möchten Sie Daten entfernen lassen, schreiben Sie an hello@hazelchat.co. Der Skript-Tag trägt die ID hazelchat-modx: Wenn Hazelchat Ihre Website prüft, liest es diese ID, um festzuhalten, dass der Chat mit diesem Extra installiert wurde, und zählt so die Installationen des Extras.

Wenn der Chat nicht erscheint

• Kein Hazelchat unter Extras?

  Laden Sie den Manager neu. Sehen können Sie es außerdem nur mit dem Recht settings.

• „No action specified!“

  Meldet MODX das direkt nach dem Installieren, warten Sie kurz und laden Sie neu. Die Caches holen innerhalb von Sekunden auf.

• Code prüfen

  Fügen Sie den ganzen Installationscode ein oder nur seinen 64-stelligen Schlüssel. Alles andere wird beim Speichern mit einem Satz abgelehnt. Ein falscher Wert in den Systemeinstellungen gibt nichts aus, und die Hazelchat-Seite sagt das.

• Skript unverändert lassen

  Schreibt ein Cache- oder Optimierungs-Extra oder -Dienst Ihre Seiten um oder speichert sie, bevor MODX fertig ist, nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen und verzögerten Laden aus und leeren Sie seinen Cache.

• Content-Security-Policy

  Senden Ihr Server oder ein Extra eine, erlauben Sie https://app.hazelchat.co in script-src, connect-src und frame-src.

• Eine zweite Domain

  Der Free-Tarif gilt für eine Website. Eine zweite MODX-Website auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Neue Versionen finden Sie auf der Release-Seite des Extras. Laden Sie sie genauso hoch; Ihr Code bleibt beim Update erhalten.

1.0.0 (November 2026): bringt den Hazelchat-Chat mit einem Installationscode auf einer eigenen Seite im Manager auf jede HTML-Seite einer Website mit MODX 2.8 oder 3; optional wartet er auf Ihren Consent-Manager.