This guide provides step-by-step instructions on how to install the Smart Proposals module in Shopware, configure it, and ensure it works correctly on your store's frontend.
You can install the Smart Proposals module using two methods:
Obtain the module package (.zip file) from the GoAI AIA Panel or the official GoAI website.
Extract the .zip file on your computer.
Upload the extracted folder to the following directory in your Shopware installation:
custom/plugins/SmartProposals
Log in to the Shopware Admin Panel.
Navigate to Extensions → My Extensions.
Locate SmartProposals in the list of installed modules.
Click Activate.
After activating the module, clear the cache by running these commands in the terminal:
bin/console cache:clear
bin/console plugin:refresh
bin/console plugin:install --activate SmartProposals
In your terminal, navigate to the Shopware root directory:
cd /path/to/your/shopware
Add the GoAI repository to composer.json:
{
"repositories": [
{
"type": "composer",
"url": "https://ai-repo.gomage.com"
}
]
}
Alternatively, use this command:
composer config repositories.goai composer https://ai-repo.gomage.com
Run the following command to install the Smart Proposals module:
composer require goai/smartproposals
Execute the following commands to activate the module:
bin/console plugin:refresh
bin/console plugin:install --activate SmartProposals
bin/console cache:clear
Visit the GoAI AIA Panel:
👉 https://aia.gomage.com/
Log in with your credentials.
Generate your clientUid and customize the following parameters:
#2cac2c).#4b2a2a).bottom-left, bottom-right, top-left, or top-right).Copy the generated script URL.
Example script URL:
https://aia.gomage.com/js/UserActionTracker.js?clientUid=dbljpvsyb&apiPoint=https://aia.gomage.com/api/data/ai_ecommerce_cro/track_activity&buttonColor=#2cac2c&bgColor=#4b2a2a&position=bottom-left&apiType=shopware
Log in to Shopware Admin Panel.
Navigate to Settings → Plugins → SmartProposals.
In the field SmartProposals.config.scriptUrl, paste the generated script URL:
https://aia.gomage.com/js/UserActionTracker.js?clientUid=dbljpvsyb&apiPoint=https://aia.gomage.com/api/data/ai_ecommerce_cro/track_activity&buttonColor=#2cac2c&bgColor=#4b2a2a&position=bottom-left&apiType=shopware
Click Save to apply the changes.
Go to Settings → Cache & Indexes.
Click Clear Cache to apply the changes.
After configuring and clearing the cache, verify the following on your store’s frontend:
If the button does not appear, follow these steps:
With the Smart Proposals module installed and configured, your store is now equipped with an AI-powered solution that provides personalized proposals to your customers, optimizing conversion rates and improving the overall shopping experience.