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

Was Sie brauchen

Hazelchat in sechs Schritten zu TYPO3 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 TYPO3

   Extension installieren

   Mit Composer führen Sie composer require hazelchat/typo3 aus. Ohne Composer öffnen Sie Admin Tools → Extensions, wählen Get Extensions und installieren Hazelchat. Die Installation allein lädt noch nichts auf Ihrer Website.

4. In TYPO3

   Das Hazelchat-Set zur Site hinzufügen

   TYPO3 13.4: Site Management → Sites, Site bearbeiten. TYPO3 14.3: Sites → Setup, Edit site configuration. Fügen Sie unter Sets for this Site das Set Hazelchat hinzu und speichern Sie.

5. In TYPO3

   Code einfügen und Caches leeren

   TYPO3 13.4: Site Management → Settings, Site bearbeiten. TYPO3 14.3: Sites → Setup, Edit site settings. Fügen Sie unter Hazelchat den Code in das Feld Installationscode ein und speichern Sie. Leeren Sie dann die Frontend-Caches (das Blitz-Symbol oben). Haben Sie früher schon ein Hazelchat-Skript in ein Template eingefügt, entfernen Sie es, damit der Chat nur einmal lädt.

6. 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 TYPO3-Administratorkonto? 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 TYPO3-Website hinzu:

1. composer require hazelchat/typo3 (oder "Hazelchat" aus dem TER installieren).
2. Das Set "Hazelchat" (hazelchat/hazelchat) zu unserer Site hinzufügen.
3. In den Site-Einstellungen unter Hazelchat diesen Code in "Installationscode" einfügen:
   [unser Installationscode aus Hazelchat]
4. Speichern und die Frontend-Caches leeren.

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

Was die Extension 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 Extension setzt https://app.hazelchat.co/widget.js mit Ihrem öffentlichen Schlüssel direkt vor </body> in die HTML-Seiten jeder Site, die das Hazelchat-Set nutzt, in jeder Sprache dieser Site. Jede Site einer TYPO3-Installation nutzt ihren eigenen Code. Die Extension liest nur zwei Site-Einstellungen, hat keine Datenbanktabellen und kein Backend-Modul und sendet nichts von TYPO3 an Hazelchat. Backend, Feeds und andere Seitentypen laden den Chat nie. Sendet Ihre Website über TYPO3 eine Content-Security-Policy, erlaubt die Extension https://app.hazelchat.co für den Chat. Ihre Einstellungen gibt es auf Deutsch und Englisch, und sie ist freie Software unter der GPL, Version 2 oder neuer.

Einwilligung der Besucher

TYPO3 hat kein eigenes Cookie-Banner. Muss Ihr Einwilligungs-Tool den Chat erst erlauben, schalten Sie in den Hazelchat-Site-Einstellungen Auf meinen Consent-Manager warten ein. 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. Die Extension richtet Einwilligungs-Tools nicht für Sie ein. Muss Ihre Website sogar das Herunterladen des Skripts blockieren, lassen Sie Ihr Einwilligungs-Tool auch dieses Skript blockieren.

Wenn der Chat nicht erscheint

• Ist das Set auf der Site?

  Der Code wirkt nur auf Sites, die unter Sets for this Site das Set Hazelchat haben.

• Caches leeren

  Nach dem Installieren, Ändern des Codes oder Entfernen des Sets leeren Sie die Frontend-Caches.

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

• 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

  Setzt die csp.yaml Ihrer Site inheritDefault: false oder sendet 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 TYPO3-Site auf einer anderen Domain braucht einen Tarif mit mehr Websites.

Ändern oder entfernen

Updates und Änderungen

TYPO3 findet neue Versionen selbst: composer update hazelchat/typo3, oder ohne Composer unter Admin Tools → Extensions.

1.0.0 (17. Oktober 2026): bringt den Hazelchat-Chat mit einem Installationscode auf die Seiten jeder Site, die das Hazelchat-Set nutzt; optional wartet er auf Ihren Consent-Manager; Einstellungen auf Deutsch und Englisch.