Hilfezentrum
Chatbot-Integrationen

Integration mit BigCommerce

Zuletzt aktualisiert:

Verbinden Sie Ihren BigCommerce-Shop mit Ihrem ChatLab-Chatbot. Sobald die Verbindung steht, durchsucht der Chatbot Ihre Produkte, indexiert den gesamten Katalog für AI Search, ermöglicht Kunden das Hinzufügen von Produkten in den Warenkorb direkt aus dem Chat heraus und prüft den Status ihrer Bestellungen unmittelbar in Ihrem Shop.

Beispielunterhaltung

Im Gespräch erleben

Bestellung prüfen

Erfordert einen angebundenen Shop und die aktivierte Bestellaktion. Verfügbare Felder hängen von der Integration ab. Ein Abgleich der E-Mail-Adresse gilt nicht als Identitätsnachweis.

ChatLab-BeispielBeispielhafte Unterhaltung

Besucher: Wo ist meine Bestellung?

Spielen Sie das Beispiel ab oder lesen Sie es unten. Es werden keine echten Kundendaten verwendet.
1 / 5

Der Kunde fragt nach einer bestehenden Bestellung.

Die Wiedergabe pausiert, sobald dieses Beispiel den sichtbaren Bereich verlässt. Dies ist eine Simulation, kein Live Chat. Die Widget-Bedienelemente innerhalb der Wiedergabe sind nicht interaktiv.
Vollständiges Beispiel lesen
  1. Der Kunde fragt nach einer bestehenden Bestellung.

    Besucher: Wo ist meine Bestellung?

  2. Die standardmäßige Abfrage benötigt beide Angaben.

    Assistent: Bitte nennen Sie mir Ihre Bestellnummer und die E-Mail-Adresse, die beim Bezahlen verwendet wurde.

  3. Verwenden Sie in diesem Beispiel fiktive Daten.

    Besucher: 41982, anna@example.com

  4. Die Aktion fragt den angebundenen Shop ab.

    Bestellung 41982 wird geprüft...

  5. Geben Sie nur Informationen wieder, die der Shop zurückgibt.

    Assistent: Bestellung 41982 ist als versendet markiert. Der Versanddienstleister ist DPD. Bitte prüfen Sie die Sendungsverfolgungsseite auf Lieferaktualisierungen.

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

Nachdem Sie die nachfolgende Integration abgeschlossen haben, lesen Sie den ausführlichen Leitfaden zur Optimierung Ihres Chatbots für den E-Commerce: So richten Sie ChatLab für Ihren E-Commerce-Shop ein

Was die Integration bietet

KI-Produktsuche - Kunden beschreiben in ihren eigenen Worten, was sie benötigen, und der Chatbot findet passende Produkte in Ihrem Katalog. Die Antwort enthält:

  • Produktname und Beschreibung
  • Aktueller Preis in Ihrer Shop-Währung und bei reduzierten Produkten auch der reguläre Preis
  • Produktbild
  • Direkter Link zur Produktseite in Ihrem Shop
  • Verfügbarkeit, SKU, Marke, Kategorien und Produktoptionen (Größen, Farben), sofern beim Produkt vorhanden

Produktsuche nach Begriff - Eine einfache Stichwortsuche in Ihrem BigCommerce-Katalog. Die KI-Produktsuche ersetzt diese automatisch, sobald der Katalog indexiert ist.

Bestellstatus - Der Kunde gibt die Bestellnummer sowie die beim Checkout verwendete E-Mail-Adresse an, und der Chatbot antwortet mit dem Bestellstatus, den bestellten Artikeln, den Gesamtsummen und den Sendungsverfolgungsdetails, sobald die Bestellung versendet wurde. Bestellungen werden stets mit der E-Mail-Adresse des Kunden abgeglichen, sodass eine erratene Bestellnummer niemals die Bestellung einer anderen Person preisgibt.

In den Warenkorb - Produktkarten im Chat können eine Schaltfläche Add to cart (In den Warenkorb) anzeigen. In Ihrer BigCommerce-Storefront legt die Schaltfläche das Produkt direkt in den Warenkorb des Kunden, und der Warenkorbzähler im Seitenkopf wird aktualisiert. Bei Produkten mit Optionen wie Größe oder Farbe wählt der Kunde die Variante zunächst im Chat aus. Bei Produkten mit Optionen, die der Chat nicht erfassen kann (beispielsweise ein erforderliches Textfeld für eine Gravur), öffnet die Schaltfläche die Produktseite.

Chat-Widget auf Ihrer Storefront - ChatLab fügt das Chat-Widget über den BigCommerce Script Manager für Sie zu Ihrer Storefront hinzu, sodass kein Code eingefügt werden muss.

