> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopware 6

> Lass deinen Assistenten Fragen zu Produkten und Bestellungen aus deinem Shopware-6-Shop beantworten.

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](#wünsche-an-dein-team).
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:

| Teil | Das hört der Anrufer |
| - | - |
| Bestellung | eingegangen, in Bearbeitung, abgeschlossen, storniert |
| Zahlung | noch nicht bezahlt, Zahlung läuft, bezahlt, teilweise bezahlt, Zahlung autorisiert, Zahlung fehlgeschlagen, Zahlungserinnerung gesendet, erstattet, teilweise erstattet, Zahlung storniert, Zahlung noch nicht bestätigt |
| Versand | noch nicht versendet, versendet, teilweise versendet, retourniert, teilweise retourniert, Versand storniert |

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:

```text theme={null}
CANCELLATION REQUEST (Deine Marke)
Reason: Ordered twice by mistake
Identity check: caller phone number matched the order
Callback number: +49 151 2345678
Ref: 3fa91c07
```

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.

```bash theme={null}
famulor connect-integration shopware6 --fields "{\"shop_url\":\"https://shop.example.com\",\"access_key_id\":\"SWIA...\",\"secret_access_key\":\"$SHOPWARE_SECRET\"}"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectIntegration({
  path: { provider: 'shopware6' },
  body: {
    fields: {
      shop_url: 'https://shop.example.com',
      access_key_id: 'SWIA...',
      secret_access_key: process.env.SHOPWARE_SECRET,
    },
  },
});
console.log(tool.id);
```

## 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](https://developer.shopware.com/docs/concepts/api/admin-api.html)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.