Skip to main content

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 9 native Sidekick app tools, allowing Sidekick to securely query your real-time chat analytics, journey funnels, and store knowledge gaps 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?"

Configuration & Settings

  • "How is our ShopGuide chat widget currently configured?"
  • "Where do I change the greeting message or primary chat color?"

The 9 Native Sidekick App Tools

ShopGuide provides Sidekick with specialized, secure tool endpoints:

Tool NameCapabilityBest Question Examples
get_chat_analyticsHeadline performance metrics: interaction volume, total chat sessions, unique visitors."How many customers chatted with ShopGuide in the last 14 days?"
get_chat_revenue_impactAttributed revenue, total orders, Average Order Value (AOV), and top converting products."What was our chat-attributed revenue this month?"
get_shopping_funnelPath Explorer funnel snapshot: sessions, add-to-cart rates, and purchase rates."Show me our store's add-to-cart and checkout funnel."
get_path_insightsComprehensive journey intelligence: conversion lift comparison and session reconciliation with Shopify Analytics."Does chat improve our conversion rate?"
list_knowledge_gapsRanked list of questions the AI couldn't resolve, sorted by customer frequency."What are our biggest customer support knowledge gaps?"
get_appearance_settingsCurrent visual theme: colors, bubble positioning, container dimensions, and layout toggles."What colors are we using for our chat assistant?"
get_chat_behavior_settingsAI behavioral rules: custom instructions, language, free-shipping threshold, and proactive launch messages."What is our AI's current system prompt and rules?"
get_integration_settingsConnectivity status for reviews, loyalty, email, and live support platforms."Is our Klaviyo or Smile.io integration connected?"
get_account_settingsPlan status, billing quotas, visitor limits, and storefront toggle state."How many visitor sessions do we have left on our plan?"

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:

  1. Read the current value using get_appearance_settings.
  2. Direct you to the exact settings tab inside ShopGuide (e.g., ShopGuide → Appearance → Primary Color).
  3. Provide the exact steps needed to apply the change.

Enabling Sidekick Access

To allow Shopify Sidekick to query ShopGuide on your behalf:

  1. In Shopify Admin, open ShopGuide → Settings → AI Behavior.
  2. Locate the Sidekick Access Level control.
  3. Choose your preferred permission:
    • Full Control / Read-only (Recommended): Allows Sidekick to read performance analytics, funnel stats, and knowledge gaps to answer your questions.
    • Off: Completely disables the integration.
  4. Save your settings.