Sehen Sie das Warenkorb-Erlebnis in Aktion

Ein Beispiel für den Warenkorb sowie Anweisungen zum Testen auf der Storefront finden Sie unter Hinzufügen von Produkten zum Warenkorb. Der folgende Ablauf dient der Veranschaulichung; er führt keinen echten BigCommerce-Warenkorbvorgang aus.

Im Gespräch erleben

Vor dem Hinzufügen zum Warenkorb eine Variante auswählen

Beispielhafter Ablauf: Die tatsächlichen Warenkorb-Schaltflächen und Variantenauswahlen hängen von Plattform und Storefront ab. Diese Vorschau führt keine Warenkorb-Aktion aus.

ChatLab-BeispielBeispielhafte Unterhaltung

Smaragdgrünes Wickelkleid, $79. Viskose, Midilänge.

Spielen Sie das Beispiel ab oder lesen Sie es unten. Es werden keine echten Kundendaten verwendet.
1 / 4

Suchergebnisse liefern in unterstützten Shops eine Produktkarte mit Warenkorb-Funktion.

Die Wiedergabe pausiert, sobald dieses Beispiel den sichtbaren Bereich verlässt. Dies ist eine Simulation, kein Live Chat. Die Widget-Bedienelemente innerhalb der Wiedergabe sind nicht interaktiv.
Vollständiges Beispiel lesen
  1. Suchergebnisse liefern in unterstützten Shops eine Produktkarte mit Warenkorb-Funktion.

    Smaragdgrünes Wickelkleid, $79. Viskose, Midilänge.

  2. Der Kunde wählt über die unterstützten Warenkorb-Funktionen ein Produkt und eine Größe aus.

    Besucher: Smaragdgrünes Wickelkleid, Größe 38.

  3. Den Erfolg erst bestätigen, nachdem die Storefront den Warenkorb-Vorgang angenommen hat.

    Assistent: Beispielergebnis: Die ausgewählte Variante wurde in Ihren Warenkorb im Shop gelegt.

  4. Bezahlung und Kassiervorgang verbleiben im Shop.

    Assistent: Überprüfen Sie Ihren Warenkorb im Shop, um Menge, Preis und Lieferung zu bestätigen, und fahren Sie anschließend mit dem Checkout fort.

Was die Integration nicht bietet

  • Checkout im Chat. Der Kunde schließt den Kauf in Ihrem BigCommerce-Shop ab.
  • Live-Bestandsbenachrichtigungen. Preise und Verfügbarkeit werden bei der Antwort des Chatbots aus BigCommerce ausgelesen, der Chatbot benachrichtigt Kunden jedoch nicht über spätere Änderungen.
  • In den Warenkorb auf Headless-Storefronts. Die Warenkorb-Schaltfläche funktioniert auf Storefronts, die auf BigCommerce-Themes basieren. Auf einer Headless-Storefront öffnet sie stattdessen die Produktseite, und das Chat-Widget muss manuell zu dieser Website hinzugefügt werden.

Voraussetzungen

  • Ein BigCommerce-Shop, bei dem Sie Inhaber des Shops sind oder als Benutzer die Berechtigung haben, Apps zu installieren oder API-Konten zu erstellen.
  • Die Integration BigCommerce, die in Ihrem ChatLab-Plan enthalten ist.
  • Für die KI-Produktsuche: Dem Chatbot zugewiesene AI Search-Kapazität, die für Ihre sichtbaren Produkte ausreicht. Prüfen Sie die verfügbare Kapazität unter Shop > Products (Produkte).
  • Keine andere Shop-Integration, die mit demselben Chatbot verbunden ist.

Wählen Sie einen der beiden folgenden Wege. Beide führen zum selben Ergebnis.

Option A: ChatLab-App installieren

  1. Gehen Sie in Ihrem BigCommerce-Control-Panel zu Apps, suchen Sie nach ChatLab und klicken Sie auf Install (Installieren).
  2. Überprüfen Sie die Berechtigungen und klicken Sie auf Confirm (Bestätigen). ChatLab fordert Lesezugriff auf Produkte, Bestellungen, Kunden und Shop-Informationen sowie Zugriff auf Storefront-Inhalte an, um sein Chat-Widget hinzuzufügen.
  3. Die ChatLab-Seite öffnet sich innerhalb Ihres Control-Panels. Klicken Sie auf Continue setup (Einrichtung fortsetzen). Das ChatLab-Onboarding öffnet sich in einem neuen Browser-Tab.
  4. Melden Sie sich bei Ihrem ChatLab-Konto an oder erstellen Sie eines, falls Sie noch keines haben.
  5. Wählen Sie einen bestehenden Chatbot aus oder erstellen Sie einen neuen für diesen Shop.

