KI-Chat-Agent für Ihre October-CMS-Website

Was Sie brauchen

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

   Plugin installieren

   Führen Sie in Ihrem October-Ordner composer require hazelchat/agent-plugin und danach php artisan october:migrate aus. Ohne Kommandozeile laden Sie das neueste Release herunter und legen seinen Ordner hazelchat in plugins. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In October CMS

   Code im Backend einfügen

   Öffnen Sie Einstellungen → 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 Layout 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 October-CMS-Website hinzu:

1. composer require hazelchat/agent-plugin
   php artisan october:migrate
   (oder den Ordner "hazelchat" aus dem Release nach plugins/ legen).
2. Im Backend unter Einstellungen → Hazelchat einfügen:
   [unser Installationscode aus Hazelchat]
   und speichern. Die Einstellung liegt in der Datenbank und
   bleibt bei einem Deployment erhalten.
3. Wer sie ändern soll, bekommt die Berechtigung
   "Hazelchat-Einstellungen ändern".

Anleitung: https://hazelchat.co/de/integrations/october-cms/

Was das Plugin 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 Plugin setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in jede Seite, die October ausgibt, mit jedem Theme und Layout und auf jeder Site einer Multisite-Installation. Das Backend, AJAX-Antworten und Seiten ohne </body> laden den Chat nie. Die Adresse des Skripts steht fest im Plugin 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 Speichern abgelehnt. Das Plugin speichert nur den Schlüssel und einen Schalter in der Einstellungstabelle von October, legt keine Tabellen, Routen oder Komponenten an, stellt keine Anfragen von October an Hazelchat und sendet nichts. Seine Backend-Texte gibt es auf Deutsch und Englisch, und 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 unter Einstellungen → Hazelchat Auf meinen Consent-Manager warten ein.

Mit dem Cookie-Banner von OFFLINE.GDPR legen Sie in der Gruppe Ihrer Wahl ein Cookie namens Hazelchat an (sein Code wird hazelchat). Das Plugin fügt den Chat dann nur für Besucher ein, die es akzeptiert haben, ab der nächsten Seite, die sie öffnen. Solange dieses Cookie fehlt, erinnert Sie Einstellungen → Hazelchat in einem Satz daran.

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, 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 Einstellungen?

  Prüfen Sie, ob der Ordner plugins/hazelchat/agent heißt, ob Sie php artisan october:migrate ausgeführt haben und ob Ihr Konto die Berechtigung Hazelchat-Einstellungen ändern hat.

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

• Mit OFFLINE.GDPR?

  Mit Auf meinen Consent-Manager warten erscheint der Chat erst, wenn ein Besucher das Hazelchat-Cookie akzeptiert. Akzeptieren Sie es selbst und öffnen Sie dann eine andere Seite.

• Skript unverändert lassen

  Schreibt ein Cache- oder Optimierungs-Plugin oder -Dienst Ihre Seiten um, nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen und verzögerten Laden aus. Ein Ganzseiten-Cache speichert die Seite so, wie der erste Besucher sie gesehen hat.

• Content-Security-Policy

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

Ändern oder entfernen

Updates und Änderungen

Aktualisieren Sie mit composer update hazelchat/agent-plugin oder indem Sie den Ordner plugins/hazelchat/agent durch das neuere Release ersetzen, und führen Sie dann php artisan october:migrate aus.

1.0.0 (November 2026): bringt den Hazelchat-Chat mit einem Installationscode unter Einstellungen → Hazelchat auf jede Seite einer Website mit October CMS 3 oder 4, mit jedem Theme; eigene Berechtigung; optional wartet er auf Ihren Consent-Manager, auch auf das Cookie-Banner von OFFLINE.GDPR; Backend-Texte auf Deutsch und Englisch.