Integration mit WooCommerce: AI Search, Live-Shop-Suche und Bestellstatus

Verbinden Sie Ihren ChatLab-Chatbot mit Ihrem WooCommerce-Shop, damit Kunden Produkte finden und ihre Bestellungen direkt im Chat prüfen können. Produkte werden über AI Search gefunden, das Ihren indexierten WooCommerce-Katalog nach Bedeutung durchsucht, oder über die Live-Shop-Suche, die die Shop-API abfragt.

Beispielkonversation

Das Beispiel veranschaulicht das Kundenerlebnis. Die verfügbaren Aktionen und zurückgegebenen Informationen hängen von dieser Integration und Ihrer Konfiguration ab.

Wichtig: Best Practices für E-Commerce

Lesen Sie nach Abschluss der unten stehenden Integration den umfassenden Leitfaden zur Optimierung Ihres Chatbots für den E-Commerce: So richten Sie ChatLab für Ihren E-Commerce-Shop ein

Wie der Chatbot Produkte auf WooCommerce findet: AI Search und Live-Shop-Suche

Es gibt zwei Möglichkeiten, wie ein ChatLab-Chatbot Produkte in einem WooCommerce-Shop findet. Ein Chatbot nutzt entweder die eine oder die andere, niemals beide.

AI Search (empfohlen) - ChatLab führt einen eigenen Index Ihres WooCommerce-Katalogs und der Chatbot durchsucht ihn nach Bedeutung.

• Kunden fragen in natürlicher Sprache, zum Beispiel „ein rotes Kleid unter 300“. Eine Preisspanne wird als strikter Filter angewendet, und auch exakte Produktcodes (SKU, EAN) werden abgeglichen.
• Preis, Lagerbestand und Varianten werden im Moment der Antwort live aus WooCommerce ausgelesen, sodass Kunden auch zwischen den Index-Aktualisierungen stets aktuelle Daten sehen.
• Ergebnisse werden als Produktkarten im Chat angezeigt, bis zu 5 pro Antwort.
• Die Indizierung startet automatisch, sobald der Shop verbunden ist. Der Katalog verbraucht keine Trainingszeichen.
• Erforderlicher Plan: Jeder E-Commerce-Plan enthält diese Funktion (Free 100 Produkte, E-commerce Start 2.000, E-commerce Grow 5.000, E-commerce Scale 20.000). Bei einem Universal-Plan fügen Sie das Add-on „E-commerce integrations“ (30 $ pro Monat) sowie ein dem Chatbot zugewiesenes AI Search-Produktpaket (29 $ pro Monat, 5.000 Produkte) hinzu.

Live-Shop-Suche - Der Chatbot leitet die Suchanfrage des Kunden über die Shop-API an die WooCommerce-Suche weiter und antwortet mit den Ergebnissen, die der Shop zurückgibt.

• Es wird nichts indiziert und es muss nichts synchronisiert werden. Die Daten sind immer live.
• Es handelt sich um eine Stichwortsuche: Sie findet genau das, was die interne Suche Ihres Shops für diesen Begriff finden würde. Sie versteht Beschreibungen von Bedürfnissen, Synonyme oder Tippfehler nicht so, wie es AI Search tut.
• Erforderlicher Plan: Ein Universal-Plan mit dem Add-on „E-commerce integrations“ (30 $ pro Monat). Es ist kein Produktpaket erforderlich.

Wenn AI Search aktiviert ist, ersetzt sie die Live-Shop-Suche. Der Bestellstatus funktioniert auf beiden Wegen gleich. Eine dritte Option, das Trainieren auf gescannten Shop-Seiten, ist in jedem Plan verfügbar und für Informationsinhalte wie Lieferung und Rückgabe gedacht, nicht für Produkte. Einen vollständigen Vergleich finden Sie unter AI Search: how your chatbot finds products, und Produktlimits finden Sie unter E-commerce plans and limits.

Was die Integration bietet

Live-Shop-Suche (Produktsuche nach Begriff) - Der Chatbot leitet den Suchbegriff des Kunden an die WooCommerce-Suche weiter. Er durchsucht Produkttitel sowie Beschreibungen und liefert die 5 besten passenden, veröffentlichten Produkte mit folgenden Angaben zurück:

• Produkt-ID, Name und Beschreibung
• Preis und SKU
• Produktbild und direkter Link zur Produktseite

