How to make a FlowHunt AI Chatbot for Shopify

This guide walks you through connecting FlowHunt to your Shopify store, adding a prebuilt Shopify chatbot flow, publishing it, and embedding the chatbot on your storefront.

Prerequisites

• A Shopify store with admin access
• A FlowHunt account with workspace access: https://app.flowhunt.io/
• Important: Use the same email for your FlowHunt account as your Shopify admin account.

1) Integrate Shopify with FlowHunt (via Shopify App Store)

1. Open the Shopify App Store and search for “FlowHunt”.
2. Click Install and, if prompted, select the correct store.
3. Review the requested permissions and click Install app / Authorize.

After installation, you’ll be redirected to Shopify and/or FlowHunt. The connection is created through the marketplace install flow.

2) Install the FlowHunt App on your Shopify store

1. In the Shopify authorization screen, review requested permissions.
2. Click Install app to complete installation.

3) Confirm the Shopify integration is enabled

After successful installation, return to FlowHunt → Integrations. You should see Shopify marked as Connected/Enabled.

If it isn’t enabled, click Connect again and follow the authorization flow.

4) Add a Shopify chatbot from the Flow Library

1. In FlowHunt, go to Flow Library.
2. Search for “Shopify Chatbot”.
3. Open the template and click Add to Workspace.

This will add a ready-to-use Shopify chatbot flow to your workspace.

5) Customize the chatbot for your brand

Open the flow you just added and adjust:

• System prompt and tone: Set your brand voice and guardrails.
• Knowledge sources: Connect your product catalog, FAQ, policies, or other docs.
• Tools and actions: Optionally enable order lookup, status checks, or CRM updates if your plan and setup allow.
• UI/branding: Configure widget name, greetings, and any visible labels later in the Chatbots section.

When done, Save your changes.

6) Publish the flow

Click Publish on the flow so it’s available to be used by a chatbot on your website/storefront.

7) Create a new Integration Code (Chatbot)

1. Go to Chatbots in FlowHunt.
2. Click New Integration Code.
3. Select the published flow you created above.
4. Configure widget options (theme, position, open behavior, language, domain allowlist, etc.).
5. Save. FlowHunt will generate a script snippet (your Integration Code).

Keep this snippet handy—you’ll paste it into your Shopify theme in the next step.

8) Embed the chatbot on your Shopify storefront

You can add the Integration Code in two ways. Choose the option that best fits your needs.

Option A — Add to theme.liquid (site-wide)

This method adds the chatbot to every page of your store. Follow these detailed steps:

Step 1: Navigate to your Shopify admin and go to Online Store > Themes

Step 2: Click the Customize button next to your active theme Step 3: Click the 3 dots (⋯) at the top left and select Edit Code

Step 4: Locate your theme.liquid file in the Layout folder (/layout/theme.liquid)

Step 5: Add the Integration Code just before the closing </body> tag Step 6: Save your changes by pressing Ctrl + S (or Cmd + S on Mac)

After saving, visit your storefront and refresh the page. The chatbot should appear on all pages.

Important Notes:

• Pasting before </body> ensures the widget loads on every page
• Keep the FlowHunt snippet intact and unmodified
• The chatbot will appear on all pages of your store

Option B — Add via a Custom Liquid section (specific pages)

This method allows you to show the chatbot only on specific pages or templates. Perfect if you want the chatbot on product pages only, or specific landing pages.

Step 1: Go to Online Store > Themes and click Customize next to your active theme

Step 2: Navigate to the specific template you want to add the chatbot to (e.g., Product pages, Collection pages, or a specific page)

Step 3: Click Add section or Add block (depending on your theme) Step 4: Look for and select Custom Liquid from the available options Step 5: Paste your FlowHunt Integration Code into the Custom Liquid content area

Step 6: Click Save and then Preview to test the chatbot on that specific template

Important Notes:

• This method gives you precise control over where the chatbot appears
• You’ll need to repeat these steps for each template where you want the chatbot
• Great for testing the chatbot on specific pages before rolling out site-wide
• The chatbot will only appear on the templates you’ve configured

Verification and testing

• Open your storefront in an incognito/private window to avoid cached assets.
• Ask common questions (shipping, returns, product availability) to validate the flow.
• Review the conversation logs in FlowHunt (enable Verbose if needed) to see what documents or tools were used.

Troubleshooting

• Chatbot not showing: Ensure the Integration Code is included on the page, your theme is published, and the domain is allowed in the Chatbots settings.
• Duplicated widgets: Remove any duplicate snippets and keep one active Integration Code.
• Missing answers: Verify Knowledge Sources and Document Retriever settings in your flow, then republish.
• Shopify permissions error: Reconnect Shopify under FlowHunt → Integrations and reinstall if prompted.