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

Verbinden Sie Ihren ChatLab-Chatbot mit Ihrem PrestaShop-Shop, damit Kunden Produkte finden und ihre Bestellungen direkt im Chat überprüfen können. Produkte werden über AI Search gefunden, die Ihren indexierten PrestaShop-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 den E-Commerce

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

So findet der Chatbot Produkte auf PrestaShop: AI Search und Live-Shop-Suche

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

AI Search (empfohlen) - ChatLab führt einen eigenen Index Ihres PrestaShop-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 genaue Produktcodes (SKU, EAN) werden abgeglichen.
• Preis, Lagerbestand und Varianten werden im Moment der Antwortabfrage live aus PrestaShop ausgelesen, sodass Kunden auch zwischen den Index-Aktualisierungen stets aktuelle Daten sehen.
• Ergebnisse erscheinen als Produktkarten im Chat, bis zu 5 pro Antwort.
• Die Indizierung startet automatisch, sobald der Shop verbunden ist. Der Katalog verbraucht keine Trainingszeichen.
• Erforderlicher Plan: In jedem E-commerce-Plan enthalten (Free 100 Produkte, Start 2.000, Grow 5.000, 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 PrestaShop-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 keine Bedarfsbeschreibungen, Synonyme oder Tippfehler so wie AI Search.
• Erforderlicher Plan: Ein Universal-Plan mit dem Add-on „E-commerce integrations“ (30 $ pro Monat). Ein Produktpaket ist nicht erforderlich.

Wenn AI Search aktiviert ist, ersetzt sie die Live-Shop-Suche. Der Bestellstatus funktioniert auf beiden Wegen gleich. Eine dritte Option, das Trainieren anhand gescannter Shop-Seiten, ist in jedem Plan verfügbar und für Informationsinhalte wie Lieferung und Rücksendungen gedacht, nicht für Produkte. Einen vollständigen Vergleich finden Sie unter AI Search: how your chatbot finds products, und Details zu den 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 PrestaShop-Suche weiter. Diese durchsucht Produkttitel sowie Beschreibungen und liefert die 5 passendsten Produkte mit folgenden Details zurück:

• Produkt-ID, Name und Beschreibung
• Preis (optional inklusive Steuern und angewendeten Sonderpreisen bzw. Rabatten)
• Direkter Link zur Produktseite in Ihrem Shop
• Produktbild

Produktsuche nach Referenz (SKU) - Kunden können Produkte anhand genauer Referenzcodes suchen. Der Chatbot durchsucht verschiedene Identifikatortypen - Referenz/SKU, EAN-13-Barcode, ISBN und MPN - sowohl bei Hauptprodukten als auch bei deren Varianten (Kombinationen). Dies ist besonders nützlich, wenn Kunden einen bestimmten Produktcode aus einem Katalog, von einer Rechnung oder von einer Verpackung vorliegen haben.

Bestelldetails - Standardmäßig geben Kunden eine Bestell-ID und die mit der Bestellung verknüpfte E-Mail-Adresse an. Beide Angaben werden mit den Shop-Daten abgeglichen; dies stellt keinen Nachweis über den tatsächlichen Besitz der E-Mail-Adresse dar. Die optionale Einstellung Allow order lookup without email verification (Bestellabfrage ohne E-Mail-Verifizierung erlauben) ermöglicht die Suche ausschließlich über die Bestell-ID. Lassen Sie diese Option deaktiviert, sofern Ihre Umgebung nicht über entsprechende Zugriffskontrollen verfügt. Der Chatbot liefert folgende Angaben zurück:

• Bestellreferenz, Datum und aktueller Status (z. B. in Bearbeitung, abgeschlossen, storniert)
• Gesamtbetrag der Bestellung
• Name des Empfängers, Firma, vollständige Lieferadresse (Straße, Stadt, Postleitzahl) und Telefonnummer
• Name des Versanddienstleisters und Sendungsverfolgungsnummern (mehrere Sendungsnummern werden unterstützt)
• Bestellte Artikel mit Namen, Mengen und Einzelpreisen

Voraussetzungen

Stellen Sie vor Beginn der PrestaShop-Integration sicher:

• Ihr Chatbot ist in ChatLab erstellt. Die Verbindung der Shop-Daten und die Widget-Installation sind separate Schritte; das Modul kann beides übernehmen.
• Sie haben Zugriff auf Ihr PrestaShop-Admin-Panel (Back Office)

Empfohlen: Verbindung über das Modul herstellen

Verwenden Sie für eine Neuinstallation die geführte Einrichtung des PrestaShop-Moduls. Über Connect my store (Meinen Shop verbinden) können Sie sich bei ChatLab anmelden und Ihren Chatbot auswählen. Die folgenden manuellen Schritte über den Webservice sind eine Alternative; erstellen Sie keine zweite Verbindung, wenn das Modul den Shop bereits verbunden hat.

Schritt 1: Webservice in PrestaShop aktivieren

1. Melden Sie sich in Ihrem PrestaShop-Backoffice an
2. Gehen Sie zu Configure > Advanced Parameters > Webservice (Konfigurieren > Erweiterte Einstellungen > Webservice)

3. Scrollen Sie nach unten zum Abschnitt Configuration (Konfiguration)
4. Setzen Sie Enable PrestaShop's webservice (PrestaShop-Webservice aktivieren) auf Yes (Ja)
5. Klicken Sie auf Save (Speichern)

Schritt 2: Einen Webservice-Schlüssel erstellen

1. Klicken Sie auf derselben Webservice-Seite auf Add new webservice key (Neuen Webservice-Schlüssel hinzufügen)

2. Klicken Sie auf Generate (Generieren), um einen neuen Schlüssel zu erstellen
3. Geben Sie eine Beschreibung ein (z. B. „ChatLab Integration“)
4. Vergewissern Sie sich, dass der Schlüssel auf Enabled (Aktiviert) gesetzt ist
5. Gewähren Sie unter den Ressourcenberechtigungen Zugriff auf View (GET) für die folgenden Ressourcen:
   • addresses
   • attachments
   • carriers
   • categories
   • combinations
   • configurations
   • customers
   • languages
   • order_carriers
   • order_details
   • order_states
   • orders
   • product_customization_fields
   • product_feature_values
   • product_features
   • product_option_values
   • product_options
   • products
   • search
   • specific_price_rules
   • specific_prices
   • states
   • shops
   • stock_availables
   • tags
   • tax_rule_groups
   • tax_rules
   • taxes

6. Klicken Sie auf Save (Speichern)
7. Kopieren Sie den generierten Webservice-Schlüssel - Sie benötigen ihn im nächsten Schritt

Schritt 3: Ermitteln Sie das URL-Format Ihrer Produkte

1. Gehen Sie im PrestaShop-Backoffice auf Configure > Shop Parameters > Traffic & SEO (Konfigurieren > Shop-Einstellungen > Traffic & SEO)

2. Scrollen Sie nach unten zum Abschnitt Schema of URLs (URL-Schema)
3. Kopieren Sie den Wert aus dem Feld Route to products (z. B. {category:/}{id}{-:id_product_attribute}-{rewrite}{-:tags}.html)

Schritt 4: PrestaShop in ChatLab verbinden

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

3. Klicken Sie auf der PrestaShop-Kachel auf Connect (Verbinden)
4. Geben Sie Ihren Webservice key (Webservice-Schlüssel aus Schritt 2) ein
5. Geben Sie Ihre Shop url (die vollständige URL Ihres Shops, z. B. https://www.mystore.com) ein
6. Geben Sie Ihr Product url format (Produkt-URL-Format aus Schritt 3) ein

7. Klicken Sie auf Initialize Configuration (Konfiguration initialisieren) - dadurch werden die verfügbaren Sprachen und Shops aus Ihrem Shop abgerufen
8. Wählen Sie die richtige Default language (Standardsprache) und, falls angeboten, den gewünschten Prestashop store (PrestaShop-Shop) aus
9. Klicken Sie auf Connect (Verbinden)

ChatLab testet die Verbindung automatisch, indem geprüft wird, ob Ihr Webservice-Schlüssel über die erforderlichen Zugriffsrechte verfügt. Bei Erfolg wird eine Bestätigungsmeldung angezeigt.

Schritt 5: PrestaShop-Aktionen konfigurieren

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

Die folgenden Aktionen sind verfügbar:

• Prestashop - product search - ermöglicht dem Chatbot, Ihren Produktkatalog nach Namen zu durchsuchen
• Prestashop - search by reference - ermöglicht dem Chatbot, Produkte nach Referenz/SKU, EAN-13-, ISBN- oder MPN-Codes zu finden
• Prestashop - order details - ermöglicht dem Chatbot, Bestellinformationen abzurufen
• Prestashop - get product variants - ermöglicht dem Chatbot, detaillierte Varianteninformationen (Größen, Farben) für ein bestimmtes Produkt abzurufen

Bei der Einrichtung der Verbindung werden die Standardaktionen aktiviert. Überprüfen Sie deren Status und deaktivieren Sie diejenigen, die Kunden nicht nutzen sollen. Öffnen Sie eine Aktion zur Bearbeitung und nutzen Sie anschließend Enable (Aktivieren) oder Update (Aktualisieren) im Dialogfenster. 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 jede Aktion ausführt.

Wenn die Aktion "Search by reference" aktiviert ist, greift die reguläre Produktsuche automatisch auf eine Referenzcode-Suche zurück, falls nach Namen keine Ergebnisse gefunden werden. Das bedeutet, dass Kunden eine SKU oder einen Barcode in eine normale Suchanfrage eingeben können und trotzdem präzise Ergebnisse erhalten.

Produkte mit Wiederverfügbarkeitsdatum anzeigen (Vorbestellung)

Wenn "Products in stock only" (Nur vorrätige Produkte) in den Einstellungen der Produktsuche-Aktion aktiviert ist, können Sie zusätzlich "Show products with restock date" (Produkte mit Wiederverfügbarkeitsdatum anzeigen) aktivieren. Dadurch kann der Chatbot nicht vorrätige Produkte berücksichtigen, für die in PrestaShop ein voraussichtliches Wiederverfügbarkeitsdatum hinterlegt ist. Anstatt diese Produkte komplett auszublenden, informiert der Chatbot den Kunden über das Wiederverfügbarkeitsdatum und darüber, dass das Produkt vorbestellbar ist.

Voraussetzungen:

• In PrestaShop muss "Bestellung von Produkten ohne Lagerbestand erlauben" aktiviert sein (Shop-Parameter > Artikeleinstellungen bzw. Shop Parameters > Product Settings)
• Der Webservice-Schlüssel muss Lesezugriff (GET bzw. View) auf die Ressourcen combinations und configurations haben
• Für die Kombinationen der Produkte muss in PrestaShop ein available_date hinterlegt sein

Preise inklusive Steuern

Aktivieren Sie die Option "Apply tax (VAT) to prices" (Mehrwertsteuer auf Preise anwenden) in den Einstellungen der Produktsuche-Aktion, um Preise inklusive Steuern anzuzeigen. Wenn dies aktiviert ist, berechnet der Chatbot die Preise anhand der Steuerregeln aus Ihrem PrestaShop-Shop basierend auf dem Standardland des Shops. Vergleichen Sie das Ergebnis mit Ihrer Storefront. Kundenspezifische Steuerregeln, der Standort sowie Anpassungen im Checkout können dennoch zu abweichenden Gesamtsummen führen.

Voraussetzungen:

• Der Webservice-Schlüssel muss Lesezugriff (GET bzw. View) auf die Ressourcen taxes, tax_rules, tax_rule_groups und configurations haben

Spezifische Preise (Rabatte und Aktionen)

Aktivieren Sie die Option "Apply specific prices (discounts/promotions)" (Sonderpreise für Rabatte und Aktionen anwenden) in den Einstellungen der Produktsuche-Aktion, um reduzierte Preise aus den spezifischen Preisregeln von PrestaShop anzuzeigen. Wenn für ein Produkt ein Rabatt aktiv ist, zeigt der Chatbot sowohl den reduzierten als auch den ursprünglichen Preis an, damit Kunden die Ersparnis sehen können.

Dies deckt universelle spezifische Preisregeln ab - Werbeaktionen und Rabatte, die für alle Kunden ab einer Mindestmenge von 1 gelten. Zeitlich begrenzte Aktionen werden ebenfalls unterstützt; der Chatbot wendet nur Rabatte an, die basierend auf ihrem Start- und Enddatum aktuell aktiv sind.

Voraussetzungen:

• Der Webservice-Schlüssel muss Lesezugriff (GET bzw. View) auf die Ressourcen specific_prices und specific_price_rules haben

AI Search für PrestaShop: 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 prüfen - öffnen Sie Training > E-commerce catalog (E-Commerce-Katalog) und überprüfen Sie die Reiter Products (Produkte) und Categories (Kategorien). Unter Shop > Products (Produkte) finden Sie den Bereich Product catalog (Produktkatalog) sowie die Karte AI Search packs on this chatbot (AI Search-Pakete auf diesem Chatbot).

• Re-Indexierung planen - nutzen 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 den Vorgang bei Bedarf manuell. Die 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 Aktion Prestashop - AI product search. Zu den Optionen gehören Include product card, Products in stock only und Number of products to return.

• 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 am Limit und der Eigentümer des Chatbots erhält eine E-Mail. Optionen der oben beschriebenen Live-Shop-Suchaktion gelten nicht zwingend für AI Search.

Testen Ihrer Integration

Öffnen Sie nach dem Aktivieren der Aktionen die Übersicht (Overview) und probieren Sie Folgendes aus:

• „Zeige mir Laufschuhe“ (testet die Produktsuche)
• „Ich suche nach dem Produkt ABC-12345“ (testet die Suche nach Referenz/SKU)
• „Wie ist der Status meiner Bestellung 12345?“ (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 PrestaShop-Shop übereinstimmen, ob Produktlinks korrekt geöffnet werden und ob Preise Steuern sowie Rabatte enthalten, wenn diese Optionen aktiviert sind.

Chatbot in Ihrem PrestaShop-Shop installieren

Eine detaillierte Anleitung zum Hinzufügen des Chat-Widgets zu Ihrer PrestaShop-Storefront finden Sie hier: Chatbot in einem PrestaShop-Shop installieren

Verwandte Artikel

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