> ## 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 5

> Lass deinen Assistenten Fragen zu Produkten und zum Bestellstatus aus deinem Shopware-5-Shop beantworten.

Dein Assistent liest Preise, Lagerbestände und Bestellstatus aus deinem Shopware-5-Shop. Er ändert nie etwas im Shop.

> [!WARNING]
>
> 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](https://docs.famulor.io/de/automations/shopware6.md). 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.

```bash theme={null}
famulor connect-integration shopware5 --fields '{"shop_url":"https://shop.example.com","api_user":"api-assistant","api_key":"'"$SW5_KEY"'"}'
```

```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: 'shopware5' },
  body: { fields: { shop_url: 'https://shop.example.com', api_user: 'api-assistant', api_key: process.env.SW5_KEY } },
});
console.log(tool.id);
```

## 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](http://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.


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