Shopify Sidekick AI Integration
As a Shopify merchant, you shouldn't have to navigate through multiple tabs and submenus just to ask simple operational questions about your store.
ShopGuide natively integrates with Shopify Sidekick—Shopify's conversational AI assistant built directly into your Shopify Admin. ShopGuide registers 19 native Sidekick app tools, allowing Sidekick to securely query your chat analytics, revenue impact, shopping funnel, knowledge gaps, shopper segments, product interest, repeat purchases, individual customers, visit journeys and drop-off pages whenever you ask.
What You Can Ask Sidekick
When Sidekick is enabled on your store, you can ask questions in plain English (or your store's native language) without opening the ShopGuide app:
Performance & Revenue
- "How much revenue did ShopGuide assist this week?"
- "Is our AI chat assistant actually lifting our store conversion rate?"
- "What are the top 5 products customers are buying after chatting with ShopGuide?"
Knowledge Gaps & Unanswered Questions
- "What questions are shoppers asking that ShopGuide couldn't answer?"
- "Are there any recurring product questions we should add to our FAQ?"
Customer Journey Funnel
- "Where are customers dropping off in our shopping funnel?"
- "How does our add-to-cart rate compare between chat users and non-chat users?"
Shoppers & Products
- "Who are my shoppers, and how many of them come back?"
- "Which products get looked at a lot but rarely added to the cart?"
- "Who is due to reorder?"
Journeys & Drop-off
- "What are the most common paths to purchase?"
- "On which pages do visits end without a purchase?"
- "Which landing pages convert best?"
Configuration & Settings
- "How is our ShopGuide chat widget currently configured?"
- "Where do I change the greeting message or primary chat color?"
The 19 Native Sidekick App Tools
ShopGuide provides Sidekick with specialized, secure tool endpoints.
Chat & store performance
| Tool Name | Capability | Best Question Examples |
|---|---|---|
get_chat_analytics | Headline performance metrics: interaction volume, total chat sessions, unique visitors. | "How many customers chatted with ShopGuide in the last 14 days?" |
get_chat_revenue_impact | Attributed revenue, total orders, Average Order Value (AOV), and top converting products. | "What was our chat-attributed revenue this month?" |
get_shopping_funnel | Path Explorer funnel snapshot: sessions, add-to-cart rates, and purchase rates. | "Show me our store's add-to-cart and checkout funnel." |
get_path_insights | Comprehensive journey intelligence: conversion lift comparison and session reconciliation with Shopify Analytics. | "Does chat improve our conversion rate?" |
list_knowledge_gaps | Ranked list of questions the AI couldn't resolve, sorted by customer frequency. | "What are our biggest customer support knowledge gaps?" |
get_appearance_settings | Current visual theme: colors, bubble positioning, container dimensions, and layout toggles. | "What colors are we using for our chat assistant?" |
get_chat_behavior_settings | AI behavioral rules: custom instructions, language, free-shipping threshold, and proactive launch messages. | "What is our AI's current system prompt and rules?" |
get_integration_settings | Connectivity status for reviews, loyalty, email, and live support platforms. | "Is our Klaviyo or Smile.io integration connected?" |
get_account_settings | Plan status, billing quotas, visitor limits, and storefront toggle state. | "How many visitor sessions do we have left on our plan?" |
Shoppers & Path Explorer
| Tool Name | Capability | Best Question Examples |
|---|---|---|
get_shopper_segments | Visitors by stage (browser, researcher, intent, buyer), returning rate, chat usage, and device, channel and language mix. | "Who are my shoppers?" |
get_product_interest | Most viewed products, products viewed but rarely added to the cart, and best view-to-cart products. | "Which products get looked at but not added to cart?" |
get_related_products | For one product, the products viewed together with it and bought together with it. | "What do people buy with this product?" |
get_repeat_purchases | Repeat-customer rate, typical days between orders, reordered products, and customers due to reorder. | "Who is due to reorder?" |
get_customer_insights | One customer (by customer ID or email): visits, browsing, chat summary and orders. | "What do we know about customer X?" |
get_shopper_questions | What shoppers ask the chat, grouped by theme, resolved versus unresolved. | "What do shoppers ask most?" |
get_top_journeys | The most common visit paths and the paths that lead to purchase. | "What are the most common paths to purchase?" |
get_page_dropoff | Pages where visits end without a purchase. | "Where do visits end?" |
get_page_flow | For one page, the pages viewed right before and right after it. | "Where do people go after the cart page?" |
get_landing_pages | Top, best converting and highest-bounce entry pages. | "Which landing pages convert best?" |
Guided Settings Assistance
Shopify currently restricts third-party app tools from directly mutating merchant settings. When you ask Sidekick to adjust a setting (e.g., "Change our chat bubble color to navy"), Sidekick will:
- Read the current value using
get_appearance_settings. - Direct you to the exact settings tab inside ShopGuide (e.g., ShopGuide → Appearance → Primary Color).
- Provide the exact steps needed to apply the change.
Enabling Sidekick Access
To allow Shopify Sidekick to query ShopGuide on your behalf:
- In Shopify Admin, open ShopGuide → Settings → AI Behavior.
- Find the Sidekick Integration block and choose one of the three options:
- Off — Sidekick cannot access ShopGuide data: Completely disables the integration.
- Read-only — Sidekick can view chat analytics and knowledge gaps (the default and recommended): Sidekick can read all the data described above.
- Full control — Sidekick can also propose changes for you to confirm: Reserved for future write capabilities. Today it behaves the same as Read-only.
- Save your settings.
This setting only affects Sidekick. It does not change your storefront chat widget.