Das ist alles. ChatLab verbindet den Shop mit dem ausgewählten Chatbot, aktiviert die Aktionen für Produktsuche und Bestellstatus, startet die Indexierung Ihres Katalogs und fügt das Chat-Widget zu Ihrer Storefront hinzu. Sie können ChatLab jederzeit wieder über das Menü Apps Ihres Control-Panels öffnen.

Das Deinstallieren der App in BigCommerce deaktiviert die Integration in ChatLab und entfernt das Chat-Widget von Ihrer Storefront. Ihr Chatbot und seine Unterhaltungen bleiben in Ihrem ChatLab-Konto erhalten.

Option B: Über ein API-Konto auf Shop-Ebene verbinden

Nutzen Sie diese Option, wenn Sie den Zugang lieber selbst einrichten möchten oder einen Chatbot anbinden wollen, ohne die App zu installieren.

Schritt 1: API-Konto in BigCommerce erstellen

  1. Gehen Sie in Ihrem BigCommerce-Control-Panel zu Settings (Einstellungen) und anschließend zu Store-level API accounts (API-Konten auf Shop-Ebene).
  2. Klicken Sie auf Create API account (API-Konto erstellen) und vergeben Sie einen Namen, zum Beispiel ChatLab.
  3. Legen Sie die Berechtigungen fest:
    • Products (Produkte) - read-only (schreibgeschützt)
    • Orders (Bestellungen) - read-only (schreibgeschützt)
    • Customers (Kunden) - read-only (schreibgeschützt)
    • Information & settings (Informationen & Einstellungen) - read-only (schreibgeschützt)
    • Content (Inhalt) - modify (ändern)
  4. Klicken Sie auf Save (Speichern). BigCommerce zeigt die Zugangsdaten einmalig an und lädt sie als Textdatei herunter.
  5. Kopieren Sie den API path (API-Pfad) und das Access token (Zugriffstoken).

Der API-Pfad sieht ähnlich aus wie api.bigcommerce.com/stores/abc123/v3/. Der Teil zwischen stores/ und /v3/ ist Ihr Store-Hash.

Halten Sie das Zugriffstoken geheim. Sie können es jederzeit widerrufen, indem Sie das API-Konto in BigCommerce löschen.

Schritt 2: Shop in ChatLab verbinden

  1. Öffnen Sie Ihren Chatbot in ChatLab und gehen Sie zu Shop.
  2. Klicken Sie auf die Kachel BigCommerce.
  3. Fügen Sie den API-Pfad (oder nur den Store-Hash) in das Feld Store hash or API path (Store-Hash oder API-Pfad) und das Token in Access token (Zugriffstoken) ein.
  4. Klicken Sie auf Check connection (Verbindung prüfen). ChatLab liest das Shop-Profil aus und zeigt den Shop-Namen, die Storefront-Adresse sowie die Währung an.
  5. Klicken Sie auf Connect (Verbinden).

ChatLab testet die Verbindung und schaltet die Aktionen für Produktsuche und Bestellstatus frei. Wenn dem Chatbot AI Search-Kapazität zugewiesen ist, beginnt die Katalogindexierung sofort und das Bestätigungsfenster weist Sie darauf hin. Dasselbe Fenster informiert Sie darüber, ob das Chat-Widget zu Ihrer Storefront hinzugefügt wurde. Das Zugriffstoken wird verschlüsselt gespeichert und nie wieder angezeigt; lassen Sie das Token-Feld leer, wenn Sie die Verbindung lediglich aktualisieren möchten.

Aktionen konfigurieren

Gehen Sie zu Settings > AI Actions (Einstellungen > KI-Aktionen). Für BigCommerce stehen drei Aktionen zur Verfügung:

  • BigCommerce - AI product search - semantische Suche im indexierten Katalog. In den Einstellungen können Sie die vollständige Produktkarte in die Antwort aufnehmen, Ergebnisse auf vorrätige Produkte beschränken und die Schaltfläche Add to cart aktivieren.
  • BigCommerce - product search - Stichwortsuche im BigCommerce-Katalog, die verwendet wird, wenn AI Search für den Chatbot nicht verfügbar ist. Auch sie kann auf vorrätige Produkte beschränkt werden und die Schaltfläche Add to cart anzeigen.
  • BigCommerce - order details - Abfrage des Bestellstatus. Ratenbegrenzung und Maskierung personenbezogener Daten sind in den Aktionseinstellungen verfügbar.

