KI-Chatbot in TYPO3 einbinden — der schnelle Weg (eine Zeile TypoScript)

Q: Was kostet das?

Der Gratis-Start kostet 0 € (100 Nachrichten/Monat, ohne Kreditkarte). Bezahlte Tarife beginnen bei 29 €/Monat — fester Preis pro Tarif, keine Credits pro Nachricht.

Q: Verlangsamt das Widget meine Website?

Nein. Es lädt asynchron (defer / includeJSFooter) in einem isolierten Shadow-DOM und blockiert das Rendern nicht.

↑ Teil von KI-Chatbot für Website

Kurzfassung: Sie erstellen bei BotChata einen KI-Agenten, lassen ihn Ihre Website indexieren und fügen ein einziges Script-Tag in TYPO3 ein — entweder über eine Zeile TypoScript (seitenweit) oder ein TYPO3-Inhaltselement „Reines HTML“ (einzelne Seite). Danach beantwortet der Chatbot Besucherfragen rund um die Uhr — nur auf Basis Ihrer eigenen Inhalte, in über 40 Sprachen. DSGVO-konform, Hosting in Deutschland.

→ Kostenlos starten — ohne Kreditkarte · In 5 Minuten live · Für immer kostenloser Tarif

Für wen das ist: TYPO3-Sites werden meist von einer Agentur oder einem internen Integrator betreut. Die seitenweite Methode unten ist eine Zeile TypoScript — geben Sie sie an die Person weiter, die Ihr TYPO3-Template pflegt. Die Methode für einzelne Seiten kommt ganz ohne Code aus.

Was Sie brauchen (Voraussetzungen)

Eine TYPO3-Website (v11 / v12 / v13) mit Backend-Zugang. Für die seitenweite Methode: Zugriff auf das Template- / Site-Package-TypoScript.
Ein BotChata-Konto — der Gratis-Start genügt (Anmeldung mit E-Mail, ohne Kreditkarte).
5 Minuten Zeit.

Teil 1 — BotChata einrichten (ca. 3 Minuten)

Schritt 1: Konto erstellen und Agenten anlegen

Registrieren Sie sich auf botchata.net und öffnen Sie das Dashboard. Gehen Sie zu „AI-Agenten“ → „Neuer Agent“, vergeben Sie einen Namen (z. B. Ihren Firmennamen) und bestätigen Sie.

Für den Gratis-Start brauchen Sie keine Kreditkarte — nur Ihre E-Mail. (Den 7-tägigen Test der Premium-Funktionen aktivieren Sie später optional mit Karte; für diese Anleitung nicht nötig.)

Schritt 2: Website indexieren lassen

Öffnen Sie beim Agenten den Reiter „Links / Quellen“ und klicken Sie auf „Quelle hinzufügen“. Geben Sie Ihre Website-URL ein und wählen Sie „Gesamte Website hinzufügen“.

BotChata liest jede erreichbare Unterseite und macht daraus die Wissensbasis. Für ~50 Seiten dauert das 1–3 Minuten. Der Status wechselt von „Indexierung“ zu „Bereit“.

Warum das wichtig ist: Der Bot antwortet ausschließlich aus Ihren indexierten Inhalten. Steht eine Antwort nicht auf Ihrer Website, sagt er das ehrlich — statt etwas zu erfinden. Das schützt Ihre Glaubwürdigkeit.

Schritt 3: Kurz testen

Wechseln Sie zum Reiter „Übersicht“ und stellen Sie dem Bot im Live-Vorschaufenster ein paar typische Kundenfragen. Stimmen die Antworten, geht es ans Einbinden.

Schritt 4: Einbettungs-Code kopieren

Öffnen Sie die Installations-/Einbetten-Ansicht des Agenten und kopieren Sie das Script-Tag. Es sieht so aus:

<script
  src="https://botchata.net/api/widget.js"
  data-api-key="IHR_SCHLÜSSEL"
  data-api-url="https://botchata.net/api"
  defer
></script>

Das defer-Attribut sorgt dafür, dass das Widget asynchron lädt und Ihre Ladezeit (Core Web Vitals) nicht ausbremst. Das Widget läuft in einem isolierten Shadow-DOM — es kann das Design Ihres TYPO3-Templates nicht stören.

Teil 2 — Code in TYPO3 einfügen (ca. 2 Minuten)

✅ Methode A (empfohlen, seitenweit): eine Zeile TypoScript

Fügen Sie das Script in das Setup-TypoScript Ihrer Site ein — im Template-Modul (Web → Template → Info/Ändern → Setup) oder, besser, in der setup.typoscript Ihres Site-Packages:

page.includeJSFooter.botchata = https://botchata.net/api/widget.js
page.includeJSFooter.botchata.external = 1
page.includeJSFooter.botchata.defer = 1
page.includeJSFooter.botchata.data-api-key = IHR_SCHLÜSSEL
page.includeJSFooter.botchata.data-api-url = https://botchata.net/api

Oder, wenn Sie das Tag wortwörtlich einsetzen möchten:

page.footerData.1746 = TEXT
page.footerData.1746.value (
  <script src="https://botchata.net/api/widget.js" data-api-key="IHR_SCHLÜSSEL" data-api-url="https://botchata.net/api" defer></script>
)

