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

Was Sie brauchen

Hazelchat in vier Schritten zu Umbraco 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

   Die zwei Zeilen für Ihren Entwickler kopieren

   Wählen Sie Umbraco. Hazelchat zeigt das Paket und die Einstellung, Ihr Schlüssel ist schon eingetragen. Klicken Sie auf Für meinen Entwickler kopieren. Der Schlüssel ist öffentlich, kein Passwort.

3. In Ihrem Umbraco-Projekt

   Paket und Einstellung hinzufügen, dann veröffentlichen

   Führen Sie dotnet add package Hazelchat.Umbraco aus, ergänzen Sie in appsettings.json "Hazelchat": { "InstallationCode": "Ihr Schlüssel" } (oder setzen Sie die Umgebungsvariable Hazelchat__InstallationCode) und veröffentlichen Sie die Website wie gewohnt. Keine Änderungen an Templates oder Program.cs. Steht schon ein Hazelchat-Skript in einem Template, entfernen Sie es, damit der Chat einmal lädt.

4. 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, gehen Sie zurück zu Hazelchat 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 Ihren Schlüssel an der markierten Stelle ein und schicken Sie sie ab. Der Installationsschritt in Hazelchat gibt Ihnen dieselben Zeilen mit Ihrem Schlüssel.

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

1. dotnet add package Hazelchat.Umbraco
2. In appsettings.json (oder als Umgebungsvariable
   Hazelchat__InstallationCode auf der Live-Website):
   "Hazelchat": {
     "InstallationCode": "[unser Schlüssel aus Hazelchat]"
   }
3. Wie gewohnt bauen und veröffentlichen. Keine Änderungen an
   Templates oder Program.cs. Settings → Health Check → Hazelchat
   bestätigt die Einstellung.

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

Lassen Sie die Einstellung auf Staging leer und setzen Sie sie nur auf der Live-Website, wenn der Chat dort nicht erscheinen soll.

Was das Paket 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 Paket fügt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in jede Seite ein, die Umbraco aus seinen Inhalten rendert, mit jedem Template und auf jeder Website der Installation. Es ändert nur fertige HTML-Seiten: Backoffice, Vorschau, Delivery API und andere APIs, Medien und andere Dateien, Seiten anderer Controller und Seiten ohne </body> bleiben genau, wie sie sind. Die Skriptadresse steht fest im Paket. Ist die Einstellung kein gültiger Schlüssel, etwa ein API-Schlüssel, erscheint nichts und Umbracos Log enthält eine Warnung. Unter Settings → Health Check → Hazelchat sehen Sie, ob der Schlüssel gesetzt und gültig ist. Das Paket speichert nichts, legt keine Tabellen, Routen oder Backoffice-Seiten an, stellt keine Anfragen von Ihrer Website an Hazelchat und sendet nichts. Es ist freie Software unter der MIT-Lizenz.

Einwilligung der Besucher

Der Chat setzt keine Cookies und behält nur einen Verweis auf das Gespräch, bis der Tab geschlossen wird. Sollen Besucher den Chat erst erlauben, ergänzen Sie in der Hazelchat-Einstellung "RequireConsent": true.

Mit Cookiebot oder CookieTractor folgt der Chat dann von selbst der Wahl Ihrer Besucher für Präferenzen (Cookiebot) oder funktionale Cookies (CookieTractor). Usercentrics, Borlabs, CCM19, consentmanager und Complianz erkennt er ebenfalls; siehe Cookie-Banner.

Mit einem anderen Einwilligungs-Tool bleibt der Chat geschlossen und sendet keine Chat-Anfragen, bis Ihr Tool diese Zeile ausführt (das klappt auch, wenn das Tool eine gespeicherte Wahl beim Laden der Seite wiederholt):

(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 die Einwilligung widerruft. Muss Ihre Website schon das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren.

Wenn der Chat nicht erscheint

• Health Check ansehen

  Öffnen Sie im Backoffice Settings → Health Check → Hazelchat. Dort steht, ob der Schlüssel fehlt, ungültig oder gesetzt ist.

• Einstellung prüfen

  Verwenden Sie den 64-stelligen Schlüssel aus Hazelchat unter Hazelchat:InstallationCode. Eine Umgebungsvariable hat Vorrang vor appsettings.json. Starten Sie die Website nach einer Änderung an Umgebungsvariablen neu.

• Komprimierung nach Umbraco

  Komprimierung gehört vor Umbraco (app.UseResponseCompression() vor app.UseUmbraco()) oder in Ihren Webserver. Komprimiert etwas die Seiten erst nach Umbraco, wird der Chat nicht eingefügt.

• Caches und Optimierer

  Schreibt ein CDN oder Optimierer Ihre Seiten um, nehmen Sie https://app.hazelchat.co/widget.js vom Zusammenfassen und verzögerten Laden aus und leeren Sie zwischengespeicherte Seiten nach dem Veröffentlichen.

• Content-Security-Policy

  Sendet Ihre Website 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. Mehrere Websites in einer Umbraco-Installation teilen sich einen Schlüssel; eine weitere Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Aktualisieren Sie mit dotnet add package Hazelchat.Umbraco (es nimmt die neueste Version) oder Ihren NuGet-Werkzeugen und veröffentlichen Sie dann.

1.0.0 (November 2026): fügt den Hazelchat-Chat mit einer Einstellung in jede Inhaltsseite einer Website mit Umbraco 13 bis 18 ein, ohne Template-Änderungen; wartet auf Wunsch auf Ihr Einwilligungs-Tool; ein Hazelchat-Health-Check.