# How to configure Magento integration

The Magento integration provides seamless synchronization of your catalog and categories, enabling real-time updates and intelligent automation — without requiring manual API calls or ID configurations.

***

### **Prerequisites**

Before integrating with Magento, ensure you have:

* An active **AB Tasty Recommendations & Merchandising** account
* Admin access to your **Magento store** with integration permissions
* The following Magento API credentials :
  * **Consumer Key** 
  * **Consumer Secret** 
  * **Access Token** 
  * **Access Token Secret**
  * **Store Code** 
  * **Store ID** 
  * **Currency**
* (Optional) Whitelisted AB Tasty IPs if your Magento environment uses bot protection
* Basic understanding of your product catalog structure (categories, variants, stock rules)

***

### **Access Magento integration**

Navigate to the integrations interface to connect your Magento store.

1. Log into your **AB Tasty Recommendations & Merchandising** dashboard
2. Click **SETTINGS** in the left sidebar navigation
3. Select the **Integrations** tab from the settings options
4. Locate **Magento** in the **CMS section** of the integrations page
5. The integration shows **Connected** status if already configured, or a **CONNECT** button if not yet set up

***

### **Set up Magento connection**

Establish a secure integration between your Magento store and the AB Tasty platform.

#### **Authorize AB Tasty access**

1. Click **CONNECT** next to the Magento integration (if not already connected)
2. Enter the Magento API credentials listed above
3. Review and validate the access rights requested by AB Tasty
4. Click **Save changes** to complete the connection

Once authorized, the integration automatically synchronizes your catalog via Magento web services.\
No manual API calls or strategy ID updates are required — saving changes in AB Tasty triggers automatic updates in your Magento environment.

***

### **Configure catalog synchronization**

Keep your product catalog continuously up to date in AB Tasty.

1. Catalog synchronization runs automatically at regular intervals (default: hourly)
2. Any new categories or collections added in Magento are automatically imported after each refresh
3. You can trigger a **manual refresh** from your AB Tasty dashboard if needed
4. Product data such as stock, price, and variant availability are retrieved from your Magento Admin API

{% hint style="info" %}
**Tip:** Ensure that your product hierarchy (parent/child products, bundles, variants) follows Magento’s best practices for optimal merchandising and recommendation performance.
{% endhint %}

***

### **Manage categories and collections**

AB Tasty automatically mirrors your Magento catalog hierarchy.\
This includes:

* Categories and subcategories
* Collections or product groupings
* Custom attributes defined in Magento (brand, tags, promotions, etc.)

Newly created categories in Magento appear automatically in AB Tasty after the next resource refresh, ensuring full alignment between your e-commerce backend and your recommendation setup.

***

### **Security and data management**

The Magento integration is built to ensure safe and compliant data exchange.

* All connections use **OAuth 1.0a** authentication via Magento’s API.
* API credentials are encrypted and securely stored within AB Tasty.
* Access is limited to catalog and merchandising data only — no sensitive customer data is collected.
* If your Magento instance includes a **bot protection system**, whitelist AB Tasty’s Cloud NAT IPs to allow synchronization requests:
  * `130.211.64.215`
  * `34.79.119.76`
  * `35.240.71.177`

***

### **Deploy recommendations on Magento**

Once the integration is complete, you can publish Recommendations & Merchandising strategies directly to your Magento storefront.

#### **Publishing updates**

* When you click **Save changes** in AB Tasty, all merchandising and recommendation updates are automatically pushed via the Magento webservice.
* No manual deployment or script editing is required.

#### **Widget and API deployment**

You can choose between:

* **Custom widgets** integrated directly into your Magento theme
* **Mix mode**, combining front-end widgets and server-side calls
* **Full API mode** for advanced setups or headless Magento implementations

***

### **Next steps**

Once your integration is complete:

* Proceed to Create your first web recommendation
* Or explore How to create a merchandising strategy
* For troubleshooting synchronization issues, visit Sync monitoring and logs

***

#### ✅ **In summary**

The Magento integration with AB Tasty is **native, automated, and secure**.\
It synchronizes your catalog and categories, manages updates automatically, and enables direct publishing of recommendations and merchandising strategies — all without technical complexity.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.abtasty.com/recommendations-and-merchandising/how-tos/how-to-configure-your-catalog-integration/how-to-configure-magento-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.