Epinium Docs

Deutsch

Español
English
Français
Italiano

Deutsch

Español
English
Français
Italiano

Appearance

WooCommerce-Integration ​

Zugriff über: Einstellungen → Verbindungen

Sobald du deinen WooCommerce-Shop verbindest, kann dein KI-Assistent den Katalog des Shops über den MCP von Epinium abfragen. Die Verbindung erlaubt Lesen und Schreiben: Neben dem Abfragen kann dein Assistent Produkte und Katalog-Inhalte anlegen, bearbeiten und löschen, sofern du ihm diese Berechtigung gibst (siehe Was dein Assistent schreiben kann).

Du musst keine App erstellen. Der Shop erzeugt selbst einen Zugriffsschlüssel mit Lese- und Schreibrechten, und du genehmigst in deinem WordPress-Dashboard, dass Epinium ihn verwendet. Der Ablauf hat zwei Schritte und dauert nur ein paar Minuten.

Die WordPress-Menüs in deiner Sprache

Diese Anleitung nennt die Menüs von WordPress und WooCommerce so, wie sie auf Deutsch erscheinen. Dein Dashboard zeigt sie in der Sprache deines WordPress an, und einzelne Bezeichnungen können je nach Version leicht abweichen.

Bevor du beginnst ​

  • Dein Shop muss eine sichere Verbindung verwenden. Seine Adresse muss mit https:// beginnen und sich im Browser ohne Sicherheitswarnung öffnen.
  • Die WordPress-Permalinks dürfen nicht auf "Einfach" stehen. Du änderst sie in deinem WordPress-Dashboard unter Einstellungen → Permalinks: Jede andere Option funktioniert.
  • Die REST-API deines Shops muss erreichbar sein. Über sie teilt WooCommerce Daten mit anderen Anwendungen, und manche Sicherheits-Plugins blockieren sie.
  • Du musst dich als Administrator des Shops bei WordPress anmelden. Wenn eine andere Person den Shop verwaltet, halte sie bereit: Sie muss sich anmelden und den Zugriff genehmigen.

Schritt 1: Prüfe deinen Shop ​

  1. Gehe zu Einstellungen → Verbindungen und klicke auf Verbindung hinzufügen.
  2. Wähle WooCommerce.
  3. Gib unter Adresse deines Shops die Adresse ein, über die deine Kunden deinen Shop aufrufen, zum Beispiel meinshop.de. Du kannst sie mit oder ohne https:// eingeben.
  4. Klicke auf "Shop prüfen".

Epinium prüft, ob unter dieser Adresse ein WooCommerce-Shop liegt, der die Voraussetzungen erfüllt. Fehlt etwas, sagt Epinium es dir sofort, bevor sich irgendetwas in deinem Shop öffnet (die Meldungen und was du jeweils tun kannst, findest du unter Häufige Probleme).

Wenn alles passt, siehst du die Meldung "Wir haben deinen Shop gefunden" mit der Adresse, die verbunden wird. Sie kann leicht von deiner Eingabe abweichen: Wenn dein Shop www. verwendet oder in einem Unterordner installiert ist (meinshop.de/shop), verwendet Epinium die Adresse, die der Shop selbst angibt.

Schritt 2: Genehmige den Zugriff in deinem Shop ​

  1. Klicke auf "In meinem Shop genehmigen". Es öffnet sich ein Fenster deines Shops.
  2. Melde dich als Administrator bei WordPress an, falls du es noch nicht bist.
  3. WooCommerce zeigt dir, dass Epinium - Name deines Kontos sich mit Lese- und Schreibzugriff mit deinem Shop verbinden möchte. Klicke auf "Genehmigen".
  4. Das Fenster schließt sich, und Epinium bestätigt dir, dass der Shop verbunden ist. Klicke auf "Beenden".

Auf diesem Bildschirm listet WooCommerce alles auf, was ein Schlüssel mit Lese- und Schreibrechten allgemein erlaubt einzusehen und zu ändern: Gutscheine, Kunden, Bestellungen und Verkaufsberichte sowie Produkte. Das ist der Standardtext von WooCommerce für jede Anwendung, die diese Berechtigung anfragt. Epinium lässt deinen Assistenten nur das berühren, was unter Was dein Assistent lesen kann und was nicht und unter Was dein Assistent schreiben kann beschrieben ist.

