KI-Chatbot in Magento 2 einbinden — Schritt für Schritt
↑ Teil von KI-Chatbot für Website
Kurz gesagt: Sie legen in BotChata einen Agenten an, lassen Ihren Shop indexieren und fügen ein Script-Tag unter Content → Design → Configuration → Footer → Miscellaneous HTML ein. Danach beantwortet der Bot Fragen zu Versand, Rückgabe und Produkten aus den Seiten Ihres Shops, in über 40 Sprachen, rund um die Uhr. Etwa 5 Minuten, ohne Erweiterung, ohne Entwickler. Im Tarif Base verbinden Sie zusätzlich einen Magento-Integration-Token: Dann zeigt der Bot Produktkarten aus dem Katalog und fragt den Bestellstatus ab, nachdem er E-Mail oder Telefonnummer des Kunden geprüft hat.
→ Kostenlos starten — ohne Kreditkarte · In 5 Minuten live · Dauerhaft kostenloser Tarif
Warum das für Magento-Shops zählt: Magento-Kataloge sind groß, und die Antworten, die Kunden suchen, verteilen sich auf CMS-Seiten, Produktattribute und den Footer. Ein Bot, der alles gelesen hat, antwortet in Sekunden. Einmal pro Woche bekommen Sie eine E-Mail mit den Fragen, die er nicht beantworten konnte: genau die Lücken, die Sie auf Ihren Seiten schließen sollten.
Was Sie brauchen
- Magento Open Source oder Adobe Commerce 2.4 mit Admin-Zugriff auf Content → Design.
- Ein BotChata-Konto. Für das Widget reicht der kostenlose Tarif (Anmeldung per E-Mail, ohne Kreditkarte). Er indexiert bis zu 200.000 Zeichen; für einen großen Katalog brauchen Sie Base.
- Für Produktkarten und Bestellstatus: den Tarif Base und Zugriff auf System → Integrations.
Die Menünamen stehen unten auf Englisch, wie im Standard-Backend. Mit einem deutschen Sprachpaket sind die Menüs übersetzt; die Position im Menü ist dieselbe.
Teil 1 — BotChata einrichten (ca. 3 Minuten)
Schritt 1: Agent anlegen
Registrieren Sie sich auf botchata.net und öffnen Sie das Dashboard. Klicken Sie auf „Site hinzufügen", tragen Sie im Dialog „Agent hinzufügen" den Site-Namen und die Website-URL Ihres Shops ein und klicken Sie auf „Erstellen & Indexierung starten".

Schritt 2: Indexierung abwarten
BotChata liest Produkt- und Kategorieseiten, Versand und Rückgabe, AGB, FAQ und Kontakt. Unter Training → Links sehen Sie jede erfasste Seite; sind sie als indexiert markiert, ist der Agent bereit. Bei großen Katalogen prüfen Sie, ob auch die CMS-Seiten (Versand, Widerruf) dabei sind, nicht nur Produkte.

Schritt 3: Kurz testen
Öffnen Sie die Übersicht des Agenten und stellen Sie im Test-Chat echte Kundenfragen: „Liefern Sie in die Schweiz?", „Wie lange kann ich zurückschicken?". Ein „Weiß ich nicht" heißt: Die Information fehlt auf Ihrer Website. Genau das wollen Sie vor Ihren Kunden wissen.

Schritt 4: Einbettungscode kopieren
Öffnen Sie Veröffentlichung → Widget, wechseln Sie auf den Reiter „Skript" und klicken Sie auf „Kopieren":

