KI-Chatbot in Joomla einbinden: Schritt für Schritt in 5 Minuten
↑ Teil von KI-Chatbot für Website
Kurzfassung: Sie legen bei BotChata einen Agenten an, lassen Ihre Website indexieren und fügen ein einziges Script-Tag in ein eigenes Modul von Joomla ein: Position im Footer, „Auf allen Seiten“, veröffentlicht. Danach beantwortet der Bot Besucherfragen rund um die Uhr, nur aus den Inhalten Ihrer Website, in über 40 Sprachen. Eine Joomla-Eigenheit sollten Sie vorher kennen: Der Editor und der Textfilter löschen Scripts beim Speichern, wenn Sie nicht als Super User mit dem passenden Editor arbeiten. Wie Sie das umgehen, steht direkt unten.
→ Kostenlos starten — ohne Kreditkarte · 5 Minuten · Gratis-Tarif für immer
Was Sie brauchen
- Eine Joomla-Website, Version 5 oder 6 (in Joomla 4 sind Menüs und Filter gleich).
- Ein Konto in der Gruppe Super Users. Warum gerade diese Gruppe, erklärt der nächste Abschnitt.
- Ein BotChata-Konto: der Gratis-Tarif genügt (Anmeldung per E-Mail, ohne Kreditkarte).
Warum Joomla Ihr Script löscht — und wie Sie es verhindern
Eine typische Frage zu Joomla lautet nicht „wo einfügen?“, sondern „warum ist der Code nach dem Speichern weg?“. Das ist kein Fehler von BotChata. Joomla filtert HTML an zwei Stellen, und beide sind ab Werkseinstellung gegen <script> eingestellt:
| Filter | Werkseinstellung | Was das für Sie heißt |
|---|---|---|
| Editor TinyMCE → Feld „Verbotene Elemente“ | script,applet,iframe | TinyMCE entfernt das Script, solange Sie im TinyMCE-Editor arbeiten. Am sichersten ist ein anderer Editor (CodeMirror oder „Keiner“) |
| System → Konfiguration → Textfilter | Super Users: „Keine Filterung“. Administrator, Manager, Autoren: „Standard Blockierte Elemente“ | Speichert ein Administrator (nicht Super User) das Modul, entfernt Joomla das Script auf dem Server |
Der saubere Weg, ohne Sicherheitseinstellungen zu lockern:
- Melden Sie sich mit einem Konto der Gruppe Super Users an.
- Oben rechts im Benutzermenü: Konto bearbeiten → Reiter Basiseinstellungen → Editor → „Editor – CodeMirror“ (oder „Editor – Keiner“) → Speichern & Schließen.
- Legen Sie das Modul an (Anleitung unten).
- Danach können Sie den Editor wieder auf TinyMCE stellen. Das gespeicherte Modul bleibt unverändert, solange Sie es nicht erneut mit TinyMCE öffnen und speichern.
Den Textfilter für die Gruppe „Administrator“ auf „Keine Filterung“ zu stellen, empfehlen wir nicht: Dann dürfen alle Administratoren überall Scripts speichern. Für ein einziges Modul reicht der Weg oben.
Teil 1 — Agent in BotChata (ca. 3 Minuten)
Schritt 1: Agent anlegen
Registrieren Sie sich auf botchata.net und klicken Sie im Dashboard auf „Site hinzufügen“. Im Fenster „Agent hinzufügen“ tragen Sie „Site-Name“ und „Website-URL“ ein und klicken auf „Erstellen & Indexierung starten“.

Schritt 2: Indexierung abwarten
BotChata liest die erreichbaren Unterseiten und baut daraus die Wissensbasis. Das dauert meist wenige Minuten. Unter Training → Links sehen Sie jede Seite; steht sie auf „Indiziert“, ist der Agent bereit.

Typische Joomla-Falle: Inhalte, die nur in einem Modul stehen, das auf wenigen Menüeinträgen eingeblendet ist, oder Öffnungszeiten in einem Bild. Der Bot liest Text, keine Bilder. Steht etwas Wichtiges nur in einer Grafik, schreiben Sie es als Text dazu. Das hilft auch bei Google. Preise nimmt der Bot ohnehin nicht von Ihren Seiten, sondern aus der Preisliste im Dashboard (Training → Docs/Q&A → Preislisten).
Fehlt eine Unterseite, fügen Sie sie unter Training → Links mit „Link hinzufügen“ hinzu: 🌐 Gesamte Website oder 📄 Einzelne Seite.
Schritt 3: Kurz testen
Öffnen Sie die Übersicht des Agenten und stellen Sie im Test-Chat drei echte Kundenfragen („Wie lange dauert …?“, „Haben Sie samstags geöffnet?“). Stimmen die Antworten, geht es an den Einbau.

