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 ist schreibgeschützt: Dein Assistent liest, aber Epinium ändert nichts in deinem Shop.

Du musst keine App erstellen. Der Shop erzeugt selbst einen schreibgeschützten Zugriffsschlüssel, 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 Lesezugriff 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 Leseschlüssel allgemein erlaubt: Gutscheine, Kunden, Bestellungen und Verkaufsberichte sowie Produkte. Das ist der Standardtext von WooCommerce für jede Anwendung, die Lesezugriff anfragt. Epinium lässt deinen Assistenten nur das abfragen, was unter Was dein Assistent lesen kann und was nicht 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": So erlaubt der Schlüssel 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.

Epinium schreibt nichts in deinen Shop: Der Schlüssel ist schreibgeschützt, also verhindert der Shop selbst jede Änderung.

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.

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 Leseberechtigung.

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". 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.

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