Leeren Sie anschließend die TYPO3-Caches (Frontend-Caches löschen) — das Widget erscheint auf jeder Seite.

Das ist der saubere, update-sichere Weg für eine gepflegte TYPO3-Site. Geben Sie das Snippet an Ihren Integrator weiter, wenn Sie TypoScript nicht selbst verwalten.

Methode B (ohne Code, einzelne Seite): ein Inhaltselement „Reines HTML“

Wenn Sie den Chat nur auf einer Seite möchten und TypoScript nicht anfassen wollen:

Seite bearbeiten → Inhaltselement hinzufügen → „Spezielle Elemente“ → „Reines HTML“.
Das BotChata-Script in das HTML-Feld einfügen.
Speichern und Cache leeren.

Methode B wirkt nur auf der Seite, auf der sie sitzt. Für ein seitenweites schwebendes Widget nutzen Sie Methode A.

Schritt 3 — Prüfen, ob es funktioniert (Verifizierung)

Frontend-Caches leeren, dann Ihre Website in einem neuen, privaten Browserfenster (Inkognito) öffnen.
Unten rechts erscheint die BotChata-Sprechblase.
Klicken Sie darauf und stellen Sie eine echte Frage zu Ihrem Angebot.
Der Bot sollte in wenigen Sekunden mit Inhalten von Ihrer Website antworten.

Sehen Sie das Widget? Dann sind Sie live. 🎉

DSGVO-Hinweis für deutsche Websites

Hosting in Deutschland: BotChata läuft bei Hetzner in Deutschland; Daten verlassen die EU nicht ohne Einwilligung, und es findet kein KI-Training mit Ihren Daten statt. (Passt natürlich zur starken Verankerung von TYPO3 in Behörden und im deutschen Mittelstand.)
Auftragsverarbeitung: Schließen Sie den AVV mit BotChata ab (Vorlage im Konto verfügbar) und nennen Sie das Tool in Ihrer Datenschutzerklärung.
Consent-Tool: Wenn Sie eine TYPO3-Consent-Extension nutzen, ordnen Sie das BotChata-Script so zu, dass es erst nach Einwilligung lädt.
EU-AI-Act-konform: Besucher erkennen vor dem ersten Chat, dass sie mit einer KI sprechen — die Transparenzpflicht nach Art. 50 (ab August 2026) ist standardmäßig erfüllt.

Häufige Probleme (Troubleshooting)

Problem	Lösung
Das Widget erscheint nicht.	Alle TYPO3-Caches leeren (Frontend + allgemein), dann den Browser-Cache. Prüfen Sie, ob das TypoScript im aktiven Template/Root-Line liegt.
Die TypoScript-Zeile wirkt nicht.	Stellen Sie sicher, dass Ihr Root-Template das Site-Package-Setup einbindet und das Setup auf der richtigen Root-Seite liegt. Im TypoScript-Object-Browser prüfen, ob `page.includeJSFooter` gesetzt ist.
Der Bot antwortet „Das weiß ich nicht“.	Die betreffende Seite ist evtl. nicht indexiert. In BotChata unter „Quellen“ prüfen und neu indexieren (ein Klick).
Das Widget kollidiert mit dem Design.	Sollte durch das Shadow-DOM nicht passieren. Tritt es doch auf: Position/Z-Index im Widget-Builder (ab Business) anpassen.
Antwortet in der falschen Sprache.	BotChata erkennt die Sprache des Besuchers automatisch (40+ Sprachen). Mit einer deutschen Frage in einem frischen Fenster testen.

Häufige Fragen (FAQ)

Braucht BotChata eine TYPO3-Extension? Nein. Ein einziges Script-Tag genügt — eingefügt über eine Zeile TypoScript (seitenweit) oder ein Inhaltselement „Reines HTML“ (einzelne Seite). Keine Extension nötig.

Brauche ich einen Entwickler? Für die seitenweite Methode brauchen Sie Zugriff auf TypoScript — das übernimmt meist Ihr Integrator (es ist buchstäblich eine Zeile). Das HTML-Inhaltselement für eine einzelne Seite kommt ganz ohne Code aus.

Ist das DSGVO-konform? Ja. Hosting in Deutschland (Hetzner), AVV inklusive, kein KI-Training mit Ihren Daten, über Ihr Consent-Tool steuerbar. Details oben.

Erfindet der Bot Antworten? Nein. Er antwortet nur aus Ihren indexierten Website-Inhalten. Fehlt eine Information, sagt er das ehrlich, statt zu raten.

Was kostet das? Der Gratis-Start kostet 0 € (100 Nachrichten/Monat, ohne Kreditkarte). Bezahlte Tarife beginnen bei 29 €/Monat — fester Preis pro Tarif, keine Credits pro Nachricht.

Verlangsamt das Widget meine Website? Nein. Es lädt asynchron (defer / includeJSFooter) in einem isolierten Shadow-DOM und blockiert das Rendern nicht.

Jetzt starten

Geben Sie Ihrer TYPO3-Website in wenigen Minuten einen KI-Chatbot, der Ihre Inhalte kennt.

→ Kostenlos starten — ohne Kreditkarte

100 Nachrichten/Monat gratis. DSGVO-konform, Hosting in Deutschland.