Wenn zwischen Schritt 1 und Schritt 2 einige Minuten vergehen, bittet Epinium dich, den Shop erneut zu prüfen, bevor es weitergeht.

Warum der Name deines Kontos erscheint

WooCommerce zeigt den Namen dessen an, der den Zugriff anfragt. Epinium fügt den Namen deines Kontos hinzu, damit die genehmigende Person genau weiß, wer anfragt. WooCommerce speichert ihn außerdem in der Beschreibung des Schlüssels, sodass du ihn später in deinem Shop als Epinium - Name deines Kontos - API (Datum) wiedererkennst. Wenn du eine Agentur bist und den Shop eines Kunden verbindest, erscheint der Name dieses Kunden in Epinium. Wenn die genehmigende Person den Namen nicht kennt, sollte sie nicht genehmigen.

Alternative: Mit einem Schlüssel verbinden ​

Wenn sich das Fenster deines Shops nicht öffnet oder WordPress nach der Genehmigung eine Fehlerseite zeigt und das Fenster nicht zu Epinium zurückkehrt, kannst du dich verbinden, indem du den Schlüssel selbst im Shop erstellst und in Epinium einfügst.

In deinem Shop: Erstelle den Schlüssel ​

  1. Gehe in deinem WordPress-Dashboard zu WooCommerce → Einstellungen → Erweitert → REST-API und klicke auf "Schlüssel hinzufügen".
  2. Gib ihm eine Beschreibung, an der du ihn später wiedererkennst, zum Beispiel "Epinium".
  3. Wähle einen Administrator als Benutzer.
  4. Wähle die Berechtigung "Lesen/Schreiben": So erlaubt der Schlüssel Abfragen und auch Änderungen am Katalog. Mit "Lesen" funktioniert die Verbindung, aber dein Assistent kann nur abfragen.
  5. Klicke auf "API-Schlüssel generieren". WooCommerce zeigt dir den Consumer Key (beginnt mit ck_) und das Consumer Secret (beginnt mit cs_). Kopiere beide jetzt: WooCommerce zeigt sie nur auf diesem Bildschirm an.

In Epinium: Füge den Schlüssel ein ​

  1. Gib auf dem WooCommerce-Bildschirm von Epinium die Adresse deines Shops ein, wie in Schritt 1.
  2. Öffne den Bereich "Das Fenster öffnet sich nicht oder zeigt einen Fehler? Mit einem Schlüssel verbinden".
  3. Füge den Schlüssel in Consumer Key und das Secret in Consumer Secret ein.
  4. Klicke auf "Mit dem Schlüssel verbinden".

Epinium testet den Schlüssel mit deinem Shop, bevor es ihn speichert. Funktioniert er nicht, wird die Verbindung nicht angelegt, und der Bildschirm sagt dir, warum.

Wenn du von einem Genehmigungsversuch kommst, der nicht abgeschlossen wurde, bietet dir Epinium die Schaltfläche "Mit einem Schlüssel verbinden" an, die dich direkt zu diesem Formular bringt.

Was dein Assistent lesen kann und was nicht ​

Dein Assistent kann abfragen:

  • Den Katalog: Produkte und ihre Varianten, Kategorien, Schlagwörter, Marken und Attribute.
  • Die Verkaufsberichte, die meistverkauften Produkte und die Gesamtzahlen des Shops (wie viele Bestellungen, Produkte, Kunden, Gutscheine oder Bewertungen es gibt, ohne einzelne davon zu sehen).
  • Referenzdaten: Länder, Kontinente und Währungen.

Dein Assistent kann nicht abfragen:

  • Bestellungen, Kunden, Gutscheine und Bewertungen, weil sie Namen, E-Mail-Adressen oder Anschriften von Personen enthalten.
  • Die Konfiguration des Shops: Einstellungen, Steuern, Versand oder Zahlungsarten.
  • Die Felder, die Plugins zu Produkten hinzufügen. Manche Plugins speichern dort personenbezogene Daten, deshalb gibt Epinium sie nie heraus, auch wenn der Schlüssel das Lesen technisch erlauben würde.

Was dein Assistent schreiben kann ​

