Set up your shop
- 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. - 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.
- 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…). - Choose Add. The sign-in and the read access are checked before the connection is saved. Then assign the connection to your assistant.
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.
- Leave a cancellation request for your team on an order.
- Leave a return or exchange request for your team on an order.
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.
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:- 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.
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 as0151 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.
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.