Zum Hauptinhalt springen
Dein Assistent liest Preise, Lagerbestände und Bestellstatus aus deinem Shopware-5-Shop. Er ändert nie etwas im Shop.
Shopware 5 erhält keine Sicherheitsupdates mehr: Der Sicherheitssupport endete am 31. Juli 2024, die letzte Version war 5.7.20. Plane deinen Umstieg auf Shopware 6. Diese Verbindung ist für Shops gedacht, die in der Zwischenzeit noch Shopware 5 betreiben.

Shop verbinden

  1. 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.
  2. Öffne im Shopware-Backend Einstellungen → Benutzerverwaltung, bearbeite einen Backend-Benutzer und öffne API-Zugang. Aktiviere den API-Zugang und kopiere den API-Schlüssel.
  3. Gib diesem Benutzer über seine Rolle nur Leserechte für Artikel und Bestellungen. Der Assistent kann alles lesen, was dieser Benutzer lesen darf.
  4. Ö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, um Europe/Berlin zu verwenden.
  5. Wähle Hinzufügen. Die Verbindung wird geprüft, bevor sie gespeichert wird. Weise sie danach deinem Assistenten zu.
Um Adresse oder Zugangsdaten später zu ändern, entferne das Tool und verbinde es erneut.

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.
Die Statusnamen stammen aus den Bestell- und Zahlungsstatus deines Shops. Einen Status, den du selbst angelegt hast, nennt der Assistent so, wie du ihn benannt hast.

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 /api fü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 /api für die Verbindung.