Connect a Magento or Adobe Commerce store

Create an integration in your Magento Admin, then enter its four keys and your store's URL on the Magento card under Integrations in the Webscale AI console. Select Create, then Verify. Products, categories, customers, orders and stock then sync every 6 hours by default.

Before you start

Use this guide to connect a Magento Open Source or Adobe Commerce store so the AI Shopping Assistant and Audience Segmentation work from your live store data. Both editions use the same Magento connector. The Supported platforms and integrations reference lists what each connector syncs.

The Magento connector uses four values from a Magento integration: a consumer key, a consumer secret, an access token and a token secret. Magento shows the access token and token secret when you activate the integration. Keep the console and your Magento Admin open in separate tabs while you work.

Steps

1. In the Webscale AI console, open the account menu and select Integrations.
2. On the Magento card, select Connect. The Magento Connection page opens.
3. In your Magento Admin, go to System > Integrations and select Add New Integration.
4. On the Integration Info tab, enter a Name, such as Webscale AI. Leave Callback URL and Identity link URL empty. Enter your Magento Admin password in Your Password.
5. On the API tab, set Resource Access to All. If your store’s policy requires Custom, select every area listed under Integration access. Select Save.
6. In the integrations list, select Activate next to the new integration, then Allow. Magento shows the consumer key, consumer secret, access token and token secret. Copy all four.
7. Back on the Magento Connection page, enter your store’s REST API address in Website URL, in the form https://your-store.com/rest/default/V1. Replace your-store.com with your domain and default with your store view code. A bare domain fails verification.
8. Paste the four values from Magento into Consumer Key, Consumer Secret, Access Token and Token Secret. Each field is masked.
9. Select Create.
10. Select Verify. The page shows Verification Successful! when Webscale AI can reach your store.

The Magento Connection page also links to a setup guide, which isn’t available. The steps above cover the whole connection.

Once the connection is verified, Webscale AI syncs products, categories, customers, orders and stock levels from your store.

Integration access

Webscale AI reads your store through the Magento integration. It changes orders only when Allow write actions is on for Order & Returns Management. With Custom resource access, select these areas so every feature works.

Area in the API tab’s resource tree	What Webscale AI uses it for
Stores > Settings > All Stores, and Stores > Attributes > Product	Verifying the connection, reading store views and attribute labels
Catalog > Inventory > Products and Categories	Syncing your catalog
Stores > Inventory > Sources and Stocks	Syncing stock levels
Customers > All Customers	Syncing customers and checking a shopper’s identity before order details are shared
Sales > Operations > Orders, including Cancel, Invoice, Ship, Credit Memos and Comment under Actions	Syncing orders and answering order questions. Changes need Allow write actions
Returns, on Adobe Commerce	Starting returns through Order & Returns Management. Needs Allow write actions

Check that it worked

The Magento connection is working when all three of these are true:

• The Magento Connection page showed Verification Successful! after you selected Verify.
• On the Integrations page, the Magento card shows a Connected badge and its button reads Update connection.
• Under Settings > Data > Product catalog sync, the Status badge shows Completed with a time next to Last synced at:.

The first sync can take a while on a large catalog. While it runs, the Status badge shows Syncing.

Change the sync schedule

Webscale AI syncs a Magento store every 6 hours by default. Each sync brings in only what changed since the last one. You can run a sync right away or set your own schedule.

1. Go to Settings > Data > Product catalog sync.
2. To sync now, select Sync now. The button reads Syncing… while the sync runs.
3. To set a schedule, select Create Schedule in the scheduling card, or Edit Schedule if one exists.
4. Choose a Schedule Type of Hourly, Daily, Weekly or Monthly. Then set the time and timezone and save the schedule.

The scheduling card shows “No schedule configured” until you save a schedule of your own. The default sync still runs every 6 hours while the card shows that message.

Track shopper behavior on your site

The Magento connector syncs store data. Shopper behavior on your site comes from Onsite Tracking, which Audience Segmentation uses to build segments.

1. On the Integrations page, select Connect on the Onsite Tracking card.
2. Select Copy to copy the script. Add it to your site’s main template, before the closing </body> tag.
3. Select Verify. The button reads Verified when Webscale AI finds the script on your site.

Troubleshooting

Problem	Fix
Verification fails with “Please check your OAuth settings.”	Check that the integration is active in your Magento Admin. Paste the four values again so none has extra spaces
One type of data doesn’t sync, such as orders or stock	With Custom resource access, check that the integration includes that area under Integration access. Then select Sync now
Verification still fails with the right values	Check that Website URL is the full REST API address ending in /rest/<store code>/V1. Then select Update and Verify again
You changed the integration in Magento	On the Integrations page select Update connection on the Magento card. Enter the new values and select Update. Then select Verify
Product catalog sync shows Failed	Select Sync now to try again. Contact Webscale support if it fails a second time
The scheduling card says “No schedule configured”	Nothing is wrong. The default sync runs every 6 hours. Create a schedule only to change the timing
Onsite Tracking shows “Website tracking is not enabled.”	Check that the script is in your main template before the closing </body> tag and that the change is live on your site. Then select Verify again
You need to stop syncing	Open the connection page and select Disconnect. Type “disconnect” to confirm. This removes the connection and the keys stored for it

Frequently asked questions

Does Adobe Commerce use a different connector from Magento Open Source?

No. Magento Open Source and Adobe Commerce use the same Magento connector in the Webscale AI console. Follow the same steps for either edition.

How often does Webscale AI sync my Magento store?

Every 6 hours by default. Each sync brings in only what changed since the last one. You can start a sync or set your own schedule under Settings > Data > Product catalog sync.

Does the Magento connector track what shoppers do on my site?

No. Shopper behavior on your storefront comes from Onsite Tracking, a separate card under Integrations. Onsite Tracking needs a script on your site.

What does Disconnect do?

Disconnect removes the Magento connection and the keys stored for it. Webscale AI stops syncing your store until you connect it again.

Which URL do I enter in Website URL?

Enter your store's full REST API address, in the form https://your-store.com/rest/default/V1. Replace your-store.com with your domain and default with your store view code. A bare domain fails verification.