Produktsuche nach SKU - Kunden können Produkte anhand einer bestimmten SKU, einer Artikelnummer oder eines Produktcodes suchen. Das ist besonders praktisch, wenn Kunden die genaue Kennung bereits kennen - zum Beispiel aus einem gedruckten Katalog, einer früheren Bestellung oder einer Empfehlung. Gibt dieselben Produktfelder zurück wie die Standard-Produktsuche.

Produktsuche in Kategorie - Eine gezieltere Suche, die ein Stichwort mit einer bestimmten Produktkategorie kombiniert. Der Chatbot ermittelt zuerst die passende Kategorie und sucht anschließend darin nach relevanten Produkten. Gibt dieselben Produktfelder zurück wie die Standard-Produktsuche.

Kategorien abrufen - Der Chatbot kann eine Liste der in Ihrem Shop verfügbaren Produktkategorien abrufen. So hilft er Kunden bei der Orientierung im Sortiment oder grenzt Produktsuchen ein. Jede Kategorie enthält:

• Kategorie-ID, Name und Slug
• Kategoriebeschreibung

Bestelldetails - Standardmäßig geben Kunden eine Bestellnummer und die zugehörige E-Mail-Adresse an. Dabei werden die angegebenen Daten lediglich mit den Shop-Einträgen abgeglichen; es ist kein Beweis dafür, dass der Besucher Inhaber dieser E-Mail-Adresse ist. Über eine optionale Aktionseinstellung kann die Abfrage auch allein über die Bestellnummer erfolgen. Der Chatbot liefert folgende Angaben zurück:

• Bestellnummer, Gesamtsumme und Status (z. B. in Bearbeitung, fertiggestellt, storniert)
• Lieferadresse mit Vor- und Nachname des Empfängers, Firma sowie vollständiger Anschrift (Straße, Stadt, Bundesland/Region, Postleitzahl, Land)
• Bestellte Artikel mit Namen, Mengen, Einzelpreisen und Positions-Gesamtsummen

Voraussetzungen

Bevor Sie mit der WooCommerce-Integration beginnen, stellen Sie sicher:

• Ihr Chatbot ist in ChatLab erstellt. Die Installation des Storefront-Widgets erfolgt getrennt von der Anbindung der Shop-Daten.
• Sie haben Zugriff auf das WordPress-Admin-Panel Ihres WooCommerce-Shops

Empfohlen: Verbindung über das WordPress-Plugin

Wählen Sie unter Verbinden > WooCommerce (Connect > WooCommerce) die Option WooCommerce-Plugin herunterladen (Get the WooCommerce plugin) für die geführte Einrichtung. Installieren Sie das ChatLab-Plugin, öffnen Sie dessen WordPress-Menü, lassen Sie WooCommerce-Integration verbinden (Connect WooCommerce integration) ausgewählt und klicken Sie auf Weiter (Continue). Melden Sie sich bei ChatLab an und wählen Sie Ihren Chatbot aus. Dadurch wird Ihr Shop verbunden und das Widget installiert. Weitere Informationen finden Sie in der WordPress-Installationsanleitung.

Wählen Sie Mit manueller Einrichtung fortfahren (Continue with manual setup), wenn Sie Ihre eigenen API-Schlüssel verwenden müssen. Die folgenden Schritte beschreiben diese Alternative.

Schritt 1: API-Schlüssel in WooCommerce generieren

1. Melden Sie sich in Ihrem WordPress-Admin-Bereich an
2. Gehen Sie zu WooCommerce > Einstellungen (Settings)
3. Klicken Sie auf den Reiter Erweitert (Advanced)
4. Wählen Sie REST-API (REST API)
5. Klicken Sie auf Schlüssel hinzufügen (Add Key)
6. Geben Sie eine Beschreibung ein (z. B. „ChatLab-Integration“)
7. Wählen Sie den Benutzer aus, dem der Schlüssel zugewiesen werden soll - dies muss ein Benutzer mit der Rolle Administrator oder Shop-Manager (Shop Manager) sein (andere Rollen wie Kunde oder Abonnent besitzen nicht die erforderlichen Berechtigungen für den Zugriff auf WooCommerce-Daten)
8. Setzen Sie die Berechtigungen auf Lesen (Read)
9. Klicken Sie auf API-Schlüssel generieren (Generate API Key)
10. Kopieren Sie den Consumer Key und das Consumer Secret - speichern Sie diese sicher ab, da das Consumer Secret nicht erneut angezeigt werden kann

Schritt 2: WooCommerce in ChatLab verbinden

