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

Was Sie brauchen

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

   Addon installieren

   Führen Sie composer require hazelchat/statamic-hazelchat aus. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In Statamic

   Code einfügen

   Statamic 6: Öffnen Sie im Control Panel Werkzeuge → Add-ons → Hazelchat, fügen Sie den Code in das Feld Installationscode ein und speichern Sie. Statamic 5: Tragen Sie in die .env-Datei der Website HAZELCHAT_INSTALLATION_CODE= mit Ihrem 64-stelligen Schlüssel ein. Nutzen Sie statisches Caching, leeren Sie es (php please static:clear). 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 Agentur schicken

Kopieren Sie diese Nachricht, setzen Sie an der markierten Stelle Ihren Installationscode ein und schicken Sie sie an die Person, die Ihre Website betreut.

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

1. composer require hazelchat/statamic-hazelchat
2. Statamic 6: Control Panel → Werkzeuge → Add-ons → Hazelchat, diesen
   Code in "Installationscode" einfügen und speichern. Statamic 5: seinen
   64-stelligen Schlüssel als HAZELCHAT_INSTALLATION_CODE in die .env schreiben.
   [unser Installationscode aus Hazelchat]
3. Den statischen Cache leeren, falls die Website einen nutzt.

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

Was das Addon 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 Addon setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in die HTML-Seiten Ihrer Website, auch in Seiten aus dem statischen Cache von Statamic. Es speichert nur den Schlüssel, nie das eingefügte Skript. Es hat keine Datenbanktabellen, legt keine geplanten Aufgaben an und sendet nichts von Statamic an Hazelchat. Control Panel, Live-Vorschau, Weiterleitungen, JSON und andere Antworten ohne HTML laden den Chat nie. Setzt Ihre Website über Laravel eine CSP-Nonce, trägt das Skript sie. Seine Einstellungen gibt es auf Deutsch und Englisch, und es ist freie Software unter der MIT-Lizenz.

Templates, .env und mehrere Sites

• Nur auf bestimmten Seiten: Setzen Sie HAZELCHAT_AUTO_INJECT=false und fügen Sie {{ hazelchat }} (Antlers) oder <s:hazelchat /> (Blade) dort ein, wo der Chat laden soll. Eine Seite mit dem Tag bekommt nie ein zweites.
• Einstellungen in der .env: HAZELCHAT_INSTALLATION_CODE und HAZELCHAT_WAIT_FOR_CONSENT=true wirken in Statamic 5 und 6. In Statamic 6 gilt ein im Control Panel gespeicherter Code vorrangig.
• Mehrere Sites: Alle Sites nutzen standardmäßig denselben Code. Soll eine Site einen eigenen Code oder keinen bekommen, geben Sie ihr unter Configure → Sites (oder in resources/sites.yaml) das Attribut hazelchat; ein leerer Wert schaltet den Chat dort aus.

Einwilligung der Besucher

Statamic hat kein eigenes Cookie-Banner. Usercentrics, CCM19 und consentmanager können den Chat selbst freigeben, wenn Sie dort einen Dienst namens „Hazelchat“ anlegen (siehe Cookie-Banner). Muss Ihr Einwilligungs-Tool den Chat auf andere Weise erst erlauben, schalten Sie Auf meinen Consent-Manager warten ein (oder setzen Sie HAZELCHAT_WAIT_FOR_CONSENT=true). 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. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren.

Wenn der Chat nicht erscheint

• Statischen Cache leeren

  Nach dem Installieren, Ändern des Codes oder Entfernen des Addons führen Sie php please static:clear aus.

• Code prüfen

  Fügen Sie den ganzen Installationscode ein oder nur seinen 64-stelligen Schlüssel. Alles andere, etwa ein API-Schlüssel, zeigt nichts an; die Einstellungsseite sagt es Ihnen.

• Layout prüfen

  Der Chat kommt vor </body>. Ein Layout ohne dieses Tag bekommt nichts; setzen Sie dort {{ hazelchat }} ein.

• 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

  Sendet Ihre Website eine Policy, 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 Site auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Aktualisieren Sie mit composer update hazelchat/statamic-hazelchat; das Control Panel zeigt neue Versionen unter Werkzeuge → Updates.

1.0.0: bringt den Hazelchat-Chat mit einem Installationscode auf die Seiten Ihrer Website; das Tag {{ hazelchat }}; ein eigener Code je Site; optional wartet er auf Ihren Consent-Manager; Einstellungen auf Deutsch und Englisch.