Jede Aktion verfügt über einen bearbeitbaren Prompt und eine Aktionsbezeichnung, die im Chat angezeigt wird, während der Chatbot arbeitet.

Katalog überprüfen

Öffnen Sie Training > E-commerce catalog (Training > E-Commerce-Katalog), um den Indexierungsfortschritt zu verfolgen, die indexierten Produkte zu durchsuchen und den Katalog nach größeren Änderungen im Shop neu zu trainieren. Produkte, die in Ihrem Shop nicht sichtbar sind, werden nicht indexiert.

Produkte ohne Beschreibung werden ausschließlich anhand von Name, Marke, Kategorien und Attributen indexiert. Wenn Ihre Produkte in BigCommerce keine Beschreibungen haben, verbessert bereits eine kurze Beschreibung die Suchergebnisse spürbar.

Wenn Sie den Chatbot zusätzlich mit den Seiten Ihrer Website trainieren, erkennt ChatLab einen BigCommerce-Shop und überspringt Produkt-, Kategorie- und Markenseiten. Produktdaten stammen aus dem Katalog, daher müssen sie nicht ein zweites Mal von den Seiten eingelesen werden.

Das Chat-Widget auf Ihrer Storefront

Wenn der Shop über die App oder über ein API-Konto mit Änderungsberechtigung für Content verbunden ist, fügt ChatLab das Widget für Sie hinzu. Sie finden es unter Storefront > Script Manager als ChatLab chatbot. Es wird im Footer aller Storefront-Seiten in der Zustimmungskategorie Functional (Funktional) platziert und entfernt, sobald Sie die Verbindung zum Shop trennen.

Wurde das API-Konto ohne Zugriff auf Content erstellt, erstellen Sie entweder ein neues API-Konto mit diesem Zugriff und verbinden Sie den Shop erneut, oder fügen Sie das Widget selbst hinzu:

  1. Öffnen Sie in ChatLab Ihren Chatbot, gehen Sie zu Test & Deploy (Testen & Bereitstellen), wählen Sie BigCommerce und kopieren Sie den Code.
  2. Gehen Sie in Ihrem BigCommerce-Control-Panel zu Storefront > Script Manager.
  3. Klicken Sie auf Create a Script (Skript erstellen) und geben Sie ihm einen Namen, zum Beispiel ChatLab.
  4. Setzen Sie Placement (Platzierung) auf Footer, Location (Ort) auf Storefront pages (Storefront-Seiten) und Script category (Skriptkategorie) auf Functional (Funktional).
  5. Wählen Sie als Script type (Skripttyp) Script und fügen Sie den Code in Script contents (Skriptinhalte) ein.
  6. Klicken Sie auf Save (Speichern) und aktualisieren Sie Ihre Storefront. Der Chatbot erscheint in der unteren Ecke jeder Seite.

Fehlerbehebung

  • "Failed to connect to the BigCommerce store. Check the store hash and the access token." - Das Token wurde unvollständig kopiert, das API-Konto wurde gelöscht oder der Store-Hash gehört zu einem anderen Shop. Kopieren Sie beide Werte erneut aus der Datei, die BigCommerce beim Erstellen des API-Kontos heruntergeladen hat.
  • Das Chat-Widget wurde nicht automatisch hinzugefügt - Das API-Konto hat keinen Änderungszugriff auf Content. Erstellen Sie ein neues API-Konto mit dieser Berechtigung und verbinden Sie den Shop erneut, oder fügen Sie das Widget wie oben beschrieben im Script Manager hinzu.
  • Der Chatbot erscheint nicht auf der Storefront - Prüfen Sie, ob das Skript unter Storefront > Script Manager aufgeführt ist. Wenn Ihr Shop ein Cookie-Einwilligungsbanner verwendet, lädt das Widget, sobald der Besucher die Kategorie Functional akzeptiert.
  • Der Chatbot findet keine Produkte - Überprüfen Sie den Indexierungsstatus unter Training > E-commerce catalog und stellen Sie sicher, dass die Produkte in Ihrem Shop sichtbar sind.
  • Die Bestellung wird nicht gefunden - Der Chatbot benötigt die beim Checkout verwendete E-Mail-Adresse zusammen mit der Bestellnummer aus der Bestätigungs-E-Mail.
  • "Add to cart" öffnet die Produktseite - Das Produkt verfügt über eine Pflichtoption, die nicht im Chat ausgewählt werden kann, wie etwa ein Textfeld, oder der Chatbot wird außerhalb Ihrer BigCommerce-Storefront ausgeführt.