1. Melden Sie sich bei ChatLab an und wählen Sie Ihren Bot aus
2. Gehen Sie zum Tab Connect (Verbinden)

3. Klicken Sie auf der WooCommerce-Kachel auf Connect (Verbinden)
4. Geben Sie die URL of WooCommerce store (URL des WooCommerce-Shops) ein (Ihre vollständige Shop-URL, z. B. https://www.mystore.com)
5. Geben Sie den Customer Key ein (Consumer Key aus Schritt 1)
6. Geben Sie das Customer Secret ein (Consumer Secret aus Schritt 1)

7. Klicken Sie auf Connect (Verbinden)

ChatLab testet die Verbindung automatisch, indem geprüft wird, ob Ihre API-Zugangsdaten über die erforderlichen Zugriffsrechte verfügen. Bei Erfolg sehen Sie eine Bestätigungsmeldung.

Verbindungsoptionen

Das Verbindungsformular für WooCommerce enthält zusätzliche Einstellungen:

• Use order search instead of retrieve (Bestellsuche statt direktem Abruf verwenden) - Aktivieren Sie diese Option, wenn Ihr Shop Plugins für benutzerdefinierte Bestellnummern nutzt. Dabei wird eine suchbasierte Abfrage statt eines direkten Abrufs verwendet, was mit modifizierten Bestellnummerierungen kompatibel ist.
• Use product short description (Kurzbeschreibung des Produkts verwenden) - Wenn diese Option aktiviert ist, enthalten die Produktsuchergebnisse die WooCommerce-Kurzbeschreibung anstelle der vollständigen Beschreibung. Nützlich für Shops mit sehr langen Produktbeschreibungen.
• Include in-stock products only (Nur vorrätige Produkte einbeziehen) - Wenn diese Option aktiviert ist, enthalten die Produktsuchergebnisse nur Artikel, die derzeit auf Lager sind.
• Store language (Shop-Sprache) - Wählen Sie die Sprache Ihrer Produktdaten.
• Custom metadata fields (Benutzerdefinierte Metadatenfelder) - Schließen Sie nur die Produktfelder ein, die für Kunden nützlich sind; geben Sie keine privaten Metadaten frei.
• Maximum variants (Maximale Variantenanzahl) - Begrenzt, wie viele Varianten für ein Produkt zurückgegeben werden.

Schritt 3: WooCommerce-Aktionen konfigurieren

Nach dem Verbinden können Sie einzelne KI-Aktionen aktivieren und anpassen. Navigieren Sie zu Einstellungen > Aktionen (Settings > Actions) und filtern Sie nach der Plattform WooCommerce.

Zu den Keyword- und Bestellaktionen gehören:

• WooCommerce - Product Search - ermöglicht dem Chatbot, Ihren Produktkatalog nach Stichwörtern zu durchsuchen
• WooCommerce - Product Search by SKU - ermöglicht dem Chatbot, Produkte anhand ihrer SKU, Referenznummer oder ihres Produktcodes zu finden
• WooCommerce - Product Search in Category - ermöglicht dem Chatbot, innerhalb einer bestimmten Produktkategorie zu suchen
• WooCommerce - Get Categories - ermöglicht dem Chatbot, die Produktkategorien in Ihrem Shop aufzulisten
• WooCommerce - get product variants - ruft die verfügbaren Varianten eines ausgewählten Produkts ab
• WooCommerce - Get Order - ermöglicht dem Chatbot, Bestellinformationen anhand von Bestell-ID und E-Mail-Adresse abzufragen

Durch die Einrichtung der Verbindung werden Bestellabfrage, Kategorien, Stichwortsuche, Kategoriesuche und Varianten aktiviert. Product Search by SKU muss separat überprüft und aktiviert werden, falls Sie die Funktion nutzen möchten. Deaktivieren Sie Aktionen, die Kunden nicht verwenden sollen. Öffnen Sie eine Aktion zur Bearbeitung und verwenden Sie anschließend im Dialogfenster Aktivieren (Enable) oder Aktualisieren (Update). Sie können auch das Aktions-Label (die Nachricht, die Nutzern während der Ausführung der Aktion angezeigt wird) sowie die Anweisungen anpassen, die steuern, wie die KI die jeweilige Aktion nutzt.

Optionen für Bestellabfrage und Produktsuche

In der Konfiguration der Bestellaktion ist Bestellabfrage ohne E-Mail-Verifizierung zulassen (Allow order lookup without email verification) standardmäßig deaktiviert. Wenn Sie diese Option aktivieren, werden Bestelldetails für jeden sichtbar, der eine gültige Bestell-ID angeben kann. Lassen Sie sie deaktiviert, es sei denn, Ihr System verfügt über entsprechende Zugriffskontrollen.

Das ChatLab-WooCommerce-Plugin unterstützt außerdem erweiterte durchsuchbare Produktfelder und unscharfe SKU-Suche (Fuzzy Matching). Diese Optionen erfordern die erkannte Plugin-Erweiterung; ohne sie nutzt die Stichwortsuche die native Suche von WooCommerce und die SKU-Abfrage erfordert eine exakte Übereinstimmung. Überprüfen Sie die entsprechende Produktsuch-Aktion, bevor Sie Anweisungen verfassen, die auf diesen Optionen basieren.

AI Search für WooCommerce: Katalog, Re-Indexierung und Einstellungen

In einem E-commerce-Plan oder in einem Universal-Plan, wenn dem Chatbot ein AI Search-Produktpaket zugewiesen ist, ist AI Search aktiviert und ersetzt die Live-Shop-Suche. Die Indexierung startet automatisch, sobald der Shop verbunden ist.

• Katalog überprüfen - Öffnen Sie Training > E-commerce catalog (E-Commerce-Katalog) und prüfen Sie die Tabs Products (Produkte) und Categories (Kategorien). Unter Shop > Products (Shop > Produkte) sehen Sie den Bereich Product catalog (Produktkatalog) und die Karte AI Search packs on this chatbot (AI Search-Pakete auf diesem Chatbot).
• Re-Indexierung planen - Verwenden Sie Schedule auto-retrain (Automatisches Neutrainieren planen) unter Training > E-commerce catalog. Die Re-Indexierung kann bis zu täglich ausgeführt werden und ist in jedem E-commerce-Plan sowie mit jedem Produktpaket verfügbar. Mit Train now (Jetzt trainieren) oder Retrain (Neutrainieren) starten Sie sie bei Bedarf manuell. Aktualisierungen erfolgen inkrementell: Unveränderte Produkte werden übersprungen und entfernte Produkte aus dem Index gelöscht.
• Aktion überprüfen - Öffnen Sie unter Settings > Actions (Einstellungen > Aktionen) die Option WooCommerce - AI product search. Die Optionen sind Include product card (Produktkarte einschließen), Products in stock only (Nur vorrätige Produkte) und Number of products to return (Anzahl der zurückzugebenden Produkte).
• Produktkarten anzeigen - Aktivieren Sie Enable Offer Cards unter Settings > Model & Advanced (Einstellungen > Modell & Erweitert). Siehe Offer Cards.

Wenn der Katalog größer als das Produktlimit ist, stoppt die Indexierung beim Erreichen des Limits und der Inhaber des Chatbots erhält eine E-Mail. Die oben beschriebenen Optionen der Live-Shop-Suchaktion gelten nicht zwingend für AI Search.

Ihre Integration testen

Öffnen Sie nach der Aktivierung der Aktionen die Übersicht (Overview) und testen Sie Folgendes:

• „Zeige mir Laufschuhe“ (testet die Produktsuche)
• „Ich suche nach Produkt-SKU WH-1234“ (testet die Produktsuche nach SKU)
• „Welche Kategorien gibt es?“ (testet das Abrufen von Kategorien)
• „Zeige mir Schuhe in der Kategorie Sportbekleidung“ (testet die Produktsuche in einer Kategorie)
• „Wie ist der Status meiner Bestellung #1001?“ (testet Bestelldetails; geben Sie die passende E-Mail-Adresse für eine Bestellung an, auf die Sie zugriffsberechtigt sind)

Überprüfen Sie, ob die Antworten mit den Daten aus Ihrem WooCommerce-Shop übereinstimmen und ob sich die Produktlinks korrekt öffnen.

Chatbot in Ihrem WooCommerce-Shop installieren

Um das Chat-Widget zu Ihrer WordPress-/WooCommerce-Website hinzuzufügen, lesen Sie die ausführliche Anleitung: Chatbot in einem WooCommerce-Shop installieren

Demo ansehen

Sie können eine Live-WooCommerce-Integration in Aktion sehen: https://yourwear.chatlab.com/shop

Verwandte Artikel

• AI Search: Wie Ihr Chatbot Produkte findet
• E-Commerce-Pläne und -Limits
• E-Commerce-Einrichtungsleitfaden
• Chatbot zu Ihrer Website hinzufügen