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

Was Sie brauchen

Hazelchat in sechs Schritten zu Drupal hinzufügen

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

2. In Hazelchat

   Installationscode kopieren

   Kopieren Sie den Installationscode. Er enthält Ihren öffentlichen Widget-Schlüssel, der kein Passwort ist.

3. In Drupal

   Modul installieren

   Führen Sie im Ordner Ihrer Website composer require drupal/hazelchat aus und aktivieren Sie dann Hazelchat unter Erweitern (oder mit drush en hazelchat). Die Installation allein lädt noch nichts auf Ihrer Website.

4. In Drupal

   Code einfügen

   Öffnen Sie Konfiguration → Web-Dienste → Hazelchat, fügen Sie den Code unter Installationscode ein und klicken Sie auf Konfiguration speichern. Gespeichert wird nur der Schlüssel. Drupal leert seine eigenen Seiten-Caches selbst.

5. In Drupal

   Alte Snippets entfernen

   Wenn Sie früher ein Hazelchat-Skript in Ihr Theme oder einen Block eingefügt haben, entfernen Sie es, damit der Chat nur einmal lädt. Wenn ein Proxy oder CDN Ihre Seiten zwischenspeichert, leeren Sie auch diesen.

6. Auf Ihrer Website

   Einschalten und testen

   Klicken Sie in Hazelchat 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 im Chat eine Frage, kehren Sie zu Hazelchat zurück und klicken Sie auf Yes, I saw this answer.

Was das Modul tut

Es fügt Ihren öffentlichen Seiten ein Skript hinzu und sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.

Das Modul fügt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel in den Head Ihrer öffentlichen HTML-Seiten ein. Es speichert nur diesen Schlüssel und eine Einwilligungs-Einstellung, hat keine Datenbanktabellen und kein eigenes JavaScript und sendet nichts von Drupal an Hazelchat. Verwaltungsseiten und Feeds laden den Chat nie. Die Einstellungsseite gibt es auf Englisch und Deutsch, und das Modul ist freie Software unter der GPL, Version 2 oder später.

Einwilligung der Besucher

Klaro! Wenn Ihre Website das Modul Klaro! nutzt (Drupal CMS bringt es mit), fügt das Hazelchat-Modul dort einen Dienst Hazelchat unter Live-Chat hinzu. Klaro hält den Chat dann zurück, bis ein Besucher zustimmt, und vorher lädt nichts von Hazelchat. Klaro tut das nur für Rollen mit seiner Berechtigung Klaro! verwenden; geben Sie diese Berechtigung also anonymen Benutzern, wie es die Einrichtung von Klaro vorsieht.

Andere Consent-Tools. Schalten Sie auf der Hazelchat-Einstellungsseite Auf meinen Consent-Manager warten ein. Der Chat bleibt dann geschlossen und sendet keine Chat-Anfragen, bis Ihr Consent-Tool ihm den Start erlaubt:

window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));

Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Mit Auf meinen Consent-Manager warten wird das kleine Skript vor der Einwilligung trotzdem geladen. Welche Consent-Tools Hazelchat von selbst befolgt, steht unter Cookie-Banner.

Caching und Sicherheits-Header

• Seiten-Caches

  Drupals eigene Caches aktualisieren sich, wenn Sie die Einstellungen speichern. Einen Proxy oder ein CDN vor der Website leeren Sie selbst.

• 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

  Wenn Sie eine senden (zum Beispiel mit dem CSP-Modul), erlauben Sie https://app.hazelchat.co in script-src, connect-src und frame-src.

Ändern oder entfernen

Updates und Änderungen

Neue Versionen erscheinen auf drupal.org. Drupals Modul Update Status zeigt sie Ihnen an, und composer update drupal/hazelchat installiert sie.

1.0.0: fügt den Hazelchat-Chat mit einem Installationscode auf jeder öffentlichen Seite ein; funktioniert mit Klaro!; optionales Warten auf Ihren Consent-Manager; Englisch und Deutsch.