> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rc.cleverhub.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Connector

> This guide walks you through the end-to-end setup process: creating the connector app, generating the required credentials in Shopify, entering them in Clever AI, and using the chatbot once your data has synced.

## Overview

The Shopify Connector is a data integration feature within Clever AI that links your Shopify store to the Hello Clever platform. Once connected, Clever AI can read your store’s data and provide intelligent insights, analytics, and answers to your business questions through the AI-powered chatbot.

This guide walks you through the end-to-end setup process: creating the connector app, generating the required credentials in Shopify, entering them in Clever AI, and using the chatbot once your data has synced.

<Note>
  **Do you need to connect Shopify first?**

  If your transactions already flow through the Hello Clever payment gateway, you can use Clever AI immediately without connecting Shopify.

  The Shopify Connector is an additional feature used when you want Clever AI to enrich its response with store-specific data (orders, customers, inventory) beyond payment transaction insights.
</Note>

## Prerequisites

Before you begin, make sure you have the following:

* An active Shopify store with admin access
* A Hello Clever merchant account with access to Clever AI
* Permissions to create and install custom apps in your Shopify store’s developer portal

<Tip>
  **Tip**

  Ready to proceed with the setup process? Proceed to the [**step-by-step guide**](#step-by-step-guide).
</Tip>

## How it works

The Shopify Connector uses Shopify’s secure API system to grant Clever AI **read-only** access to specific areas of your store’s data. Here is the flow:

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-how-it-works.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=47536db59cefad3a12427d5a9ab6bca4" alt="How it works" width="1920" height="800" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-how-it-works.png" />

* You create a custom app in Shopify and select which data scopes Clever AI may read.
* You copy the API credentials from Shopify and paste them into Clever AI connector settings.
* Clever AI syncs your store data within 24 hours.
* Once synced, you can chat with Clever AI about your store’s performance, customers, and orders.

<Note>
  **Read-only access**

  Clever AI only reads your Shopify data. It does not write to, or delete anything in your store. Access is strictly limited to the scopes you explicitly select during setup.
</Note>

### Data scopes

When setting up the Shopify Connector app, you will be asked to grant access to specific data scopes. Clever AI currently supports nine scopes, all related to the financial and operational aspects of your store. The following table describes each scope.

| **Scope**                            | **What Clever AI can access**                             |
| ------------------------------------ | --------------------------------------------------------- |
| **read\_customers**                  | Customer profiles, contact details, and purchase history  |
| **read\_orders, read\_all\_orders**  | Order details, line items, totals, and fulfilment status  |
| **read\_products**                   | Product listings, variants, pricing, and inventory levels |
| **read\_shopify\_payments\_payout**  | Stock quantities and locations across warehouses          |
| **read\_shopify\_payments\_dispute** | Chargeback and payment dispute records                    |
| **read\_price\_rules**               | Discount and promotional pricing configurations           |
| **read\_returns**                    | Return requests and their current statuses                |
| **read\_payment\_terms**             | Payment due dates and B2B invoice terms                   |

<Warning>
  **Scope Limitations**

  * Clever AI can only answer questions about your store based on the data scopes you have granted.
  * If the chatbot cannot answer a question, it’s possible a relevant scope was not selected during setup.
  * Sensitive data such as bank account details, passwords, and billing information are never requested and are never accessible.
</Warning>

## Step-by-step guide

Using the Shopify Connector requires four (4) parts:

1. Create a custom connector app in Shopify.
2. Install the custom connector app to your store.
3. Add the custom connector app in Clever AI.
4. Start using Clever AI to query your store data.

Each part is discussed in detail below.

### Part 1 - Create a custom connector app in Shopify.

1. Log in to your Shopify Admin dashboard at *[https://admin.shopify.com](https://admin.shopify.com)*.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-admin-dashboard.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=a253aeb143ae863407769d6633bd84ee" alt="Shopify Admin Dashboard" width="1130" height="735" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-admin-dashboard.png" />

2. On the upper right-hand portion of the dashboard select the name of your store to connect to Clever AI. **This is an important step if you have several stores you manage under your account.**

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/store-selection.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=f93b106d51cff87a46a085c4350caeab" alt="Store selection" width="1130" height="486" data-path="clever-ai/img/clever-ai-shopify-connector/store-selection.png" />

3. At the bottom of the left-hand navigation, click **Settings**, then select **Apps**. This opens the **Apps** list. Select the **Develop apps** button. The **App development** panel opens.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/settings-develop-apps.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=bc8eff1e231996f4965c2f9bbb1a8fe4" alt="Opening Develop apps options" width="1130" height="735" data-path="clever-ai/img/clever-ai-shopify-connector/settings-develop-apps.png" />

4. Select **Build apps in Dev Dashboard** button. This opens the Dev dashboard.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-graphics.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=1bdf74911114a1443fe57f5dfce24341" alt="Opening Create an app option" width="1130" height="735" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-graphics.png" />

5. Select **Create app**. This opens the Create an app panel. Give your app a descriptive name (for example, “Clever AI Connector”).

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-app-name.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=a34aa6a1fe15069b6c839df0e8c3ae08" alt="Naming the app" width="1130" height="606" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-app-name.png" />

6. Once the app is created, the **Create version** panel opens. Here you can add additional information about the app. For this guide we will just focus on the scopes.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-create-version.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=dd9c7c2bc4333adf5be95f536bcf93aa" alt="Creating a version" width="1130" height="606" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-create-version.png" />

7. Scroll down to the **Access > Scopes** section and select **Select scopes**.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-scopes.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=7bdb9991085c5f3ce981ae1df05ae39a" alt="Selecting scopes" width="1130" height="606" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-scopes.png" />

8. Scroll through the list of API access scopes. Select the read permissions relevant to your needs. Refer to the Data scopes table above for guidance. Only select `read_` scopes; do not grant write access. Select **Done** when finished.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-scopes-selection.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=f165e72fb1495c37c9127a02752bfba3" alt="Scope selection" width="1130" height="763" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-scopes-selection.png" />

For your convenience, you can copy the following code and paste it in the **Scope** text field:
`read_customers,read_orders,read_all_orders,read_products,read_shopify_payments_payouts,read_shopify_payments_disputes,read_price_rules,read_returns,read_payment_terms`

<Note>
  **Requesting access to scopes**

  Some of Shopify’s pre-defined scopes are protected and require you to request access to them. If you encounter such a scenario, go to the **Access > Scopes** section and select the **Request access** link.

  <img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-request-access.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=d033e975e71c73f678859bcb6983571a" alt="shopify-connector-request-access.png" width="1130" height="350" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-request-access.png" />
</Note>

9. <a id="fully-installed" /> Select **Release**. In the pop-up window, select **Release** again.
   Your Clever AI connector app is now ready.
10. <a id="credentials" /> Go to the **Settings** panel and under the **Credentials** section, copy and save the **Client ID** and **Secret** of your app for use in Part 3 of this setup.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=d9220652ee68938a822eb40426ba41a6" alt="App credentials" width="1130" height="467" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-.png" />

### Part 2 - Install custom connector app to your store.

1. From the **Dev dashboard**, select the new custom connector app.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-select-new-app.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=3a55076f7d7c5cc471a9cdc43c784335" alt="App selection for installation" width="1130" height="467" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-select-new-app.png" />

2. Scroll down to the **Installs** section and select **Install app**. This will open a window where you can select the store to install the connector in.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-install-button.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=bb81989916ede3ad6d7feb4c80a2e153" alt="shopify-connector-install-button.png" width="1130" height="724" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-install-button.png" />

3. Select your store.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-store-selector.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=db8b173bc124f417664215bfab6bc902" alt="Store selection" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-store-selector.png" />

4. In the **Install app** panel, select **Install**.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-install-app.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=2e8cf2a352ec2cec795a42e01664fb5b" alt="Install app" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-install-app.png" />

5. Once installed, your connector app will now be listed under **Apps** in the left-hand navigation menu of your Shopify dashboard.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-installed-app.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=ac62315aa4d06ad1afdaaa4e3bd658e5" alt="App installed in selected store" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-installed-app.png" />

You can now add and use the custom connector app to Clever AI.

### Part 3 - Add the custom connector app in Clever AI.

After setting up your custom connector app in Shopify, you need to do the following:

1. Log in to your Hello Clever merchant account and navigate to the Clever AI hub.
2. In the prompt box, select **+ Data connectors**. From the pop-up options, select **Shopify** under **Add new data connector**.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-app-shopify-connector.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=46b5fb8ea26602eacbc5d3b11288b02e" alt="Adding Shopify connector" width="1130" height="724" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-app-shopify-connector.png" />

3. In the setup form, enter the following details:

| **Field**         | **What to enter**                                                                                                     |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Store name**    | A friendly label to identify this connection, e.g. “My Shopify Store”.                                                |
| **Store URL**     | Your full **Shopify** store URL, e.g. **mystore**.myshopify.com. This is unique to your store and must match exactly. |
| **Client ID**     | The Client ID you saved in [Part 1, Step 10](#credentials).                                                           |
| **Client secret** | The secret you saved in [Part 1, Step 10](#credentials).                                                              |

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-connector-details.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=ad2e66a3d5df45a9fae72d6d5a966473" alt="shopify-connector-connector-details.png" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-connector-details.png" />

<Note>
  **Retrieving your Shopify store URL**

  To retrieve the correct Shopify Store URL for use in the setup:

  1. Check the URL of your Shopify Admin dashboard in your browser. It will be something similar to `https://admin.shopify.com/store/YOUR-STORE` where `YOUR-STORE` is your store identifier.
  2. Append `.myshopify.com` to your store identifier, for example `YOUR-STORE.myshopify.com` . This will be your Shopify Store URL.
</Note>

4. Select **Connect**. The new custom connector app will now be connected to Clever AI.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-pop-up-notification.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=57e5762d00576b15c0c73eaf02c1d544" alt="Connected Shopify store connector pop-up notification" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-pop-up-notification.png" />

Clever AI will begin synching your store data. This process can take up to 24 hours.

### Part 4 - Start using Clever AI to query your store data.

Once your Shopify store has been connected to Clever AI, you can now ask questions specific to your store information (within the scopes allowed).

1. In the prompt box, select **+ Data connectors.**
2. From the pop-up menu, toggle on your store’s name.

<img src="https://mintcdn.com/helloclever-8a6f7f0c/Q3aTBY9Uybo5CtDf/clever-ai/img/clever-ai-shopify-connector/shopify-connector-toggle-on.png?fit=max&auto=format&n=Q3aTBY9Uybo5CtDf&q=85&s=d11043b91d94876b53bf1e5fdeb27680" alt="Shopify connected and toggled on" width="1130" height="612" data-path="clever-ai/img/clever-ai-shopify-connector/shopify-connector-toggle-on.png" />

3. Start asking questions. Clever AI will now query your store’s data when answering.

## Glossary

| **Term**             | **Definition**                                                                                                       |
| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Client ID**        | A secure credential generated by Shopify that allows Clever AI to authenticate with your store’s API on your behalf. |
| **Secret**           | A secondary credential paired with the access token used for secure API communication.                               |
| **Clever AI**        | Hello Clever’s AI-powered chatbot that analyses your store data and responds to business queries.                    |
| **Data connector**   | An integration that links an external platform (such as Shopify) to Clever AI as a data source.                      |
| **Data scope**       | A defined permission that specifies exactly which category of data Clever AI is allowed to read.                     |
| **Hello Clever Hub** | The central dashboard where merchants manage their Hello Clever products, including Clever AI and data connectors.   |
| **Read-Only Access** | Access that allows Clever AI to view and analyse data without making any changes to your store.                      |
| **Store URL**        | The unique web address of your Shopify store, typically in the format yourstore.myshopify.com.                       |
| **Store Name**       | A user-defined label for your connection in Clever AI. This is different from your Store URL.                        |
| **Sync**             | The process by which Clever AI retrieves and indexes your store data so it can be queried by the chatbot.            |

## Troubleshooting

### **Duplicate Store Domain Error**

Each store domain is treated as a unique identifier in the Clever AI system. If you see an error about a duplicate store domain, it means that store has already been registered.

**To resolve this:**

* Check whether the connector has already been set up by another team member.
* If you need to re-connect, remove the existing connector entry before adding a new one.
* Make sure you are entering the Store Domain and not the Store Name; these are different fields.

### **Store Domain vs. Store Name**

| **Store Domain / URL**                                                                                                         | **Connection Name (Store Name)**                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| The actual URL of your Shopify store, e.g. mystore.myshopify.com. This must be unique and exactly match what Shopify assigned. | A friendly label you choose for your own reference within Clever AI, e.g. “AU Store” or “Main Shopify”. Does not need to match your Shopify URL. |

### Chatbot Cannot Answer My Question

If Clever AI responds that it does not have enough information, the most likely cause is a missing data scope.

* Return to your Shopify app settings and review which scopes are enabled.
* Add the relevant read scope and reinstall the app to update the credentials.
* Note that it may take up to 24 hours for the newly scoped data to become available.

### Data Has Not Synced After 24 Hours

**If your store data still has not appeared in Clever AI after 24 hours:**

* Verify that all credentials were entered correctly (no extra spaces or missing characters).
* Check that the app was fully installed in Shopify ([Part 1, Step 9](#fully-installed)).
* Contact Hello Clever support for assistance.

## Security & Data Privacy

Hello Clever takes data security seriously. The following principles govern how Clever AI handles your Shopify data.

* Clever AI only requests read access. It will never write to, modify, or delete data in your Shopify store.
* Access is strictly limited to the scopes you select. No additional data is retrieved beyond what you have explicitly approved.
* Your API credentials are stored securely within the Hello Clever platform and are not shared with third parties.
* Sensitive financial information such as bank account numbers, passwords, and personal identity data fall outside the supported scopes and are never accessible.

For questions about the data-sharing agreement between your store and Hello Clever, please refer to your merchant contract or contact the Hello Clever business team.

## Need Help?

If you encounter an issue not covered in this guide, please [reach out](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho) to the Hello Clever support team.

* [Contact Hello Clever support](https://share.hsforms.com/1pdw9TJWWQseZKsjutCPu-g4obho) through your merchant dashboard.
* Have your Store Domain and Connection Name ready when contacting support.
* For urgent issues, include details of any error messages you received.


## Related topics

- [WooCommerce Connector](/clever-ai/woocommerce-connector.md)
- [Get Started with Hello Clever](/getting-started/overview.md)
- [Add Hello Clever to Shopify](/integrations/shopify.md)
