Wie wird die Shopware-Integration umgesetzt?
Für die Integration sind Anpassungen in Shopware sowie im moinAI Hub notwendig. Stelle sicher, dass für beide Anwendungen Zugänge mit Administratoren-Rechten verwendet werden (zu den Nutzer-Rollen im moinAI Hub).Schritt-für-Schritt-Anleitung zur Shopware-Integration
Es gibt zwei Möglichkeiten, die Shopware-Integration umzusetzen. Die empfohlene Vorgehensweise ist im Folgenden im Detail erklärt.
Shopware vorbereiten
1. Erstellen einer Rolle-
-
- Anmeldung im Shopware Admin-Dashboard an.
- Aufrufen des Bereichs Benutzer & Berechtigung (Einstellungen → System → Benutzer & Berechtigungen).
- Erstellen einer neuen Rolle (Rolle erstellen) und Vergabe eines passenden Namens, z. B. „moinAI Role“.
- Aktivieren der notwendigen Berechtigungen:
-
-
-
-
- Kunden → Kunden anzeigen
- Bestellungen → Bestellungen anzeigen
- Speichern der neu angelegten Rolle
-
-
2. Integration anlegen
-
- Aufrufen des Bereichs Integrationen (Einstellungen → System → Integrationen).
- Hinzufügen einer neuen Integration (Integration hinzufügen) und Vergabe eines passenden Namens, z. B. „moinAI Integration“.
- Zuweisung der zuvor erstellten Rolle „moinAI Role“ zu.
- Speichern der Integration. Access Key und Secret Key müssen notiert oder an einem sicheren Ort gespeichert werden, da diese nach dem Speichern der Integration nicht mehr angezeigt werden.
moinAI Hub konfigurieren
- Nach der Anmeldung im moinAI Hub erfolgt das Aufrufen der Shopware-Integration über Integrationen → Shopware
- Integration Credentials: Dort erfolgt die Eingabe des Access Keys und des Secret Keys, die zuvor in der Shopware-Integration erstellt wurden.
- Nach der Eingabe der Keys sollte ein Testaufruf durchgeführt werden, um sicherzustellen, dass die Verbindung erfolgreich hergestellt wurde.
- Anschließend muss die Konfiguration noch gespeichert werden.
Kontextvariablen einrichten
Damit moinAI Bestell- und Kundeninformationen aus Shopware abrufen kann, müssen Sie zwei Variablen in einem moinAI-Formular definiert werden:
- shopware_order_number: Die Bestellnummer.
- shopware_email: Die E-Mail-Adresse des Kunden (case-insensitive).
Integration testen
- Nachdem die Kontextvariablen im Formular eingefügt wurden, kann die Integration mit entsprechenden Testdaten getestet werden. Hierfür muss das Formular mit einem passenden Thema verknüpft und dann getestet werden.
- Erfolgt die Übermittlung aller relevanten Daten, ist die Integration erfolgreich umgesetzt und kann im Live-Betrieb verwendet werden.
Mögliche Fehler und deren Behebung
- Fehler: „not_configured“
Die Integration ist unvollständig. Stellen Sie sicher, dass alle Schritte korrekt durchgeführt wurden.
- Fehler: „missing_data“
Die erforderlichen Variablen shopware_order_number oder shopware_email fehlen. Überprüfen Sie Ihre Formular-Konfiguration.
- Fehler: „token_refresh_error“
Das Token konnte nicht aktualisiert werden. Stellen Sie sicher, dass die Integration in Shopware noch aktiv ist.
Alternative: Integration via User Credentials
Unabhängig der beschriebenen Umsetzung, ist auch eine Integration mit den User Credentials des Shopware-Zugangs möglich:
Die Eingabe der Zugangsdaten erfolgt direkt im moinAI Hub im Bereich Integrationen → Shopware. Nach der Eingabe kann die Shopware-Umsetzung finalisiert werden.
Das Aktualisieren der User-Credentials ist im moinAI Hub zu jedem Zeitpunkt möglich. Die Anpassungen erfolgen im selben Bereich (Integrationen →Shopware).