Skip to main content
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.
  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: 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:
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.

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