Magento connector

Connect Magento 2 or Adobe Commerce to FreeScout so conversations show matched customer orders and purchase context. A small read-only Magento module exposes a support summary over the Magento REST API, and the FreeScout connector shows it in the conversation sidebar. On Pro, ReplyRabbit also feeds product-ownership context into the AI layer so drafts can reference what a customer has bought.

Overview

The Magento connector adds an order sidebar to FreeScout conversations. When a conversation has a customer email address, the connector calls the moo-support/summary endpoint on your Magento store for matching orders and shows them next to the conversation.

Free shows a basic customer panel plus up to three recent orders, each with order number, date, status, and total. Pro adds full order history, per-order line items with quantities and prices, financial totals, customer lifetime value (CLV), average order value (AOV), and product-ownership entitlement that flows into the ReplyRabbit AI context for more relevant drafts.

There are two components to install:

• The Moogento Support Data module for Magento 2. It adds two read-only REST endpoints (/rest/V1/moo-support/summary and /rest/V1/moo-support/purchased-products) behind a dedicated admin permission called Support Data API. It does not change the storefront or checkout.
• The FreeScout Magento connector module. It calls those endpoints over HTTPS using a Magento integration access token and renders the order sidebar. It has its own per-mailbox settings page in FreeScout.

The order sidebar works on its own. The product-ownership entitlement that flows into AI drafts is the part that uses ReplyRabbit.

Prerequisites

Before you start, make sure you have:

• A working FreeScout installation.
• A Magento 2.4 or later store (Magento Open Source or Adobe Commerce) reachable over HTTPS, with SSH access to run Magento CLI commands.
• Magento admin access to create an Integration.
• ReplyRabbit installed and activated if you want product-ownership context in AI drafts.
• A way to unlock Pro for the connector: a free connector license key from your ReplyRabbit account during the launch promo, or an active paid ReplyRabbit plan (Pro or Team).

If ReplyRabbit is not installed yet, start with How to install the ReplyRabbit module, then finish How to set up ReplyRabbit.

Install the Magento module

1. Download the Magento module

   Free during the launch promo. Log in with a verified email at app.replyrabbit.app and download the Magento module ZIP from the Magento connector card.

2. Unpack it into app/code

   Upload the ZIP to your Magento root and unpack it. It creates app/code/Moogento/SupportData.

3. Enable the module

   From the Magento root, run:

   bash

   Copy

   bin/magento module:enable Moogento_SupportData
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush

   On a store in production mode, also run bin/magento setup:static-content:deploy as you would for any module install.

Create a Magento integration token

The connector authenticates with an access token from a Magento Integration. Create one scoped to the module's read-only permission.

1. Open Integrations

   In the Magento admin, go to System, then Extensions, then Integrations, and click Add New Integration.

2. Name it and set the API scope

   Enter a name such as "FreeScout connector" and your admin password. On the API tab, set Resource Access to Custom and tick only Support Data API (under the top-level admin tree). Save.

3. Activate and copy the access token

   Click Activate next to the new integration, then Allow. Copy the Access Token. Magento shows the token in the integration details, so you can return to it later.

Install the FreeScout connector module

The FreeScout Magento connector module calls the Magento endpoints and renders the order sidebar in conversations. It is its own module with its own settings, separate from ReplyRabbit.

1. Download the connector module

   Free during the launch promo. Log in with a verified email at app.replyrabbit.app to download the FreeScout connector module ZIP.

2. Upload to FreeScout

   In FreeScout, go to Modules, click the upload button, choose the ZIP, and install it.

3. Activate the module

   Activate the Magento Integration module from the Modules list.

Configure per mailbox

After the module is installed, connect it to your store in the connector's own per-mailbox settings page.

1. Open the connector settings

   In FreeScout, open the mailbox that should show Magento order data, open the mailbox settings menu, and choose Store Connector. This is the Magento connector's settings page, not a section inside the ReplyRabbit settings.

2. Enter the Magento base URL

   Paste the base URL of your Magento store over HTTPS, for example https://your-store.com. A trailing slash is not needed.

3. Enter the access token

   Paste the Access Token from the Magento integration. It is stored encrypted, and only a masked preview is shown after saving.

4. Set the store ID (optional)

   Leave blank to match orders across all stores. Enter a Magento store ID to limit the sidebar to one store or store view.

5. Add a Pro license key (optional)

   To unlock Pro features, enter a connector license key. Skip this step if an active paid ReplyRabbit plan already unlocks Pro for the install.

6. Save and test

   Save the settings. Open a FreeScout conversation where the customer email matches a Magento order and confirm that the order sidebar appears.

Each FreeScout mailbox stores its own base URL, access token, and store ID, so you can connect different mailboxes to different Magento stores or store views.

Free vs Pro

How to unlock Pro

Pro is free for a limited time during the launch promo. You can unlock the same Pro features two ways:

• Log in with a verified email at app.replyrabbit.app to download the connector and copy your free connector license key, then paste it into the connector settings.
• Run any active paid ReplyRabbit plan (Pro or Team), which unlocks the connector's Pro features at no extra cost.

Get your free connector license key and downloads from your ReplyRabbit account. Visit the pricing page for ReplyRabbit plan options. If a paid plan already covers the install, Pro activates once the connector is configured, with no license key needed.

Troubleshooting

For broader issues, see Troubleshooting ReplyRabbit.

Privacy and data handling

When the connector queries Magento, it sends the customer email address to your own Magento store over HTTPS. The order data returned from your store populates the FreeScout sidebar and, on Pro with ReplyRabbit, builds the AI context for drafts.

The integration token only needs the read-only Support Data API resource, so the connector never writes to your store. The token is stored encrypted in FreeScout, and outbound requests verify TLS and follow no redirects.

No Magento order data is sent to third parties except through the AI provider selected for the mailbox, and only when the AI context feature uses it. If your policy requires order data to stay entirely on your own servers, use a local AI provider (such as Ollama) for the mailbox.

Next steps

• Finish How to set up ReplyRabbit if the mailbox still needs provider, context, or style settings.
• Also on WooCommerce? See the WooCommerce connector guide.

FAQ