Skip to main content
Available on: Starter, Advanced, Business, and Enterprise.
Shopware 6 uses Actions. Free plans do not include Actions.

Before you start

Before connecting Shopware 6, make sure:
  • You are on a plan that includes Actions.
  • You have access to the Watermelon agent you want to connect.
  • You know the base URL of your Shopware store.
  • You have the Store API Access Key from your Shopware sales channel.
  • You have the Admin API Key and Admin Secret for your Shopware integration.

​
What you’ll do

  1. Select your agent Choose the AI agent you want to connect to Shopware 6.
  2. Add Shopware 6 as an action Go to Actions and select Shopware 6.
  3. Choose the allowed Shopware actions Choose which Shopware actions your agent is allowed to use.
  4. Enter your Shopware credentials Enter your Shopware Base URL, Store API Access Key, Admin API Key, and Admin Secret.
  5. Connect and activate Connect your Shopware store. The action is activated as soon as the connection succeeds.

​
Connect Shopware 6 from Watermelon

Connect Shopware 6 directly from Watermelon to choose the agent you want to use and configure which Shopware actions the agent can access.
1

Go to your agents

In Watermelon, go to Agents.Select the agent you want to connect to Shopware 6.
Connect Shopify 1
2

Open Actions

In the selected agent, navigate to Actions.Click Actions, then select Shopware 6.
Connect Shopware 2
3

Name your Shopware connection

Give this Shopware connection a clear name.For example:
  • Shopware store
  • Main webshop
  • Watermelon Shopware connection
Use a name that helps your team recognize the connection later.
Connect Shopware 3
4

Select the Shopware actions

Choose which Shopware actions your Watermelon agent is allowed to use.You can select one or both of the following actions:
Allows your agent to retrieve products from Shopware and show them to customers in the chat.
Allows your agent to retrieve order information from Shopware and display it in the chat.
These are currently the only actions available for the Shopware 6 integration.
Connect Shopware 4
5

Enter your Shopware Base URL

Enter the base URL of your Shopware store.For example:https://your-store.com
Connect Shopware 5
6

Enter your Store API Access Key

Enter the Store API Access Key from your Shopware sales channel.
Connect Shopware 6
7

Enter your Admin API Key and Admin Secret

Enter the Admin API Key and Admin Secret created for your Shopware integration.Make sure both credentials belong to the Shopware store you want to connect.
Connect Shopware 7
8

Connect and activate

Complete all authentication fields before clicking Connect.The Shopware action is activated as soon as the connection succeeds.
There is no separate activation step. Your Shopware action becomes active immediately after a successful connection.
Connect Shopware 8
9

Test your Shopware connection

After connecting Shopware 6, use the Playground to check whether your agent can use the enabled actions correctly.For example:

Product questions

“Can you show me blue sneakers?”

Order questions

“Can you help me check my order?”
Check whether the agent gives accurate answers and uses the Shopware actions as expected.

​
Next steps

Once Shopware 6 is connected, test the available actions to make sure your agent handles product and order questions as expected.

Test product retrieval

Ask your agent to find and display products available in your connected Shopware store.

Test order retrieval

Ask your agent to retrieve an order and check whether the correct order information is displayed.

​
Troubleshooting

​
I entered my Shopware Base URL but cannot connect

Check that the Base URL is correct and belongs to the Shopware store you want to connect. For example: https://your-store.com Also check that all authentication fields have been completed before clicking Connect.

​
My Store API Access Key is not working

Check that you are using the Store API Access Key from the Shopware sales channel you want to connect. Make sure the key belongs to the same Shopware store as the Base URL you entered.

​
My Admin API credentials are not working

Check that both the Admin API Key and Admin Secret are correct. Make sure you are using the credentials created for your Shopware integration and that they belong to the Shopware store you want to connect.

​
The connection succeeds, but the agent does not show products

Make sure the Retrieve and display products action is enabled. Also check whether the product exists in the connected Shopware store. Use the Playground to test the product flow again.

​
The agent says it cannot access order information

Make sure the Retrieve and display orders action is enabled. The customer also needs to provide enough order details for the agent to identify the order. Use the Playground to test the order flow again.

​
I want to change the enabled Shopware actions later

Go back to the Shopware action settings in Watermelon and update the selected actions. Currently, the available Shopware actions are:
  • Retrieve and display products
  • Retrieve and display orders
After making changes, test the flow again in the Playground.

​
I already connected a Shopware store

Check whether the current agent already has a Shopware action configured. If you want to connect a different store, create or update the Shopware action for that agent.