Shopify connector

Connect Shopify to FreeScout so conversations show matched customer orders and purchase context. You create a read-only custom app in your Shopify admin and paste its access token into FreeScout, so there is no Partner account or app review involved. On Pro, ReplyRabbit also feeds product-ownership context into the AI layer so drafts can reference what a customer has bought.

Overview

The Shopify connector adds an order sidebar to FreeScout conversations. When a conversation has a customer email address, the connector queries the Shopify GraphQL Admin API on your 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 is one component to install: the FreeScout Shopify connector module. It reads the Shopify GraphQL Admin API over HTTPS using an Admin API access token from a custom app, then 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 Shopify store on a your-store.myshopify.com domain (or a custom domain that maps to one), with staff permissions to develop apps.
• 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.

Create a custom app in Shopify

The connector authenticates with an Admin API access token from a custom app that lives inside your own store.

1. Open Develop apps

   In the Shopify admin, go to Settings, then Apps and sales channels, then Develop apps. If prompted, allow custom app development.

2. Create the app

   Click Create an app, name it "FreeScout connector", and create it.

3. Set the Admin API scopes

   Open Configure Admin API scopes and tick read_customers, read_orders, and read_products. Tick read_all_orders as well if you want order history older than 60 days. Save.

4. Install and copy the token

   Click Install app, then Reveal token once and copy the Admin API access token (it starts with shpat_). Shopify shows it only once, so store it somewhere safe.

Install the FreeScout connector module

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 Shopify Integration module from the Modules list.

Configure per mailbox

1. Open the connector settings

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

2. Enter the store domain and access token

   Enter your store domain, for example your-store.myshopify.com, and paste the Admin API access token. Save. The connector checks the token and scopes against your store before storing it; the token is stored encrypted and never shown again.

3. Add a Pro license key (optional)

   To unlock Pro features, set SHOPIFYINTEGRATION_LICENSE_KEY in your FreeScout .env to your connector license key. Skip this step if an active paid ReplyRabbit plan already unlocks Pro for the install.

4. Test

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

Each FreeScout mailbox stores its own store domain and access token, so you can connect different mailboxes to different stores.

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 set it as SHOPIFYINTEGRATION_LICENSE_KEY in the FreeScout .env.
• Run any active paid ReplyRabbit plan (Pro or Team), which unlocks the connector's Pro features at no extra cost.

Visit the pricing page for ReplyRabbit plan options.

Troubleshooting

For broader issues, see Troubleshooting ReplyRabbit.

Privacy and data handling

When the connector queries Shopify, it sends the customer email address to the Shopify GraphQL Admin API over HTTPS using your custom app's token. The order data returned from your store populates the FreeScout sidebar and, on Pro with ReplyRabbit, builds the AI context for drafts.

The custom app has read scopes only, so the connector never writes to your store. The access token is stored encrypted in FreeScout, and outbound requests verify TLS and follow no redirects.

No Shopify 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 or Magento? See the WooCommerce connector and Magento connector guides.

FAQ