Shop verbinden
- Ö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. - 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.
- Ö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…). - Wähle Hinzufügen. Anmeldung und Leserechte werden geprüft, bevor die Verbindung gespeichert wird. Weise die Verbindung danach deinem Assistenten zu.
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.
- Einen Stornowunsch für dein Team an einer Bestellung hinterlegen.
- Einen Rückgabe- oder Umtauschwunsch für dein Team an einer Bestellung hinterlegen.
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.
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:- 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.
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, etwa0151 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.
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.