Zum Hauptinhalt springen
Lass deinen Assistenten Fragen zu Produkten und Bestellungen aus deinem Shopware-6-Shop beantworten. Ein Anrufer fragt: „Ist meine Bestellung 10023 schon unterwegs?“ Der Assistent liest Bestell-, Zahlungs- und Versandstatus, sobald er weiß, wer anruft. Außerdem liest er Produkte mit Preis und Lagerbestand. Er arbeitet mit Shopware 6.4 oder neuer und ändert nie Status, Zahlung oder Lieferung einer Bestellung. Das Einzige, was er schreibt, ist ein optionaler interner Kommentar für dein Team (standardmäßig aus).

Shop verbinden

  1. Öffne in Shopware Einstellungen → System → Integrationen und wähle Integration hinzufügen. Gib ihr einen Namen wie „Telefonassistent“ und kopiere die Access-Key-ID (sie beginnt mit SWIA) und den Secret-Access-Key. Shopware zeigt das Secret nur einmal.
  2. Gib der Integration eine Rolle mit Ansichtsrechten im Rollen-Editor von Shopware unter Bestellungen, Kataloge → Produkte, Kataloge → Kategorien und Einstellungen → Währungen. Ergänze Ansichtsrechte für die Systemkonfiguration, wenn der Assistent den Namen deines Shops kennen soll. Schreibrechte für Bestellung brauchst du nur für Notizen zu Wünschen.
  3. Öffne Agent Tools → Marketplace → Shopware 6. Gib Shop-Adresse, Access-Key-ID und Secret-Access-Key ein. Verwende einen Integrations-Key, kein Admin-Passwort und keinen Verkaufskanal-Key (SWSC…).
  4. Wähle Hinzufügen. Anmeldung und Leserechte werden geprüft, bevor die Verbindung gespeichert wird. Weise die Verbindung danach deinem Assistenten zu.
Die Shop-Adresse ist die öffentliche HTTPS-Adresse deines Shops, zum Beispiel https://shop.example.com. Fügst du die Admin-Adresse ein, entfernt der Assistent /admin.

Das kann der Assistent

Standardmäßig aktiv:
  • Aktive Produkte nach Namen suchen und Preis, Lagerbestand und Varianten lesen.
  • Deine Produktkategorien auflisten, um eine Suche einzugrenzen.
  • Den Status einer Bestellung lesen, auch Zahlungs- und Versandstatus, nachdem der Anrufer bestätigt wurde.
  • Letzte Bestellungen eines Anrufers über die E-Mail-Adresse oder die Telefonnummer des Anrufers finden.
Optional unter Bearbeiten:
  • Einen Stornowunsch für dein Team an einer Bestellung hinterlegen.
  • Einen Rückgabe- oder Umtauschwunsch für dein Team an einer Bestellung hinterlegen.
Der Assistent liest keine Sendungsnummern, Adressen oder Daten anderer Kunden vor.

Datenschutz bei Bestellungen

Der Assistent nennt Bestelldetails nur der Person, zu der die Bestellung gehört. Er braucht einen von zwei Nachweisen:
  • Die Telefonnummer. Die Nummer, von der der Anrufer anruft, stimmt mit der Telefonnummer der Bestellung (Rechnungs- oder Lieferadresse) überein. Zusätzlich braucht der Assistent die Bestellnummer.
  • Ein zweites Merkmal. Die Bestellnummer plus die E-Mail-Adresse der Bestellung oder die Lieferpostleitzahl.
Stimmt ein Merkmal nicht, lautet die Antwort immer gleich: Zu diesen Angaben gibt es keinen passenden Eintrag. Der Assistent sagt nie, ob eine Bestellung existiert. Nach drei falschen Versuchen in einem Gespräch prüft er nicht weiter. Die Bestellnummer allein reicht nie. Nutzen mehrere Kunden eine Telefonnummer, identifiziert die Nummer den Anrufer nicht. Der Assistent fragt dann nach Bestellnummer und E-Mail-Adresse oder Lieferpostleitzahl, auch wenn der Anrufer die Bestellnummer nennt. Unterdrückt der Anrufer die Nummer oder gibt es keine Telefonnummer (Web-Chat), fragt der Assistent nach dem zweiten Merkmal.

Bestell-, Zahlungs- und Versandstatus

Der Assistent nennt jeden Status in Worten: Dazu nennt er Bestelldatum, Produkte mit Mengen, Gesamtbetrag und Versandart. Bei der Sendungsverfolgung sagt er nur, ob eine Sendungsnummer existiert. Die Nummer liest er nicht vor.

Wünsche an dein Team

