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

> Let your assistant answer product and order questions from your Shopware 6 shop.

Let your assistant answer product and order questions from your Shopware 6 shop. A caller asks "Is my order 10023 on its way?", and the assistant reads the order, payment and delivery status once it knows who is calling. It also reads products with price and stock. It works with Shopware 6.4 or later and never changes an order's state, payment or delivery. The only write is an optional internal comment for your team (off by default).

## Set up your shop

1. In Shopware, open **Settings → System → Integrations** and choose **Add integration**. Give it a name such as "Phone assistant" and copy the **access key ID** (it starts with `SWIA`) and the **secret access key**. Shopware shows the secret only once.
2. Give the integration a role with View access in the Shopware role editor under **Orders**, **Catalogues → Products**, **Catalogues → Categories** and **Settings → Currencies**. Add view access to system configuration if you want the assistant to know your shop name. Write access to order is needed only for [request notes](#requests-for-your-team).
3. Open **Agent Tools → Marketplace → Shopware 6**. Enter the shop address, the access key ID and the secret access key. Use an integration key, not an admin password, and not a sales channel key (`SWSC…`).
4. Choose **Add**. The sign-in and the read access are checked before the connection is saved. Then assign the connection to your assistant.

The shop address is the public HTTPS address of your shop, for example `https://shop.example.com`. If you paste the admin address, the assistant removes `/admin`.

## What the assistant can do

Enabled by default:

* Search active products by name and read price, stock and whether a product has variants.
* List your product categories to narrow a search.
* Read the status of an order, including payment and delivery status, after the caller is verified.
* Find a caller's recent orders by e-mail address or by the caller's phone number.

Optional, choose them under **Edit**:

* Leave a cancellation request for your team on an order.
* Leave a return or exchange request for your team on an order.

The assistant never reads tracking numbers, addresses or other customers' data aloud.

## Order privacy

The assistant tells order details only to the person the order belongs to. It needs one of two proofs:

* **The phone number.** The number the caller phones from matches the phone number on the order (billing or delivery address). The assistant also needs the order number.
* **A second detail.** The order number plus the e-mail address used for the order or the delivery postcode.

If a detail is wrong, the answer is always the same: no record matches those details. The assistant never says whether an order exists. After three wrong attempts in one conversation, the assistant stops checking. The order number alone is never enough.

When several customers use one phone number, the number does not identify the caller. The assistant then asks for the order number and the e-mail address or the delivery postcode, even if the caller gives the order number. If the caller withholds the number, or there is no phone number (web chat), the assistant asks for the second detail.

## Order, payment and delivery status

The assistant says each status in words:

| Part | What the caller hears |
| - | - |
| Order | received, in progress, completed, cancelled |
| Payment | not paid yet, payment in progress, paid, partly paid, payment authorised, payment failed, payment reminder sent, refunded, partly refunded, payment cancelled, payment not confirmed yet |
| Delivery | not shipped yet, shipped, partly shipped, returned, partly returned, delivery cancelled |

It also names the order date, the products with quantities, the total and the shipping method. For tracking it only says whether a tracking number exists. It does not read the number.

## Requests for your team

Cancellation and return or exchange requests are off by default. When you turn them on, the assistant reads back the order number and the reason, waits for a clear yes and adds a block to the order's **internal comment**:

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

Nothing else changes: the order state stays as it is, no refund happens and no label is created. The assistant asks Shopware not to run flows for this change, so the customer gets no e-mail from it. Your team reads the comment in the order and decides.

* A cancellation request is possible while the order is open or in progress and not shipped.
* A return or exchange request is possible for completed or shipped orders.
* Asking twice for the same order and kind leaves one note.

The integration role needs write access to order. The assistant checks the internal comment field when you connect. If your shop has no orders yet, that check cannot see the field; connect again after the first order.

## Recognising callers

On phone calls the assistant can greet a caller by first name and know their latest order before the caller says anything. Shopware stores phone numbers as typed, so the assistant looks for the last six digits of the caller's number and then compares the numbers exactly. A number saved with spaces inside those digits, such as `0151 123 45678`, is not found this way. The caller can still give the order number together with the e-mail address or the delivery postcode.

## Settings

Two optional settings sit in the connection form:

* **Sales channel ID:** limits product answers to products visible in that sales channel. Leave it empty for all active products.
* **Shop time zone:** sets the time zone for order dates. Empty means Europe/Berlin.

To change a setting, the address or the keys later, edit the connection under **Automations → Connections** or remove the tool and connect again.

## Test safely

Test with a test product and your own phone number. A test call reads your real shop. If you turned on request notes, a test writes a real note to a real order, so use a test order and remove the note afterwards.

## Channels

On phone calls the assistant knows the caller's number. In channels without a phone number, such as web chat, it always asks for the order number plus the e-mail address or the delivery postcode.

## Automations

Connect **Shopware 6** under **Automations → Connections**, or import its Agent Tool connection. Every tool is available as an action. An automation started by a call or a text conversation (SMS, WhatsApp) knows the other party's number from that call itself. Other runs (webhook, schedule) have no caller, so **Order status** needs the e-mail address or the delivery postcode there, and **Caller's recent orders** answers that the number is not available.

## API, MCP, CLI & SDK

`POST /api/v1/tools/integrations/shopware6` · MCP `connect_integration` · CLI `famulor connect-integration shopware6`.

`client.api.connectIntegration` needs `famulor-sdk` 0.2.12 or later. Update the CLI with `npm install --global famulor` before you use `connect-integration`.

```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);
```

## Troubleshooting

* **The address does not lead to the Shopware 6 Admin API:** the shop is older than 6.4, or the address is wrong. Use the public address of the shop without `/api`.
* **The integration's role does not allow this:** open the integration in Shopware and add the missing read access. The message names no entity; check product, category, order, order address, order delivery, order transaction and currency.
* **Shopware rejected the access key ID or secret:** create a new integration and enter its key pair. A sales channel key does not work.
* **Too many sign-ins:** Shopware limits sign-ins for one integration. Wait a few minutes. The assistant reuses its sign-in for about nine minutes.
* **The shop answered with a web page:** a firewall or security plugin blocks API requests. Allow requests to `/api/` for the integration.

[Shopware Admin API documentation](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.