Schritt 4: Code kopieren
Unter Veröffentlichung → Widget, Reiter „Skript“, klicken Sie neben „Einbettungscode“ auf „Kopieren“. Im selben Reiter gibt es eine Plattform-Auswahl; hat BotChata Joomla beim Indexieren erkannt, steht dort „Ihre Website läuft offenbar auf dieser Plattform.“ Der Code 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>
deferlädt das Widget nach dem Seiteninhalt, die Seite wird also nicht ausgebremst. Das Widget läuft in einem abgeschotteten Shadow DOM und kann das Design Ihres Templates nicht verändern.
Teil 2 — Code in Joomla (ca. 2 Minuten)
✅ Methode A (empfohlen): eigenes Modul auf allen Seiten
- Im Backend: Inhalt → Site Module → Neu.
- Modultyp „Eigenes Modul“ wählen.
- Einen Titel vergeben (z. B. „BotChata“) und bei „Titel anzeigen“ auf Verbergen stellen. Sonst steht der Titel sichtbar im Footer.
- Das BotChata-Script in das Inhaltsfeld einfügen. Mit CodeMirror ist das ein reines Codefeld.
- Rechts unter Position eine Position wählen, die Ihr Template auf jeder Seite ausgibt. Im Standard-Template Cassiopeia ist das
footer. - Reiter „Menüzuweisung“ → „Auf allen Seiten“.
- Status: Veröffentlicht → Speichern & Schließen.
Lassen Sie unter Optionen die Einstellung „Inhalt vorbereiten“ auf Nein (Werkseinstellung). Sonst laufen Inhalts-Plugins über das Script.
Öffnen Sie das Modul danach kurz erneut: Steht das Script noch im Feld, hat der Filter es nicht entfernt.
Methode B: Child Template (für Entwickler)
Nur wenn Sie bewusst mit Template-Dateien arbeiten:
- System → Site Templates → Cassiopeia – Details und Dateien → „Child Template erstellen“.
- Den Child-Template-Stil als Standard setzen.
- Im Child Template
index.phpöffnen und das Script direkt vor</body>einfügen. - Speichern.
Warum ein Child Template: Änderungen direkt in der
index.phpvon Cassiopeia überschreibt das nächste Joomla-Update. Das Child Template bleibt erhalten. Für die meisten Websites ist Methode A trotzdem einfacher.
Mehrsprachige Joomla-Websites
Viele Joomla-Websites sind mehrsprachig, mit Sprachfilter und eigenen Menüs pro Sprache. Einen zweiten Bot brauchen Sie dafür nicht:
- Antworten: Ein Agent antwortet in der Sprache der Frage, in über 40 Sprachen, auch wenn ein Inhalt nur auf Deutsch auf der Website steht.
- Beschriftungen im Widget (Knöpfe, Eingabefeld) folgen der Browsersprache des Besuchers. Sie können sie unter Veröffentlichung → Widget festlegen oder pro Sprachversion mit
data-langim Code fixieren. - In Joomla legen Sie dafür zwei eigene Module an, eines pro Sprache, jeweils mit eigenem
data-lang(data-lang="de",data-lang="en") und dem Feld Sprache des Moduls auf die passende Sprache gesetzt.
Prüfen, ob es funktioniert
- Öffnen Sie Ihre Website in einem privaten Browserfenster.
- Unten rechts erscheint die BotChata-Sprechblase.
- Stellen Sie eine echte Frage zu Ihrem Angebot.
- Der Bot sollte in wenigen Sekunden mit Inhalten von Ihrer Website antworten.
Häufige Probleme
| Problem | Lösung |
|---|---|
| Das Script ist nach dem Speichern verschwunden. | Siehe oben: als Super User anmelden, Editor auf CodeMirror stellen, Modul neu speichern. |
| Modul gespeichert, aber kein Widget. | Status „Veröffentlicht“? Menüzuweisung „Auf allen Seiten“? Gibt Ihr Template die gewählte Position überhaupt aus? Danach System → Cache leeren und den Browser-Cache leeren. |
| Über dem Footer steht „BotChata“. | „Titel anzeigen“ im Modul auf Verbergen stellen. |
| Das Widget erscheint nur auf einigen Seiten. | Die Menüzuweisung steht auf „Ausgewählte“. Auf „Auf allen Seiten“ umstellen. |
| Zwei Sprechblasen. | Das Script steckt zweimal auf der Seite, zum Beispiel im Modul und in der index.php. Eines entfernen. |
| Der Bot sagt „weiß ich nicht“, obwohl es auf der Website steht. | Die Seite ist nicht indexiert oder die Information steht in einem Bild. Unter Training → Links prüfen und „Reindex starten“ klicken. Im Tarif Business wird die Website jede Woche automatisch neu indiziert. |
| Farben passen nicht zum Template. | Farben, Größe und hell/dunkel stellen Sie unter Veröffentlichung → Widget ein. |
Wenn der Bot läuft
- Jede Woche bekommen Sie eine E-Mail mit den Fragen, auf die Ihre Website keine Antwort hatte. Das ist Ihre Liste fehlender Inhalte, auch im Gratis-Tarif.
- Terminbuchung (ab Tarif Base, 39 €/Monat): Der Bot zeigt freie Zeiten und trägt Kunden ein, mit Google Calendar.
- Messenger und Instagram Direct als Kanäle desselben Agenten: ab Tarif Base, 39 €/Monat; Telegram ab Business, 119 €/Monat. WhatsApp gibt es derzeit nicht.
Was es kostet
| Tarif | Preis | Nachrichten/Monat |
|---|---|---|
| Gratis | 0 € für immer, ohne Kreditkarte | 100 |
| Base | 39 €/Monat | 1 500 |
| Business | 119 €/Monat | 8 000 |
| Premium | 299 €/Monat | 20 000 |
Fester Preis pro Tarif, ohne Tokens und Credits. Alle Preise.
→ Kostenlos starten — ohne Kreditkarte · Andere Plattformen: WordPress · TYPO3 · Wix