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

Was Sie brauchen

Hazelchat in fünf Schritten zu ProcessWire 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. Auf Ihrem Server

   Modulordner kopieren

   Laden Sie Hazelchat.zip herunter, entpacken Sie die Datei und kopieren Sie den Ordner Hazelchat nach /site/modules/. Das Kopieren allein lädt noch nichts auf Ihrer Website.

4. In ProcessWire

   Installieren und Code einfügen

   Öffnen Sie im Admin Modules, klicken Sie auf Refresh und dann bei Hazelchat auf Install. Die Einstellungen öffnen sich: Fügen Sie den Code in das Feld Installation code ein und klicken Sie auf Submit. Haben Sie früher schon ein Hazelchat-Skript in ein Template 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 baut und veröffentlicht 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 ProcessWire-Website hinzu:

1. Den Ordner "Hazelchat" aus
   https://hazelchat.co/downloads/processwire/Hazelchat.zip
   nach /site/modules/ kopieren (oder
   https://github.com/hazelchat-co/processwire-hazelchat
   nach /site/modules/Hazelchat klonen).
2. Modules → Refresh, dann bei Hazelchat auf Install.
3. In seinen Einstellungen einfügen:
   [unser Installationscode aus Hazelchat]
   und Submit. Die Einstellung liegt in der Datenbank.

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

Was das Modul 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 Modul setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in die Seite, die ein Besucher öffnet, auch in Ihre 404-Seite. Der Admin, AJAX-Anfragen, Templates, deren Inhaltstyp nicht HTML ist, Seiten, die ein Template in einer anderen Seite ausgibt, und Ausgaben ohne </body> bleiben unverändert. Die Adresse des Skripts steht fest im Modul 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 Submit abgelehnt. Ändern können ihn nur Superuser oder Rollen, denen Sie module-admin geben. Das Modul speichert nur den Schlüssel und einen Schalter in seinen Moduleinstellungen, legt keine Felder, Templates, Seiten oder Tabellen an, stellt keine Anfragen von ProcessWire an Hazelchat und sendet nichts. Es ist freie Software unter der MIT-Lizenz.

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 in den Einstellungen des Moduls Wait for my consent manager ein.

Mit PrivacyWire ordnet das Modul den Chat der Gruppe Functional Cookies von PrivacyWire zu. Von Hazelchat lädt nichts, bis ein Besucher funktionale Cookies erlaubt; dann startet PrivacyWire den Chat auf derselben Seite. Bietet das Banner von PrivacyWire keine funktionalen Cookies an, startet der Chat nur für Besucher, die alle Cookies akzeptieren, und die Einstellungen des Moduls sagen das.

Mit einem anderen Einwilligungs-Tool bleibt der Chat geschlossen und sendet keine Anfragen, bis Ihr Einwilligungs-Tool diese Zeile ausführt (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. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, nutzen Sie PrivacyWire oder lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren. Fertige Einstellungen für verbreitete Cookie-Banner finden Sie unter Cookie-Banner.

Wenn der Chat nicht erscheint

• Kein Hazelchat unter Modules?

  Prüfen Sie, ob der Ordner /site/modules/Hazelchat heißt (nicht Hazelchat/Hazelchat), und klicken Sie erneut auf Refresh. Modules sehen Sie nur mit einem Superuser-Konto.

• Code prüfen

  Fügen Sie den ganzen Installationscode ein oder nur seinen 64-stelligen Schlüssel. Alles andere wird beim Klick auf Submit mit einem Satz abgelehnt.

• Mit PrivacyWire?

  Mit Wait for my consent manager erscheint der Chat erst, wenn ein Besucher funktionale Cookies erlaubt. Erlauben Sie sie selbst im Banner und sehen Sie noch einmal nach.

• Skript unverändert lassen

  Schreibt ein Cache- oder Optimierungs-Modul oder -Dienst Ihre Seiten um, nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen und verzögerten Laden aus.

• Content-Security-Policy

  Senden Ihr Server oder ein Modul 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 ProcessWire-Website auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Laden Sie die neuere Hazelchat.zip herunter, ersetzen Sie damit den Ordner /site/modules/Hazelchat und klicken Sie unter Modules auf Refresh. Ihre Einstellungen bleiben erhalten.

1.0.0 (November 2026): bringt den Hazelchat-Chat mit einem Installationscode in den Einstellungen des Moduls auf jede Seite einer Website mit ProcessWire ab 3.0.200; optional wartet er auf Ihren Consent-Manager, auch auf die Gruppe Functional Cookies von PrivacyWire.