Integrations

Shopify Integration

Connect your Meebly agent to your Shopify store. Once connected, a chat widget is automatically embedded in your storefront so customers can browse products, manage their cart, and get answers to store policy questions — all through your AI agent.

Overview

✓ One-click OAuth setup

No manual webhook configuration — Meebly sets everything up automatically when you authorize your store

✓ Storefront chat widget

A floating chat bubble is embedded in your storefront via a Shopify Theme App Extension — no code required

✓ Shopify Storefront MCP tool

Your agent gets a pre-configured MCP tool to search products, manage carts, and retrieve store policies

✓ Widget customization

Customize the widget title, welcome message, colors, and layout from the Meebly dashboard

Prerequisites

Before connecting, make sure you have:

  • 1
    A Shopify store — any plan works. You need to be the store owner or have staff permissions that include app installation.
  • 2
    An Online Store 2.0 theme — the chat widget uses a Theme App Extension, which only works with OS 2.0 themes (Dawn, Sense, Craft, and most themes released after 2021). To check: go to your Shopify Admin → Online Store → Themes → Customize. If you see a Sections panel in the left sidebar, your theme is compatible.
  • 3
    Your store's myshopify.com domain — in the format yourstore.myshopify.com. Find it in Shopify Admin → Settings → Domains.
You do not need to configure webhooks, generate API keys, or touch any code. Meebly handles all of that automatically during the OAuth flow.

Connecting Your Store

1

Open the Integrations page

In your Meebly dashboard, select the agent you want to connect, then navigate to the Integrations tab. Click the Shopify card.

2

Enter your store domain

Type your store's myshopify.com domain (e.g. yourstore.myshopify.com) and click Connect to Shopify.

3

Authorize the app in Shopify

You'll be redirected to your Shopify store's authorization screen. Review the permissions and click Install app.

Meebly requests the following permissions:

  • read_products — lets your agent search and retrieve product information
  • read_themes — used to generate the theme editor deep-link after setup

You're connected

Meebly redirects you back to the Integrations page with a Connected badge on the Shopify card. The Storefront MCP tool is automatically added to your agent and an embed token is generated for your store.

Embedding the Chat Widget

After connecting, you need to add the Meebly chat block to your Shopify theme. Click the Open Theme Editor → button on the connected Shopify card. This deep-links you directly to the Shopify theme editor with the Meebly Chat Widget block ready to place.

1

Click "Open Theme Editor →"

The button opens your Shopify theme editor. You may be prompted to confirm adding the Meebly Chat Widget app block. Click Add.

2

Save the theme

Click Save in the top-right corner of the theme editor. The widget will appear on your live storefront immediately.

The widget is a floating chat bubble fixed to the bottom-right of your storefront. Customers click it to open the chat panel and talk to your agent. No page reload required.

Customizing the Widget

Click Customize Widget on the connected Shopify card to open the widget settings. Changes are reflected on your storefront immediately after saving.

Appearance

  • • Theme preset (light / dark / custom)
  • • Primary color
  • • Background color
  • • Border color & radius

Content

  • • Widget title
  • • Welcome message
  • • Show / hide header
  • • Show / hide conversation timeline
Customer identity: Enable the Pass customer identity toggle to forward logged-in Shopify customer IDs to your agent. When enabled, returning customers are recognized across sessions for personalized recommendations. Guest shoppers are always anonymous regardless of this setting.

Storefront MCP Tool

When you connect your Shopify store, Meebly automatically adds a Shopify Storefront MCP tool to your agent. This tool gives your agent access to the Shopify Storefront API, enabling it to:

  • Search and retrieve product information and availability
  • Create and update customer carts
  • Look up store policies (shipping, returns, etc.)
  • Generate checkout links

The tool is pre-configured with your store's Storefront API endpoint. You can view it in the Tools tab of your agent — no additional setup required.

Limitations

  • OS 2.0 themes only — the Theme App Extension requires an Online Store 2.0 compatible theme. Vintage themes (Debut, Brooklyn, etc.) are not supported.
  • One store per agent — each agent can be connected to one Shopify store at a time. Different agents can connect to different stores.
  • Storefront API only — the MCP tool uses Shopify's public Storefront API. Admin-only operations (editing orders, managing inventory) are not available through this integration.
  • Widget requires theme block placement — the chat bubble only appears after you add the Meebly block in the Shopify theme editor and save.

Troubleshooting

"Open Theme Editor" button not showing

  • ✓ This button appears only after a successful OAuth connection — try disconnecting and reconnecting
  • ✓ Your store must have at least one published theme for the deep-link to be generated

Theme editor shows "chat-widget not added" error

  • ✓ Your theme may not be OS 2.0 compatible — switch to a supported theme (Dawn, Sense, Craft, etc.) and try again
  • ✓ Try opening the Theme Editor manually (Shopify Admin → Online Store → Themes → Customize) and add the Meebly Chat Widget app block from the App blocks section

Widget not appearing on storefront

  • ✓ Make sure you clicked Save in the Shopify theme editor after adding the block
  • ✓ Check that the Meebly Chat Widget block is visible and not hidden in the theme editor's section list
  • ✓ Hard-refresh your storefront (Cmd+Shift+R / Ctrl+Shift+R) to bypass the browser cache

Need Help?

Contact support at founders@meebly.ai. Include your environment ID and a description of the issue.

Last updated: March 2026Report an issue