Shop verbinden
- Prüfe die Version. Die Verbindung braucht Shopware 5.3.2 oder neuer und wird mit 5.7 getestet. Dein Shop muss über HTTPS aus dem Internet erreichbar sein.
- Öffne im Shopware-Backend Einstellungen → Benutzerverwaltung, bearbeite einen Backend-Benutzer und öffne API-Zugang. Aktiviere den API-Zugang und kopiere den API-Schlüssel.
- Gib diesem Benutzer über seine Rolle nur Leserechte für Artikel und Bestellungen. Der Assistent kann alles lesen, was dieser Benutzer lesen darf.
- Öffne in Famulor Agent Tools → Marketplace → Shopware 5. Gib die Shop-Adresse ein, zum Beispiel
https://shop.example.com(ergänze den Unterordner, falls der Shop in einem läuft), dazu den API-Benutzernamen und den API-Schlüssel. Lass Zeitzone des Shops leer, umEurope/Berlinzu verwenden. - Wähle Hinzufügen. Die Verbindung wird geprüft, bevor sie gespeichert wird. Weise sie danach deinem Assistenten zu.
Das kann der Assistent
Beide Tools sind standardmäßig aktiv. Schalte sie unter Bearbeiten aus.- Produkte suchen: findet Produkte nach Name oder Artikelnummer und nennt dem Anrufer den Preis inklusive Mehrwertsteuer für Standardkunden, den Lagerbestand und ob es Varianten gibt. Hat ein Produkt keinen hinterlegten Steuersatz, nennt der Assistent keinen Preis.
- Bestellstatus: nennt für eine Bestellung den Status, den Zahlungsstatus, den Inhalt, die Summe, die Versandart und ob eine Sendungsnummer existiert.
Datenschutz bei Bestellungen
Der Anrufer nennt die Bestellnummer. Der Assistent fragt nach der E-Mail-Adresse der Bestellung oder der Lieferpostleitzahl und zeigt die Bestellung nur, wenn sie passt. Die Bestellnummer allein reicht nie. Eine falsche Angabe und eine unbekannte Bestellnummer bekommen dieselbe Antwort, sodass niemand erfährt, ob es eine Bestellung gibt. Nach drei falschen Versuchen für dieselbe Bestellnummer prüft der Assistent diese Bestellung nicht mehr weiter. Der Assistent liest nie Adressen, E-Mail-Adressen, Telefonnummern, Kommentare oder Sendungsnummern vor.Das macht er nicht
- Er ändert nichts: keine Bestellungen, Status, Notizen oder Kunden. Für den API-Benutzer genügen Leserechte.
- Er erkennt Anrufer nicht schon vor dem Gespräch.
- Er sucht eine Bestellung nicht allein anhand der Telefonnummer.
- Er liest keine Sendungsnummern vor. Er sagt nur, ob es eine gibt.
- Er unterstützt keine Digest-Authentifizierung.
Sicher testen
Die Verbindung liest nur, ein Test kann deinen Shop also nicht verändern. Teste mit einer eigenen Bestellung: Nenne die Bestellnummer und die E-Mail-Adresse der Bestellung. Prüfe, dass eine falsche Postleitzahl dieselbe Antwort bekommt wie eine unbekannte Bestellnummer.Kanäle
Auf jedem Kanal fragt der Assistent nach der E-Mail-Adresse oder der Lieferpostleitzahl.Automationen
Verbinde Shopware 5 unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Beide Tools stehen als Aktion bereit. Eine Automation, die ein Anruf oder eine Textunterhaltung (SMS, WhatsApp) startet, kennt die Nummer der Gegenseite aus diesem Anruf selbst. Andere Läufe (Webhook, Zeitplan) haben keinen Anrufer, deshalb braucht Bestellstatus dort immer die E-Mail-Adresse oder die Lieferpostleitzahl.API, MCP, CLI & SDK
POST /api/v1/tools/integrations/shopware5 · MCP connect_integration · CLI famulor connect-integration shopware5.
client.api.connectIntegration braucht famulor-sdk 0.2.12 oder neuer. Aktualisiere die CLI mit npm install --global famulor, bevor du connect-integration verwendest.
Fehlersuche
- „Das sieht nach einem Shopware-6-Shop aus“: Du hast die Adresse eines Shopware-6-Shops eingegeben. Nutze stattdessen die Shopware-6-Verbindung.
- „Shopware hat den API-Benutzer oder den Schlüssel abgelehnt“: Prüfe den Benutzernamen und kopiere den API-Schlüssel erneut. Achte darauf, dass der API-Zugang für diesen Benutzer aktiv ist.
- „Der API-Benutzer braucht Leserechte für Artikel und Bestellungen“: Öffne die Rolle des API-Benutzers und erlaube das Lesen von Artikeln und Bestellungen.
- „Diese Adresse führt nicht zur Shopware-5-API“: Prüfe die Adresse. Läuft der Shop in einem Unterordner, nimm ihn mit auf. Ergänze kein
/api. - „Der Shop hat mit einer Webseite statt mit Daten geantwortet“: Eine Firewall, ein Sicherheits-Plugin oder eine Wartungsseite blockiert die Anfrage. Erlaube Anfragen an
/apifür die Verbindung. - „Diese Adresse leitet auf eine andere Adresse weiter“: Der Shop leitet Besucher um, zum Beispiel von der Adresse ohne www auf die mit www. Gib die Adresse ein, die der Shop wirklich nutzt.
- „Der Shop hat die API-Anfrage abgelehnt“: Eine Firewall oder ein Sicherheitsmodul (zum Beispiel mod_security) blockiert
/api. Erlaube Anfragen an/apifür die Verbindung.