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

Was Sie brauchen

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

   Plugin installieren

   Mit Composer führen Sie composer require hazelchat/kirby-hazelchat aus. Ohne Composer laden Sie das neueste Release herunter und legen seinen Ordner hazelchat in site/plugins. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In Kirby

   Code im Panel einfügen

   Melden Sie sich als Administrator im Panel an, öffnen Sie im Menü 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 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 Kirby-Website hinzu:

1. composer require hazelchat/kirby-hazelchat
   (oder den Ordner "hazelchat" aus dem Release nach site/plugins legen).
2. In site/config/config.php ergänzen:
   'hazelchat.kirby.code' => '[unser Installationscode aus Hazelchat]',
   (oder im Panel unter Hazelchat einfügen).
3. Veröffentlichen und site/cache leeren, falls der Seiten-Cache an ist.

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

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 HTML-Seite Ihrer Website, in jeder Sprache. Das Panel sowie JSON-, RSS- und andere Inhaltsdarstellungen laden den Chat nie. Den Dialog Hazelchat sehen nur Administratoren; er speichert den Schlüssel und einen Schalter in den Inhalten Ihrer Site, und ein Wert in der config.php hat Vorrang. Das Plugin hat keine Datenbank, stellt keine Anfragen von Kirby an Hazelchat und sendet nichts. Seine Panel-Texte gibt es auf Deutsch und Englisch, und es ist freie Software unter der MIT-Lizenz.

Einwilligung der Besucher

Kirby hat kein eigenes Cookie-Banner. Muss Ihr Einwilligungs-Tool den Chat erst erlauben, schalten Sie im Hazelchat-Dialog Auf meinen Consent-Manager warten ein (oder setzen Sie 'hazelchat.kirby.consent' => true). Der Chat bleibt dann 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. Das Plugin 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. Fertige Einstellungen für verbreitete Cookie-Banner finden Sie unter Cookie-Banner.

Wenn der Chat nicht erscheint

• Kein Hazelchat im Menü?

  Nur Administratoren sehen den Eintrag. Prüfen Sie, ob der Ordner site/plugins/hazelchat heißt und eine index.php enthält.

• Cache leeren

  Speichern im Dialog leert Kirbys Seiten-Cache. Nach einer Änderung in der config.php leeren Sie site/cache selbst.

• Code prüfen

  Fügen Sie den ganzen Installationscode ein oder nur seinen 64-stelligen Schlüssel. Alles andere, etwa ein API-Schlüssel, wird abgelehnt.

• 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

  Kirby sendet für Ihre Seiten keine. Tun es Ihr Server oder ein Plugin, 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 Kirby-Website auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Mit Composer führen Sie composer update hazelchat/kirby-hazelchat aus. Ohne Composer ersetzen Sie den Ordner site/plugins/hazelchat durch den aus dem neuesten Release.

1.0.0 (Oktober 2026): bringt den Hazelchat-Chat mit einem Installationscode im Panel oder in der config.php auf jede Seite einer Kirby-Website; optional wartet er auf Ihren Consent-Manager; Panel-Texte auf Deutsch und Englisch.