TYPO3-Chatbot: einen KI-Assistenten in TYPO3 einbauen

Kyros ist keine TYPO3-Extension, und in TYPO3 müssen Sie nichts installieren. Für einen TYPO3-Chatbot mit Kyros kopieren Sie im Dialog „Widget installieren“ ein Snippet und fügen es einmal in TYPO3 ein. Für die schwebende Chat-Blase in der Ecke jeder Seite ist das eine Zeile:

<script src="https://kyros.omniratio.de/api/widget?id=…&sig=…&type=chatbot"></script>

Die zweite Variante ist der Inline-Frame: ein <iframe>, der den Chat an einer festen Stelle im Seiteninhalt zeigt, etwa auf einer Kontakt- oder Hilfeseite. Beide Codes finden Sie im Installationsdialog unter „Website / Framework“ → „TYPO3“. Dort steht als Anleitung: „Fügen Sie den Code in Ihr Fluid-Seitentemplate direkt vor dem schließenden Body-Tag ein oder per TypoScript (page.footerData). Redakteure können auch ein Inhaltselement ‚Reines HTML‘ verwenden.“

Eine Ergänzung dazu: Ein Element „Reines HTML“ wirkt nur auf der Seite, auf der es steht. Soll die Blase auf der ganzen Website erscheinen, gehört das Snippet ins TypoScript oder ins Template. Wie das geht, zeigt die Anleitung weiter unten.

Was „TYPO3 KI“ hier bedeutet – und was nicht

Kyros ist ein KI-Assistent für die Besucherinnen und Besucher Ihrer Website. Er beantwortet Fragen aus den Seiten, deren URLs Sie in Kyros eintragen, und aus Goldenen Antworten, die Sie selbst schreiben. Stützt sich eine Antwort auf Ihre Seiten, stehen darunter nummerierte Quellenlinks („Weiterführende Links“). Enthalten Ihre Inhalte keine Antwort, ist der Assistent angewiesen, das offen zu sagen.

Ein KI-Werkzeug für Redakteure im TYPO3-Backend ist Kyros dagegen nicht: Es schreibt, übersetzt und pflegt keine Inhalte in TYPO3 und braucht keinen Zugang zu Ihrem Backend. Wer genau so ein Werkzeug sucht, ist mit Kyros nicht richtig bedient. Auch bei den Inhalten gibt es Grenzen: Kyros erfasst keine ganze Website und keine Sitemap selbstständig, und PDF-Dateien lassen sich nicht einlesen. Was der Assistent wissen soll, muss auf einer Webseite stehen, die Sie eintragen, oder als Goldene Antwort angelegt sein. Ändern Redakteure eine Seite in TYPO3, liest Kyros sie auf Wunsch automatisch alle 6, 12 oder 24 Stunden oder wöchentlich neu ein.

Für die ganze Website: per TypoScript (page.footerData)

Bevor Sie TYPO3 anfassen, bereiten Sie den Assistenten in Kyros vor:

1. Legen Sie einen Assistenten an und tragen Sie die URLs der Seiten ein, aus denen er antworten soll, eine pro Zeile. Änderungen im Studio gehen erst mit „Veröffentlichen“ live.
2. Öffnen Sie „Widget installieren“, wählen Sie „Schwebende Blase“ und unter „Website / Framework“ den Eintrag „TYPO3“. Kopieren Sie den Code.
3. Unter „Website-Zugriff“ legen Sie fest, auf welchen Domains sich der Chat öffnen lässt, also die Domains Ihrer TYPO3-Website. Auf anderen Domains erscheint zwar der Chat-Button, das Chatfenster lädt dort aber nicht.

Laut TYPO3-Dokumentation gibt TYPO3 alles, was unter page.footerData steht, am Ende der Seite aus, direkt vor dem schließenden </body>-Tag. Genau dorthin gehört das Kyros-Snippet. Tragen Sie im TypoScript Ihres Sitepackages ein Textobjekt mit dem kopierten Code ein:

page.footerData.1790 = TEXT
page.footerData.1790.value = <script src="https://kyros.omniratio.de/api/widget?id=…&sig=…&type=chatbot"></script>

Die Nummer 1790 ist nur ein Beispiel; prüfen Sie, ob sie in Ihrem TypoScript schon vergeben ist. Das Sitepackage ist laut TYPO3-Dokumentation eine eigene Extension mit Templates, TypoScript und Assets Ihrer Website und damit der vorgesehene Ort für solche Änderungen. Eine zusätzliche Extension für Kyros brauchen Sie nicht.