Damit dein Assistent etwas in deinem Shop ändern kann, muss der API-Schlüssel oder die MCP-Autorisierung die Berechtigung Daten deiner verbundenen Shops und Plattformen → Bearbeiten tragen (du wählst sie unter Einstellungen → API Keys oder beim Autorisieren des Assistenten; Bearbeitungsrechte zu vergeben ist ab dem Business-Tarif enthalten). Ohne sie fragt dein Assistent nur ab. Ein Schlüssel oder eine Autorisierung, die du schon hattest, bekommt sie nicht: Lege einen neuen an oder autorisiere erneut.

Mit dieser Berechtigung kann dein Assistent dasselbe ändern, was er abfragen kann, und nichts weiter. Er kann anlegen, bearbeiten und löschen:

  • Produkte und ihre Variationen.
  • Kategorien, Schlagwörter, Marken und Attribute sowie die Begriffe jedes Attributs.

Dein Assistent kann nicht Bestellungen, Kunden, Gutscheine, Bewertungen oder die Konfiguration des Shops anfassen und auch nicht in die Felder schreiben, die Plugins den Produkten hinzufügen. Berichte und Referenzdaten (Länder, Kontinente und Währungen) lassen sich nur abfragen.

Zwei Dinge, die du wissen solltest, bevor du die Berechtigung gibst:

  • Änderungen werden direkt in deinem Shop übernommen, ohne vorherige Prüfung. Sie laufen nicht über Prozesse → Aufgaben.
  • Manche Löschungen lassen sich nicht rückgängig machen. Ein gelöschtes Produkt landet im Papierkorb von WooCommerce, aus dem du es wiederherstellen kannst, es sei denn, der Assistent verlangt die endgültige Löschung. Kategorien, Schlagwörter, Marken, Attribute und Begriffe haben keinen Papierkorb: Sie werden für immer gelöscht.

Was aufgezeichnet wird ​

Jede Änderung, die dein Assistent an deinen Shop sendet, wird 12 Monate lang aufgezeichnet: was er verlangt hat, wann, das Ergebnis (übernommen, vom Shop abgelehnt oder Ergebnis unbekannt), die Antwort des Shops und welcher Assistent sie durchgeführt hat. Um sie einzusehen, bitte deinen Assistenten darum ("zeig mir die letzten Änderungen in meinem Shop") oder nutze GET /v1/platform-changes in der API. Der vorherige Wert wird nicht gespeichert: Wenn du wissen musst, wie ein Produkt vor der Änderung aussah, muss dein Assistent es vor dem Ändern lesen. Wird ein Produkt gelöscht, enthält die aufgezeichnete Antwort das gelöschte Produkt. Das Abrufen dieses Protokolls kostet 1 Credit pro zurückgegebener Zeile, genau wie das Protokoll der Werbeänderungen.

Eine Änderung kostet so viel wie eine Abfrage: 5 Credits plus 1 pro KB Antwort, auch wenn der Shop sie wegen ungültiger Daten ablehnt. Eine, die Epinium vor dem Senden blockiert, kostet nichts.

Deine Daten und das KI-Modell

Epinium speichert die Daten deines WooCommerce-Shops nicht dauerhaft und sendet sie an kein eigenes KI-Modell. Dein Assistent fragt den Shop in dem Moment ab, in dem er es braucht, und du wählst und bezahlst selbst das KI-Modell, das du bevorzugst, und verbindest es eigenständig.

Deinen Shop aus Workflows nutzen ​

Neben deinem Assistenten kann auch ein Workflow deinen Shop mit dem Knoten Shop-Anfrage lesen und ändern: zum Beispiel, um dort die Produkte anzulegen, die du auf Amazon verkaufst. Er kann dasselbe ändern wie dein Assistent, die Änderungen gelten direkt und landen im selben Protokoll, mit dem Workflow als Ursprung. Aus einem Workflow zu schreiben ist ab dem Business-Plan enthalten.

Wenn dein Shop einen alten schreibgeschützten Schlüssel hat ​