Stornowünsche sowie Rückgabe- und Umtauschwünsche sind standardmäßig aus. Schaltest du sie ein, wiederholt der Assistent Bestellnummer und Grund, wartet auf ein klares Ja und hängt einen Block an den internen Kommentar der Bestellung an:
Sonst ändert sich nichts: Der Bestellstatus bleibt, es gibt keine Erstattung und kein Retourenlabel. Der Assistent bittet Shopware, für diese Änderung keine Flows auszuführen, sodass der Kunde keine E-Mail dazu erhält. Dein Team liest den Kommentar in der Bestellung und entscheidet.
  • Ein Stornowunsch ist möglich, solange die Bestellung offen oder in Bearbeitung und nicht versendet ist.
  • Ein Rückgabe- oder Umtauschwunsch ist bei abgeschlossenen oder versendeten Bestellungen möglich.
  • Ein zweiter Wunsch derselben Art zur selben Bestellung erzeugt keine zweite Notiz.
Die Rolle der Integration braucht Schreibrechte für Bestellung. Der Assistent prüft beim Verbinden, ob das Feld für den internen Kommentar existiert. Hat dein Shop noch keine Bestellungen, kann die Prüfung das Feld nicht sehen. Verbinde dann nach der ersten Bestellung erneut. Die Notiz selbst steht auf Englisch, damit dein Team sie einheitlich liest. Als Name steht deine Marke.

Anrufer erkennen

Bei Telefonanrufen kann der Assistent den Anrufer mit Vornamen begrüßen und seine letzte Bestellung kennen, bevor der Anrufer etwas sagt. Shopware speichert Telefonnummern, wie sie eingegeben wurden. Deshalb sucht der Assistent die letzten sechs Ziffern der Nummer des Anrufers und vergleicht die Nummern danach exakt. Eine Nummer mit Leerzeichen mitten in diesen Ziffern, etwa 0151 123 45678, findet er so nicht. Der Anrufer kann trotzdem die Bestellnummer nennen, zusammen mit der E-Mail-Adresse oder der Lieferpostleitzahl.

Einstellungen

Zwei optionale Einstellungen stehen im Verbindungsformular:
  • Verkaufskanal-ID: begrenzt Produktantworten auf Produkte, die in diesem Verkaufskanal sichtbar sind. Leer lassen für alle aktiven Produkte.
  • Zeitzone des Shops: legt die Zeitzone für Bestelldaten fest. Leer bedeutet Europe/Berlin.
Um eine Einstellung, die Adresse oder die Keys später zu ändern, bearbeite die Verbindung unter Automationen → Verbindungen oder entferne das Tool und verbinde es erneut.

Sicher testen

Teste mit einem Testprodukt und deiner eigenen Telefonnummer. Ein Testanruf liest deinen echten Shop. Hast du Notizen zu Wünschen eingeschaltet, schreibt ein Test eine echte Notiz an eine echte Bestellung. Nimm deshalb eine Testbestellung und entferne die Notiz danach.

Kanäle

Bei Telefonanrufen kennt der Assistent die Nummer des Anrufers. In Kanälen ohne Telefonnummer, etwa im Web-Chat, fragt er immer nach der Bestellnummer plus E-Mail-Adresse oder Lieferpostleitzahl.

Automationen

Verbinde Shopware 6 unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Jedes Tool steht 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: Bestellstatus braucht dort deshalb die E-Mail-Adresse oder die Lieferpostleitzahl, und Letzte Bestellungen des Anrufers meldet, dass die Nummer nicht verfügbar ist.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/shopware6 · MCP connect_integration · CLI famulor connect-integration shopware6. 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

  • Die Adresse führt nicht zur Shopware-6-Admin-API: Der Shop ist älter als 6.4, oder die Adresse stimmt nicht. Nutze die öffentliche Adresse des Shops ohne /api.
  • Die Rolle der Integration erlaubt das nicht: Öffne die Integration in Shopware und ergänze die fehlenden Leserechte. Die Meldung nennt keine Entität; prüfe Produkt, Kategorie, Bestellung, Bestelladresse, Bestelllieferung, Bestelltransaktion und Währung.
  • Shopware hat Access-Key-ID oder Secret abgelehnt: Lege eine neue Integration an und gib deren Schlüsselpaar ein. Ein Verkaufskanal-Key funktioniert nicht.
  • Zu viele Anmeldungen: Shopware begrenzt Anmeldungen je Integration. Warte ein paar Minuten. Der Assistent nutzt seine Anmeldung etwa neun Minuten lang weiter.
  • Der Shop antwortet mit einer Webseite: Eine Firewall oder ein Sicherheits-Plugin blockiert API-Anfragen. Erlaube Anfragen an /api/ für die Integration.
Shopware-Admin-API-Dokumentation