KI-Chat-Agent für Ihre Concrete-CMS-Website
Hazelchat beantwortet Fragen Ihrer Besucher aus den Seiten und Dokumenten, die Sie freigegeben haben, und zeigt unter jeder Antwort die Quellen. Ein kostenloses Add-on bringt den Chat auf jede öffentliche Seite Ihrer Concrete-Website, ohne Änderungen am Theme.
Version 0.9.1 für Concrete CMS ab 9.3.2. Der Free-Tarif enthält 50 Antworten im Monat für eine Website, ohne Karte, und bleibt kostenlos.
Funktioniert mit Concrete CMS ab 9.3.2, installiert über den Concrete CMS Marketplace oder als Zip.
Was Sie brauchen
- Concrete CMS 9.3.2 oder neuer. Version 8 wird nicht unterstützt.
- Ein Benutzerkonto, das Erweiterungen installieren darf.
- Ein Hazelchat-Konto. Das Add-on braucht den gehosteten Hazelchat-Dienst; der Free-Tarif enthält 50 Antworten im Monat für eine Website, ohne Karte.
Hazelchat in fünf Schritten zu Concrete CMS hinzufügen
-
In Hazelchat
Agenten vorbereiten
Fügen Sie Ihre Inhalte hinzu, prüfen Sie die Angaben und testen Sie Ihren Agenten. Tragen Sie unter Website → Install on your website die Domain Ihrer Website ein.
-
In Hazelchat
Öffentlichen Widget-Schlüssel kopieren
Wählen Sie Something else, öffnen Sie Use Concrete CMS und klicken Sie auf Copy key. Der Schlüssel ist öffentlich und kein Passwort.
-
In Concrete
Add-on installieren
Öffnen Sie in der Verwaltung (Dashboard) Concrete erweitern → Erweiterungen herunterladen, suchen Sie Hazelchat und installieren Sie es. Oder laden Sie es im Concrete CMS Marketplace herunter, entpacken Sie es in den Ordner
packagesIhrer Website und klicken Sie unter Concrete erweitern → Funktionen hinzufügen auf Installieren. Die Installation allein lädt noch nichts auf Ihrer Website. -
In Concrete
Schlüssel einfügen
Öffnen Sie Verwaltung → Hazelchat, fügen Sie den Schlüssel unter Öffentlicher Widget-Schlüssel ein und klicken Sie auf Speichern. Das Speichern leert den Seiten-Cache. Haben Sie früher ein Hazelchat-Skript unter Trackingcodes eingefügt, bittet die Seite Sie, es zu entfernen, damit der Chat nur einmal lädt.
-
In Hazelchat
Einschalten und testen
Klicken Sie danach in Ihrem Hazelchat-Konto auf Publish and switch on (oder Switch on, 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 eine Frage im Chat, kehren Sie zu Hazelchat zurück und klicken Sie auf Yes, I saw this answer.
Was das Add-on tut
Es fügt Ihren öffentlichen Seiten ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Konto.
Das Add-on setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel ans Ende jeder öffentlichen Seite. Es speichert nur diesen Schlüssel und eine Einwilligungs-Einstellung, hat keine Datenbanktabellen und keine Blöcke und sendet nichts von Concrete an Hazelchat. Die Verwaltung und Seiten im Bearbeitungsmodus laden den Chat nie. Seine Seite in der Verwaltung gibt es auf Deutsch und Englisch, und es ist freie Software unter der MIT-Lizenz.
Einwilligung der Besucher
Muss Ihr Consent-Tool den Chat erst erlauben, öffnen Sie unter Verwaltung → Hazelchat den Bereich Mehr und schalten Sie Auf meinen Consent-Manager warten ein. Der Chat bleibt dann geschlossen und sendet keine Chat-Anfragen, bis Ihr Consent-Tool ihn startet:
window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));
Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Viele Consent-Tools erledigen das für Sie: siehe Cookie-Banner. Muss Ihre Website schon das Laden des Skripts verhindern, lassen Sie Ihr Consent-Tool auch dieses Skript blockieren.
Caching und Sicherheits-Header
Seiten-Cache
Speichern unter Verwaltung → Hazelchat leert den Seiten-Cache von Concrete. Einen Proxy- oder CDN-Cache leeren Sie selbst.
Skript unverändert lassen
Nehmen Sie
https://app.hazelchat.co/widget.jsvom Zusammenfassen, Umschreiben oder verzögerten Laden aus. Das Skript muss seine Adresse und seinen Schlüssel behalten.Content-Security-Policy
Concrete sendet standardmäßig keine. Setzen Sie
security.misc.content_security_policyinapplication/config/concrete.phpoder sendet ein Proxy oder CDN eine Policy, erlauben Siehttps://app.hazelchat.coinscript-srcundframe-src. Mehr ist nicht nötig: keinstyle-src,connect-src,'unsafe-inline'und keine Nonce.Lokale Kopien und Staging
Der Chat öffnet sich nur auf den Website-Adressen, die in Hazelchat bestätigt sind. Auf
localhostoder einer anderen Adresse zeigt die Browser-Konsole einen blockierten Frame (frame-ancestors) und es erscheint kein Chat-Button. Das ist so gewollt und liegt nicht an der Policy Ihrer Website.
Ändern oder entfernen
Neuer Widget-Schlüssel
Wenn Sie den Schlüssel in Hazelchat erneuern, fügen Sie den neuen Schlüssel unter Verwaltung → Hazelchat ein und speichern Sie.
Chat pausieren
Schalten Sie Hazelchat in Ihrem Konto aus. Der Chat antwortet sofort nicht mehr, auch auf zwischengespeicherten Seiten.
Von der Website entfernen
Leeren Sie das Feld und speichern Sie, oder deinstallieren Sie das Add-on unter Concrete erweitern → Funktionen hinzufügen. Dabei werden auch seine Seite in der Verwaltung und seine Einstellungen entfernt. Ihr Hazelchat-Konto und Ihr Tarif bleiben unberührt.
Updates und Änderungen
Concrete bietet neue Versionen unter Concrete erweitern → Erweiterungen aktualisieren an, wenn die Website mit dem Marketplace verbunden ist.
0.9.1: Die Einstellungsseite fragt nur noch nach Ihrem öffentlichen Widget-Schlüssel; nach dem Speichern sagt sie, dass der letzte Schritt in Ihrem Hazelchat-Konto folgt; der Hilfelink zum Consent-Manager öffnet die Anleitung zu Cookie-Bannern.
0.9.0: fügt den Hazelchat-Chat mit einem Installationscode auf jeder öffentlichen Seite ein; optional Warten auf Ihren Consent-Manager; Deutsch und Englisch.
Concrete CMS ist eine Marke von PortlandLabs und wird hier nur genannt, um zu sagen, mit welcher Software das Add-on funktioniert. Hazelchat ist weder mit PortlandLabs noch mit dem Concrete-CMS-Projekt verbunden oder von ihnen unterstützt.
Lassen Sie Ihre Concrete-Website aus den eigenen Seiten antworten.
Fragen? Schreiben Sie an hello@hazelchat.co. Wir antworten innerhalb eines Werktags. Nicht auf Concrete? Alle Wege finden Sie unter Installation.