Shops, die verbunden wurden, bevor Epinium schreiben konnte, haben einen schreibgeschützten Schlüssel. Sie funktionieren weiter zum Abfragen, aber wenn dein Assistent versucht, etwas zu ändern, erhält er eine Meldung, die erklärt, dass der Schlüssel kein Schreiben erlaubt. So behebst du das:

  1. Klicke unter Einstellungen → Verbindungen auf Verbindung hinzufügen, wähle WooCommerce und gib dieselbe Adresse wie die deines Shops ein.
  2. Wiederhole die Einrichtung: Schritt 1 und Schritt 2 oder die Alternative mit einem Schlüssel (mit der Berechtigung "Lesen/Schreiben").
  3. Epinium aktualisiert dieselbe Verbindung mit dem neuen Schlüssel. Der alte Schlüssel bleibt in deinem Shop aktiv: Widerrufe ihn, wie unten beschrieben.

Verbindung trennen und Zugriff widerrufen ​

  1. Suche unter Einstellungen → Verbindungen deinen Shop in der Liste und wähle in seinen Aktionen "Löschen".
  2. Bestätige. Epinium löscht sofort die Verbindung und die Schlüssel, die es gespeichert hatte.
  3. Damit der Schlüssel auch in deinem Shop verschwindet, gehe in deinem WordPress-Dashboard zu WooCommerce → Einstellungen → Erweitert → REST-API, suche den Schlüssel Epinium - Name deines Kontos - API (Datum) (oder die Beschreibung, die du ihm gegeben hast, wenn du ihn selbst erstellt hast) und widerrufe ihn.

Epinium kann den Schlüssel nicht für dich widerrufen: WooCommerce erlaubt das nur im Dashboard des Shops. Bis du ihn widerrufst, existiert der Schlüssel weiter in deinem Shop, auch wenn Epinium ihn nicht mehr verwendet.

Wenn du denselben Shop erneut verbindest

Wenn du einen Shop erneut verbindest, der bereits verbunden war, verwendet Epinium einen neuen Schlüssel, und der vorherige bleibt in deinem Shop aktiv. Den alten kannst du auf dieselbe Weise widerrufen.

Häufige Probleme ​

Ursache: Dein WordPress verwendet für die Permalinks die Option "Einfach", und damit kann WooCommerce die Genehmigung nicht abschließen.

Lösung: Gehe in deinem WordPress-Dashboard zu Einstellungen → Permalinks, wähle eine beliebige andere Option, speichere die Änderungen und klicke erneut auf "Shop prüfen". Diese Einstellung ändert das Format der Adressen deiner Seiten: Wenn eine andere Person deine Website betreut, sprich es vorher mit ihr ab.

"Dein Shop muss eine sichere Verbindung (https) verwenden" ​

Ursache: Dein Shop öffnet sich mit http:// statt mit https://, oder die Adresse, die der Shop selbst angibt, ist nicht sicher.

Lösung: Aktiviere die sichere Verbindung (das SSL-Zertifikat) im Panel deines Hosting-Anbieters oder bitte deinen Anbieter, sie zu aktivieren. Sobald sich dein Shop mit https:// öffnet, prüfe ihn erneut.

"Wir konnten deinen Shop nicht erreichen" ​

Ursache: Die Adresse ist falsch geschrieben, die Website funktioniert nicht oder antwortet nicht rechtzeitig, oder ihr Sicherheitszertifikat ist ungültig.

Lösung: Öffne die Adresse in deinem Browser und prüfe, ob dein Shop ohne Sicherheitswarnung lädt. Korrigiere sie bei Bedarf und versuche es erneut.

"Unter dieser Adresse haben wir kein WooCommerce gefunden" ​

Ursache: WooCommerce ist auf dieser Website nicht aktiv, oder ein Sicherheits-Plugin (oder die Firewall deines Hostings) blockiert die REST-API des Shops.

Lösung: Prüfe unter Plugins, ob WooCommerce aktiv ist. Wenn ja, überprüfe die Einstellungen deiner Sicherheits-Plugins und erlaube den Zugriff auf die REST-API, oder frag bei deinem Hosting-Anbieter nach.

Mein Browser blockiert das Fenster des Shops ​

Ursache: Dein Browser erlaubt Epinium nicht, Pop-up-Fenster zu öffnen.

Lösung: Erlaube Pop-ups für Epinium in deinem Browser und klicke erneut auf "In meinem Shop genehmigen".

WordPress zeigt nach der Genehmigung einen Fehler, und das Fenster kehrt nicht zu Epinium zurück ​