Nicht geeignet ist page.jsFooterInline: Dort erwartet TYPO3 reinen JavaScript-Code und setzt die <script>-Tags selbst darum. Ein vollständiges <script src="…">-Tag gehört deshalb nicht dorthin.

Alternative: im Fluid-Template

Pflegt Ihre Agentur oder IT das Layout im Sitepackage, kann das Snippet auch im Fluid-Seitentemplate stehen, vor dem schließenden </body>-Tag. Entwickler können das Skript stattdessen mit dem ViewHelper <f:asset.script> einbinden; solche Skripte gibt TYPO3 standardmäßig im Footer aus.

Für eine Seite oder als Inline-Frame: „Reines HTML“

Ohne Zugriff auf TypoScript oder Templates nutzen Redakteure das Inhaltselement „Reines HTML“:

1. Wählen Sie in Kyros unter „Widget installieren“ den Modus „Inline-Frame“ und unter „Website / Framework“ den Eintrag „TYPO3“. Kopieren Sie den Code.
2. Legen Sie in TYPO3 auf der gewünschten Seite ein neues Inhaltselement an und öffnen Sie im Auswahldialog den Reiter „Besondere Elemente“.
3. Wählen Sie „Reines HTML“, fügen Sie den Code ein und speichern Sie das Element.
4. Laden Sie die Seite im Frontend neu und stellen Sie dem Chat eine Testfrage.

In der Auswahlliste für den Inhaltstyp heißt dieselbe Gruppe in TYPO3 v13 „Spezielle Elemente“; das Element heißt in beiden Fällen „Reines HTML“. Wichtig: Es wirkt nur auf der Seite, auf der es steht. Für den Inline-Frame ist das gewollt. Setzen Sie auf diesem Weg die schwebende Blase ein, erscheint sie ebenfalls nur auf dieser einen Seite. Finden Sie das Element nicht, wenden Sie sich an die Person, die Ihre TYPO3-Installation betreut.

Content-Security-Policy in TYPO3 v12 und v13

Seit TYPO3 12.3 gibt es eine API für die Content-Security-Policy (CSP). Im Frontend ist sie in v12 und v13 standardmäßig ausgeschaltet. Eingeschaltet wird sie über die Feature-Flags security.frontend.enforceContentSecurityPolicy oder security.frontend.reportContentSecurityPolicy oder pro Site in der Datei config/sites/<site>/csp.yaml.

Sendet Ihre Website eine Content-Security-Policy, muss sie Inhalte von kyros.omniratio.de zulassen, sonst blockiert der Browser das Widget. Die TYPO3-Dokumentation beschreibt dafür in der csp.yaml den Abschnitt mutations mit mode: "append".

Was blockiert wird, zeigt die Konsole der Entwicklertools. Testen Sie die Einstellung zuerst im Report-Modus: Verstöße zeigt TYPO3 unter Admin Tools > Content Security Policy. Schalten Sie die Richtlinie erst danach scharf. Fragen zum Einbau können Sie uns über die Kontaktseite stellen.

Nach dem Einbau

• Die schwebende Blase erscheint auf den Seiten, für die Ihr TypoScript oder Template gilt; der Inline-Frame nur auf der Seite mit dem Element.
• Farben, Logo, Launcher und Position stellen Sie in Kyros ein, nicht in TYPO3.
• Unter „Code-Ablauf“ legen Sie fest, ob ein Einbettungscode nie oder nach 7, 30 oder 90 Tagen oder einem Jahr abläuft.
• In den Chatprotokollen sehen Sie, was Besucher fragen und wie sie die Antworten bewerten. Mit „Überarbeiten“ speichern Sie eine bessere Antwort als Goldene Antwort.

Quellen: offizielle TYPO3-Dokumentation

• TypoScript-Referenz: PAGE (footerData, jsFooterInline)
• Tutorial: Site Package
• ViewHelper-Referenz: f:asset.script
• Inhaltselement „Plain HTML“ (fluid_styled_content)
• Content Security Policy (TYPO3 Core API)

Die verlinkten Seiten sind auf Englisch. Die deutschen Bezeichnungen „Besondere Elemente“, „Spezielle Elemente“ und „Reines HTML“ stammen aus den offiziellen TYPO3-Übersetzungen für v12 und v13. Stand: 1. Oktober 2026.