Skip to main content
Der CSV-Produktfeed importiert Produkte aus einer CSV-Datei unter einer öffentlichen URL in Chatarmin CX. Nutze ihn, wenn deine Produkte nicht in einem Shopsystem liegen, das cx direkt anbindet, zum Beispiel ein ERP-Export, ein PIM-Feed oder eine Tabelle. Nach dem Import kann ein Agent der Klassischen KI den Katalog nutzen, um Fragen zu Produkten, Preisen und Verfügbarkeit zu beantworten.
Der Feed ist nur eine Produktquelle für die Klassische KI. KI-Agenten lesen keine Produkte aus CSV-Feeds. Wenn du auf KI-Agenten umsteigst, sieh dir Klassische KI ersetzen an.

​
Wann du es brauchst

Nutze einen CSV-Produktfeed, wenn:
  • dein Katalog in einem System ohne native cx-Integration liegt
  • du einen CSV-Export unter einer URL bereitstellen kannst, die cx herunterladen kann
  • ein Agent der Klassischen KI Produkte empfehlen und Preise, Größen, Farben oder Lagerbestand nennen soll
Wenn du über Shopify verkaufst, verbinde stattdessen Shopify.

​
Feed einrichten

Stell deine CSV unter einer URL bereit, die die Datei direkt und ohne Login herunterlädt. Teile die Datei bei Google Drive als Jeder mit dem Link kann ansehen. Bei Dropbox funktioniert ein normaler Freigabelink.
1

Integrationen öffnen

Öffne Integrationen in den Workspace-Einstellungen und wähle CSV Product Feed.
2

Feed hinzufügen

Klick auf Verbinden. Trag einen Integration Name (eine Bezeichnung für dein Team) und die CSV URL ein und klick im Dialog auf Connect. cx startet den ersten Import sofort.
3

Import prüfen

Klick unter deinen verbundenen Konten auf den Feed. Die Box Sync Status zeigt nach dem Import Synced mit der Anzahl der Produkte und Varianten, oder Failed mit der Fehlermeldung.
4

Feed mit einem Agenten der Klassischen KI verknüpfen

Öffne den Agenten der Klassischen KI, geh zu Quellen → AI Integrations und wähle CSV Product Feed. Klick unter Connected Feeds neben deinem Feed auf Connect. Der Feed zeigt dann das Badge Connected.
Du kannst einen Feed mit mehreren Agenten der Klassischen KI verknüpfen, und ein Agent kann mehrere Feeds nutzen. Um einen Feed zu lösen, klick unter Connected Feeds auf das Entfernen-Symbol daneben.

​
CSV vorbereiten

cx nutzt keine feste Vorlage. Beim Import liest cx die Kopfzeile und einige Beispielzeilen und ermittelt per KI, welche Spalte welches Produktdetail enthält. Spaltennamen auf Deutsch oder Englisch funktionieren, zum Beispiel Artikelnummer oder Preis. Jede Datei braucht mindestens:
  • eine Spalte mit der Produkt-ID. Fehlt sie, kann cx eine Spalte mit der Produkt-URL nutzen und den letzten Teil der URL als ID nehmen.
  • eine Spalte mit dem Produkttitel
Außerdem erkennt cx Beschreibung, Kurzbeschreibung, Produkt-URL, Bild-URL, Status, Tags, Hersteller, Produkttyp, Varianten-ID, Variantentitel, Preis, SKU, Lagermenge, Verfügbarkeit, Größe und Farbe. Weitere nützliche Spalten werden als zusätzliche Produktdetails gespeichert. Eine Datei mit diesen Spaltennamen wird zum Beispiel sauber zugeordnet:
So werden aus Zeilen Produkte:
  • Varianten: Zeilen mit derselben Produkt-ID werden zu einem Produkt, jede Zeile wird eine Variante (zum Beispiel eine Zeile pro Größe).
  • Preise: Schreib Preise wie 1234.56, 1234,56 oder 1.234,56. Währungssymbole sind erlaubt. Vermeide Kommas als Tausendertrennzeichen: 1,234.56 wird falsch gelesen. Die Währung kommt aus dem Symbol im Preis der ersten Zeile (€, $, £, ¥), Standard ist EUR.
  • Verfügbarkeit: Werte wie yes, true, 1, in stock oder available gelten als verfügbar. no, false, 0, out of stock oder unavailable gelten als nicht verfügbar.
  • Status: inactive, draft, hidden oder archived markieren ein Produkt als inaktiv. Inaktive Produkte werden aus dem Wissen des Agenten entfernt.
  • Zeilen ohne Produkt-ID werden übersprungen.
  • Komma, Semikolon, senkrechter Strich und Tab funktionieren als Trennzeichen.

​
So funktioniert die Synchronisierung

cx importiert den Feed:
  • beim ersten Verbinden
  • wenn du in der Box Sync Status des Feeds auf Re-sync Products klickst
  • wenn du den Feed mit einem Agenten der Klassischen KI verknüpfst und der letzte Import älter als 12 Stunden ist
Es gibt keinen automatischen Zeitplan. Wenn du die Datei unter der URL aktualisierst, klick auf Re-sync Products, damit cx die Änderungen übernimmt. Ein Re-sync erkennt die Spalten außerdem neu, umbenannte oder neue Spalten werden also berücksichtigt. Produkte werden über die Produkt-ID zugeordnet. Eine geänderte Zeile aktualisiert also das bestehende Produkt, statt ein Duplikat anzulegen.
Wenn du eine Zeile aus der CSV löschst, wird das Produkt in cx nicht entfernt. Damit ein Agent ein Produkt nicht mehr anbietet, behalte die Zeile und setz ihren Status auf inactive oder löse den Feed vom Agenten.

​
Feed entfernen

Öffne in den Integrationen CSV Product Feed, öffne am Feed das Menü Connected und wähle Disconnect. Bestätige mit Delete.

​
Fehlerbehebung

​
Der Status zeigt Failed

  • Öffne die CSV-URL in einem privaten Browserfenster. Siehst du eine Webseite oder einen Login statt eines Datei-Downloads, kann cx die Datei auch nicht lesen. Korrigiere die Freigabe und klick auf Re-sync Products.
  • Prüfe bei Google Drive, ob die Datei als Jeder mit dem Link kann ansehen geteilt ist.
  • Meldet der Fehler, dass keine Spalte für Produkt-ID oder Titel gefunden wurde, ergänze eindeutige Spaltennamen dafür und synchronisiere erneut.

​
Produkte fehlen oder Details stimmen nicht

  • Prüfe, ob die Zeile eine Produkt-ID hat. Zeilen ohne ID werden übersprungen.
  • Zeilen mit derselben Produkt-ID werden zu einem Produkt zusammengeführt. Gib Produkten eigene IDs, falls sie versehentlich zusammengeführt wurden.
  • Klick nach Änderungen an den Spaltennamen auf Re-sync Products, damit cx die Spalten neu erkennt.

​
Der Agent der Klassischen KI erwähnt die Produkte nicht

  • Prüfe, ob der Feed unter Quellen → AI Integrations → CSV Product Feed des Agenten als Connected angezeigt wird.
  • Prüfe, ob die Produkte in der CSV nicht als inaktiv markiert sind.