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

Was Sie brauchen

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

   Erweiterung installieren

   Suchen Sie im Contao Manager nach Hazelchat, fügen Sie die Erweiterung hinzu und wenden Sie die Änderungen an; der Manager aktualisiert dabei auch die Datenbank. Mit Composer führen Sie composer require hazelchat/contao-hazelchat und danach vendor/bin/contao-console contao:migrate aus. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In Contao

   Code in den Startpunkt einfügen

   Öffnen Sie im Backend die Seitenstruktur und bearbeiten Sie den Startpunkt Ihrer Webseite (die Weltkugel). Fügen Sie unter Hazelchat den Code in das Feld Installationscode ein und speichern Sie. Bei einem Startpunkt je Sprache auf derselben Domain genügt einer. Haben Sie früher schon ein Hazelchat-Skript in ein Seitenlayout 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

Kein Zugang zum Contao Manager? 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 Contao-Website hinzu:

1. "Hazelchat" im Contao Manager installieren
   (oder: composer require hazelchat/contao-hazelchat, danach contao:migrate).
2. Seitenstruktur: unseren Startpunkt bearbeiten und unter Hazelchat
   diesen Code in "Installationscode" einfügen:
   [unser Installationscode aus Hazelchat]
3. Falls wir die Contao Cookiebar nutzen: einer Gruppe unseres Banners
   ein Cookie vom Typ "Hazelchat" hinzufügen.

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

Was die Erweiterung macht

Sie fügt den Seiten Ihrer Website ein Skript hinzu, sonst nichts. Ihre Inhalte, Antworten, Anfragen und die Abrechnung bleiben in Ihrem Hazelchat-Arbeitsbereich.

Die Erweiterung setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in jede Seite unter einem Startpunkt mit Code, mit klassischen und Twig-Seitenlayouts. Sie speichert nur den Schlüssel; was kein Hazelchat-Installationscode ist, wird beim Speichern abgelehnt. Andere Domains derselben Contao-Installation nutzen ihren eigenen Code. Die Erweiterung fügt dem Startpunkt zwei Felder hinzu, legt keine Tabellen an und sendet nichts von Contao an Hazelchat; das Backend lädt den Chat nie. Ist die Content-Security-Policy des Startpunkts eingeschaltet, erlaubt die Erweiterung https://app.hazelchat.co für den Chat. Ihre Einstellungen gibt es auf Deutsch und Englisch, und sie ist freie Software unter der LGPL, Version 3 oder neuer.

Cookie-Banner

Contao hat kein eigenes Cookie-Banner. Mit der Contao Cookiebar (Oveleon) fügen Sie einer Gruppe Ihres Banners, etwa einer funktionalen, ein Cookie hinzu und wählen als Typ Hazelchat. Der Chat startet dann erst, wenn der Besucher im Banner zustimmt, auf jeder Seite, und endet, wenn er ablehnt. Sie müssen kein Skript einfügen und nichts weiter einschalten.

Mit einem anderen Einwilligungs-Tool schalten Sie im Startpunkt Auf mein Cookie-Banner warten ein. Der Chat bleibt dann geschlossen und sendet keine Anfragen, bis Ihr Tool nach der Zustimmung diese Zeile sendet:

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

Senden Sie detail: false, wenn ein Besucher seine Einwilligung widerruft. Usercentrics, CCM19, consentmanager und einige andere Tools arbeiten mit einem Dienst namens Hazelchat; was in jedem zu tun ist, steht unter Cookie-Banner. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren.

Wenn der Chat nicht erscheint

• Steht der Code im Startpunkt?

  Der Code gehört in den Startpunkt der Webseite (die Weltkugel in der Seitenstruktur), nicht in eine normale Seite.

• Wurde der Code abgelehnt?

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

• Hat der Besucher zugestimmt?

  Mit einem Hazelchat-Cookie in der Contao Cookiebar oder eingeschaltetem Warten auf Ihr Cookie-Banner erscheint der Chat erst nach der Einwilligung.

• 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 Ihr Server oder ein Proxy eine eigene Policy, erlauben Sie dort 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 Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

Der Contao Manager zeigt neue Versionen mit Ihren anderen Updates an; mit Composer führen Sie composer update hazelchat/contao-hazelchat aus.

1.0.0 (21. Oktober 2026): bringt den Hazelchat-Chat mit einem Installationscode auf jede Seite unter einem Startpunkt; ein Cookie-Typ „Hazelchat“ für die Contao Cookiebar; optional wartet er auf jedes andere Cookie-Banner; Einstellungen auf Deutsch und Englisch.