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:
- 1A Shopify store — any plan works. You need to be the store owner or have staff permissions that include app installation.
- 2An 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.
- 3Your store's myshopify.com domain — in the format
yourstore.myshopify.com. Find it in Shopify Admin → Settings → Domains.
Connecting Your Store
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.
Enter your store domain
Type your store's myshopify.com domain (e.g. yourstore.myshopify.com) and click Connect to Shopify.
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.
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.
Save the theme
Click Save in the top-right corner of the theme editor. The widget will appear on your live storefront immediately.
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
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.