<script
src="https://botchata.net/api/widget.js"
data-api-key="IHR_SCHLÜSSEL"
data-api-url="https://botchata.net/api"
defer
></script>
Teil 2 — Script in Magento einfügen (ca. 2 Minuten)
Magento hat dafür ein Feld im Backend. Keine Theme-Dateien, kein Modul.
✅ Weg A (empfohlen): Footer → Miscellaneous HTML
- Gehen Sie in der Admin-Seitenleiste auf Content → Design → Configuration.
- Suchen Sie in der Tabelle Ihre Store View und klicken Sie in der Spalte Action auf Edit.
- Klappen Sie unter Other Settings den Abschnitt Footer auf.
- Fügen Sie das BotChata-Script in Miscellaneous HTML ein. Magento setzt es direkt vor das schließende
</body>. - Klicken Sie auf Save Configuration.
- Meldet Magento ungültige Cache-Typen, aktualisieren Sie sie unter System → Tools → Cache Management. Mit Varnish oder CDN davor: auch dort leeren.
Mehrere Store Views (etwa eine pro Sprache)? Wiederholen Sie das für jede, in der der Chat erscheinen soll. Ein Agent bedient alle: Er erkennt die Sprache des Kunden.
Weg B: HTML Head → Scripts and Style Sheets
Derselbe Bildschirm, nur der Abschnitt HTML Head statt Footer. Das Script steht dann vor </head>; dank defer wartet es trotzdem auf die Seite. Nehmen Sie diesen Weg, wenn Ihr Theme oder eine andere Erweiterung das Footer-Feld schon belegt.
Zum Checkout. Ab Magento 2.4.7 setzen die Zahlungsseiten die Content Security Policy durch, und laut Adobe müssen Scripts aus diesen Design-Feldern dafür freigegeben sein. Im übrigen Shop meldet die Policy nur. Praktisch heißt das: Der Chat erscheint auf Produkt-, Kategorie- und CMS-Seiten; im Checkout eventuell nicht, solange Ihr Entwickler
botchata.netnicht unterscript-srcundconnect-srcin die CSP-Freigaben (csp_whitelist.xml) einträgt. Für die meisten Shops ist ein Checkout ohne Chat in Ordnung.
Optional: Produktkarten und Bestellstatus (Base)
Das Script gibt dem Bot Ihre Seiten. Die Integration gibt ihm Ihren Katalog und Ihre Bestellungen, live. Sie nutzt Magentos eigenen Integration-Token; in Ihrem Shop wird nichts installiert.
In Magento
- System → Extensions → Integrations → Add New Integration. Namen eingeben (z. B. „BotChata") und mit Ihrem Admin-Passwort bestätigen.
- Links API öffnen, Resource Access auf Custom stellen und anhaken:
- Catalog → Inventory → Products (Produktsuche);
- Sales → Operations → Orders → Actions → View (Bestellstatus);
- Sales → Operations → Shipments (Sendungsnummern).
- Save, dann Activate → Allow und den Access Token kopieren.
- Ab Magento 2.4.4: Stores → Configuration → Services → OAuth → Consumer Settings → „Allow OAuth Access Tokens to be used as standalone Bearer tokens" → Yes, speichern.
Adobe stuft diesen Schalter als nicht empfohlen ein, weil ein Integration-Token nicht abläuft. Geben Sie der Integration nur die drei Ressourcen oben und widerrufen Sie sie unter System → Integrations, wenn Sie BotChata nicht mehr nutzen.
Ohne Schritt 4 lehnt Magento jede Anfrage mit demselben
401 "The consumer isn't authorized to access %resources"ab wie bei fehlender Berechtigung. Beides sieht gleich aus. Prüfen Sie diesen Schalter zuerst.
In BotChata
- Funktionen → Integrationen → Magento → Verbinden.
- Store URL und Integration access token eintragen, Speichern.
- Verbindung testen klicken. Der Test prüft nur die Produktsuche.
- Für Bestellungen fragen Sie im Test-Chat der Übersicht nach einer echten Bestellung, mit deren E-Mail-Adresse.
- Unter Funktionen → Möglichkeiten → Online-Shop die „Preiswährung auf der Karte" auf Euro stellen (sichtbar, wenn Produktkarten an sind). Magentos API liefert den Preis ohne Währung.
Was der Bot aus Magento bekommt
| Kunde fragt | Was passiert |
|---|---|
| „Haben Sie das Leinen-Shirt?" | Suche im Produktnamen, bis zu 6 Treffer als Karten: Foto, Name, Preis, Link |
| „Wo ist Bestellung 42?" | Die Abfrage braucht Bestellnummer und E-Mail oder Telefon aus der Bestellung; fehlt eins, gibt sie nichts zurück. „42" findet 000000042; eine Nummer mit Store-Präfix muss vollständig eingegeben werden |
| Kontakt passt | Status, Datum, Summe und Währung, Versandart, Sendungsnummer mit Versanddienstleister, Artikel. Ein konfigurierbares Produkt erscheint als gekaufte Variante („Leinen-Shirt Blau") |
| Kontakt passt nicht | Nichts. Der Abgleich läuft im Code, bevor das Modell Bestelldaten sieht |
Fünf Magento-Details, die Sie vor dem Verbinden kennen sollten:
- Der Status ist Magentos Code, nicht Ihre Bezeichnung, z. B.
pending,processing,complete,canceled,holded,closed. Die REST-API von Magento hat keinen Endpunkt für Status-Bezeichnungen. - Die Suche findet die Wortfolge im Namen. „Leinen-Shirt" findet „Leinen-Shirt Blau", „Shirt Leinen" nicht.
- Die Karte zeigt den regulären Preis. Sonderpreise und Katalogpreisregeln kommen nicht an.
- Der Kartenlink wird als
ihr-shop.de/<url-key>.htmlgebaut, Magentos Standard. Haben Sie das URL-Suffix für Produkte geändert oder Store-Codes in den URLs, klicken Sie einen Kartenlink zur Probe. - Dieselbe Bestellnummer in zwei Store Views? Der Bot beantwortet nur die, deren Kontakt passt, und lehnt ab, wenn beide passen.
Warum der Bestellstatus „vorübergehend nicht verfügbar" meldet
Eine früher für etwas anderes angelegte Integration hat meist nur Catalog-Rechte. Die Produktsuche läuft dann, Bestellfragen bekommen „vorübergehend nicht verfügbar". Ergänzen Sie Orders (und Shipments für Sendungsnummern) in den Ressourcen und klicken Sie Reauthorize: Magento erzeugt dann einen neuen Token, den Sie in BotChata eintragen. Oder legen Sie wie oben eine eigene Integration nur für BotChata an. Ohne Shipments antwortet die Bestellung trotzdem; der Bot kennt nur die Sendungsnummer nicht. Er bekommt statt einer leeren Liste den Wert null, also nichts, was „nicht verschickt" sagt.
Prüfen, ob es funktioniert
- Öffnen Sie den Shop in einem privaten Fenster.
- Unten rechts erscheint die BotChata-Sprechblase.
- Stellen Sie eine echte Frage („Liefern Sie nach Österreich?").
- Die Antwort kommt in Sekunden, aus den Seiten Ihres Shops.
Häufige Probleme
| Problem | Lösung |
|---|---|
| Das Widget erscheint nicht. | Caches unter System → Tools → Cache Management aktualisieren, Varnish/CDN leeren. Prüfen, ob Sie die Store View bearbeitet haben, die Sie gerade ansehen. |
| Überall sichtbar, nur nicht im Checkout. | Das ist die CSP der Zahlungsseiten ab 2.4.7 (siehe oben). botchata.net freigeben oder den Checkout ohne Chat lassen. |
| „Verbindung testen" scheitert mit 401. | Der Bearer-Schalter unter Stores → Configuration → Services → OAuth ist aus, oder der Integration fehlt Catalog → Products. |
| Produktkarten zeigen eine nackte Zahl. | „Preiswährung auf der Karte" unter Funktionen → Möglichkeiten → Online-Shop setzen. |
| Ein Kartenlink führt auf 404. | Ihr Produkt-URL-Suffix ist nicht .html, oder die URL enthält einen Store-Code. Echte URL eines Produkts vergleichen. |
| Der Bot kennt ein neues Produkt nicht. | Es kam nach der Indexierung dazu. Unter Training → Links neu indexieren oder die Integration verbinden, dann liest die Suche den Katalog live. |
| Antwortet in der falschen Sprache. | Der Bot erkennt die Sprache des Kunden (40+). In einem frischen Fenster testen. |
Häufige Fragen
Gibt es eine BotChata-Erweiterung im Magento Marketplace? Nein, und Sie brauchen keine. Das Widget ist ein Script-Tag in Ihrer Design-Konfiguration. Produktsuche und Bestellstatus laufen über Magentos eigenen Integration-Token.
Funktioniert das mit Adobe Commerce und Adobe Commerce Cloud? Ja, bei Magento Open Source und Adobe Commerce on-premises oder auf Cloud-Infrastruktur (cloud infrastructure). Adobe Commerce as a Cloud Service (Edge-Delivery-Storefront) nutzt eine andere Storefront, dort gilt diese Anleitung nicht.
Kann der Bot den Bestellstatus nennen? Ja, im Tarif Base, mit einem Integration-Token mit Bestellrechten. Die Abfrage braucht Bestellnummer und E-Mail oder Telefonnummer aus der Bestellung; passen sie nicht, zeigt der Bot nichts.
Was kostet das? Der kostenlose Tarif kostet dauerhaft 0 €, 100 Nachrichten/Monat, ohne Kreditkarte. Bezahlte Tarife haben feste Preise: Base 39 €, Business 119 €, Premium 299 € pro Monat, ohne Token und Credits (alle Preise). Die Magento-Integration gibt es ab Base. (Hosting und ggf. Lizenz von Magento rechnen Sie separat ab.)
Verlangsamt das Widget meinen Shop?
Nein. defer, isolierter Shadow DOM, keine Render-Blockade.
Jetzt starten
Geben Sie Ihrem Magento-Shop einen Assistenten, der jede Seite gelesen hat und Kunden zu jeder Uhrzeit antwortet.
→ Kostenlos starten — ohne Kreditkarte
In 5 Minuten live. 100 Nachrichten/Monat kostenlos. Produktkarten und Bestellstatus ab Base (39 €/Monat). Den Überblick gibt KI-Chatbot für Onlineshops.