Ursache: Der Shop konnte den Schlüssel nicht vollständig an Epinium übergeben. Meist liegt das an einem Sicherheits-Plugin, das die REST-API blockiert, oder an einem Hosting, das die sichere Verbindung nicht richtig erkennt. In diesem Fall löscht WooCommerce den Schlüssel und zeigt seine eigene Fehlerseite, statt zu Epinium zurückzukehren, sodass in deinem Shop kein halb angelegter Schlüssel übrig bleibt.

Lösung: Schließe das Fenster des Shops und klicke in Epinium auf "Stornieren". Du siehst dann die Schaltfläche "Mit einem Schlüssel verbinden": Nutze sie und folge der Alternative mit einem Schlüssel.

"Dein Shop hat den Schlüssel abgelehnt", obwohl der Schlüssel richtig ist ​

Häufigste Ursache: Der Schlüssel wurde nicht vollständig kopiert, er gehört zu einem Benutzer, der kein Administrator ist, oder er hat keine Lese- und Schreibberechtigung.

Weitere Ursache: Dein Shop liegt hinter einem CDN oder einem Proxy (zum Beispiel einem Dienst wie Cloudflare), der die sichere Verbindung empfängt, sie aber nicht an WordPress weitergibt. WordPress hält die Verbindung dann für unsicher und lehnt den Schlüssel ab, obwohl die Adresse deines Shops mit https:// beginnt.

Lösung: Prüfe zuerst den Schlüssel, den Benutzer und die Berechtigung "Lesen/Schreiben". Wenn alles stimmt und du ein CDN oder einen Proxy nutzt, bitte die Person, die dein Hosting betreut, dafür zu sorgen, dass WordPress die sichere Verbindung erkennt, die über diesen Dienst ankommt, und versuche es erneut.

Mein Assistent sagt, der Schlüssel des Shops erlaubt kein Schreiben ​

Ursache: Der Shop ist mit einem schreibgeschützten Schlüssel verbunden, oder der Shop hat den Schlüssel beim Schreiben abgelehnt.

Lösung: Verbinde den Shop neu, damit Epinium einen Schlüssel mit Lese- und Schreibrechten verwendet, wie unter Wenn dein Shop einen alten schreibgeschützten Schlüssel hat erklärt. Bis dahin funktioniert das Lesen weiter, und ein erneuter Versuch bringt nichts.

Ich habe den Zugriff in meinem Shop abgebrochen ​

Ursache: Auf dem WooCommerce-Bildschirm wurde der Zugriff abgelehnt statt genehmigt. Epinium zeigt das mit der Meldung "Du hast den Zugriff in deinem Shop abgebrochen" an.

Lösung: Falls das ein Versehen war, klicke erneut auf "Shop prüfen" und "In meinem Shop genehmigen" und diesmal auf "Genehmigen".

Die Verbindung erscheint als "Ohne Verbindung" mit der Schaltfläche "Erneuern" ​

Ursache: Dein Shop akzeptiert den Schlüssel von Epinium nicht mehr. Das passiert, wenn jemand ihn unter WooCommerce → Einstellungen → Erweitert → REST-API widerruft oder wenn der WordPress-Benutzer, zu dem er gehört, seine Administratorrolle verliert oder gelöscht wird.

Lösung: Klicke unter Einstellungen → Verbindungen bei diesem Shop auf "Erneuern" und wiederhole die Einrichtung: Schritt 1 und Schritt 2 oder die Alternative mit einem Schlüssel. Erneuern aktualisiert dieselbe Verbindung: Sie zählt nicht als neuer Shop in deinem Tarif.

"Dein Tarif lässt keine weiteren Verbindungen zu" ​

Ursache: Jeder WooCommerce-Shop zählt als eine Verbindung deines Tarifs, und du hast bereits alle genutzt, die er enthält.

Lösung: Wechsle über den Hinweis auf dem Bildschirm zu einem höheren Tarif und versuche es erneut. Das Erneuern eines bereits verbundenen Shops wird durch dieses Limit nicht blockiert.

Brauchst du weitere Hilfe?

Wenn das Problem nach diesen Schritten weiterhin besteht, wende dich über den Chat der Plattform oder unter support@epinium.com an das Epinium-Supportteam.

Epinium Documentation