Chat Squeeze
Blog

First Time Using Chat Squeeze: From Shopify Install to Sales Insights

Welcome to Chat Squeeze. This guide walks you through the first setup of your Shopify AI sales assistant: connecting your store, syncing products, importing store knowledge, customizing the chat widget, turning it live, and using the dashboard to review conversations, leads, and AI-attributed sales.

Setup Guide12 min read

Chat Squeeze is a Shopify AI sales assistant that learns a store's products and policies, answers shopper questions in chat, recommends products, captures leads, and shows you which conversations and sales came from the AI assistant.

Some setup happens automatically after Shopify installation. Other steps are controlled by you so the assistant matches your store's brand, policies, and selling style. Use this guide when you are installing Chat Squeeze for the first time or checking that your store is ready before sending live traffic to the assistant.

What is the quick setup checklist?

The first-time setup path starts with Shopify installation and ends with dashboard review. Move through these steps in order, then use Chat history, Collected leads, and Sales & analytics to improve the assistant from real shopper behavior.

  • Install Chat Squeeze from the Shopify App Store and open the app.
  • Click Set up my agent. Chat Squeeze starts learning your products and reading your store pages.
  • On Learning your store, check the pages it reads and add any that are missing.
  • On How it looks, check the agent name, language, welcome message, quick starts and colors.
  • Ask a few test questions on Try your agent.
  • Start 14 days free on a paid plan, or click Not now to stay on Playground.
  • Turn the chat on in Shopify's theme editor.
  • Set up proactive popups, and lead capture on Pro or higher.
  • Review Chat history, Collected leads, and Sales & analytics after shoppers use the chat.

What setup does Chat Squeeze handle automatically?

After the Shopify app is installed and opened, Chat Squeeze handles the technical setup in the background. This lets you focus on brand, policies, and selling style instead of data plumbing.

  • Creates the account and workspace needed for your dashboard.
  • Connects your Shopify store to Chat Squeeze and creates your AI agent.
  • Starts your first Shopify product sync.
  • Keeps product data up to date in real time on paid plans. On Playground, you click Resync to bring in changes.
  • Detects your store name and, when available, your store language.
  • Reads your store pages, such as shipping and returns, so the agent can answer from them.
  • Writes a first welcome message, quick start messages and instructions with AI, in your store's language.
  • Turns on the Generic popup for product pages and collection pages.
  • Tracks shopper conversations after the chat is live.
  • Tracks product card actions such as add to cart and view on store.
  • Records leads after a shopper submits a lead form.
  • Credits a sale to the chat when a shopper who chatted, opened a product from the chat or added one from the chat places a Shopify order.

What do you still control manually?

You still make the business decisions. You decide how the assistant sounds, what extra store knowledge it should know, which plan fits your store, when the widget appears on the storefront, and how leads and analytics are reviewed.

  • Check or edit your agent name, store language, welcome message, quick starts and colors.
  • Add store pages, text, or TXT and CSV files for anything product sync doesn't cover.
  • Read the instructions setup wrote for you in General settings, and edit them.
  • Pick a plan and approve it on Shopify, or stay on Playground.
  • Switch on the Chat Squeeze app embed in Shopify's theme editor.
  • On Pro or higher, set up lead capture forms, lead emails and Zapier or Make.
  • Adjust product card buttons, order tracking and proactive popup messages.
  • Review your conversations, leads, and sales in the dashboard.

How does first-time onboarding work?

Onboarding prepares the assistant, imports the most important store context, and gets you ready to test before going live. The product catalog is handled first because product knowledge powers recommendations, product cards, and product questions in chat.

Welcome: Set up my agent

What you see:

  • A welcome screen: "Your AI sales agent for" and your store name.
  • What setup does: learns your products, reads your store pages, lets you pick how it looks, and starts 14 days free.

What Chat Squeeze handles for you:

  • Your store is already connected through the Shopify install.
  • Product sync and page reading start in the background.

What you do:

  • Click Set up my agent.

Step 1 of 3: Learning your store

What you see:

  • The number of products the agent knows, while products sync.
  • The store pages the agent reads, each marked Reading until it's ready, or Couldn't read if it failed.
  • Add a page, for a page address that isn't listed.
  • More pages in your store: other Shopify pages you can add with one tap.

What Chat Squeeze handles for you:

  • Products sync from Shopify, and the sync keeps going in the background.
  • Chat Squeeze picks store pages to read and starts reading them.

What you do:

  • Check that your shipping, returns and other key pages are on the list.
  • Add any missing page from More pages in your store, or paste its address under Add a page.
  • Continue. Sync and reading keep going while you finish setup.

Step 2 of 3: How it looks

What you see:

  • Agent name, Language, Welcome message and Quick start messages.
  • Ready color themes and color fields.
  • A live chat preview.

What Chat Squeeze handles for you:

  • The store language comes from Shopify when available.
  • AI writes the welcome message and quick start messages in your store's language. The fields say Writing until they are ready.
  • AI writes the agent's instructions in the background, from your products and store pages.

What you do:

  • Edit the agent name if needed.
  • Check the language your agent should speak.
  • Edit the welcome message and quick start messages.
  • Pick a color theme or your own colors, then click Save and continue.

Try your agent

What you see:

  • Your store's chat, ready for test questions. It answers from your products and your store pages.

What Chat Squeeze handles for you:

  • The chat uses the settings you just saved.

What you do:

  • Ask a question a real shopper would ask, about a product, shipping or returns.
  • Go back to How it looks to change something, or continue.

Step 3 of 3: 14 days free

What you see:

  • A plan picked for your store's product count, with Pick a plan to see the others.
  • Start 14 days free, and a Not now link.

What Chat Squeeze handles for you:

  • Billing is handled through Shopify. Nothing is billed today.
  • After you approve on Shopify's page, Chat Squeeze updates your plan and finishes setup.

What you do:

  • Click Start 14 days free and approve on Shopify's page.
  • Or click Not now to stay on Playground, the free plan.

How do you turn Chat Squeeze live on the Shopify store?

After setup, the agent is ready, but shoppers don't see it yet. Setup doesn't turn the chat on. The status next to your store name, at the top of every dashboard page, shows whether it's on: Live, Off · Turn on, Needs attention · Fix, Couldn't check · Check, or Checking for a moment while it looks.

  1. Click the status next to your store name. After setup it says Off · Turn on.
  2. Click Turn on in Shopify. Shopify's theme editor opens with Chat Squeeze picked under App embeds.
  3. Switch Chat Squeeze on.
  4. Click Save in Shopify.
  5. Come back to the Chat Squeeze tab. The status changes to Live.

How should you import store knowledge?

Products sync from Shopify automatically, but policies and FAQs need your review. Use Knowledge base for everything your products do not say: shipping rules, return windows, sizing guidance, warranty details, contact details, and store-specific FAQs.

  • Products: synced from Shopify automatically. If product answers look out of date, click Resync in the Products section of Knowledge base.
  • Pages: add shipping, returns, FAQ, About, Contact, sizing, warranty, and policy pages from Pages on your store, or paste any page link.
  • Files or text: upload a TXT or CSV file, or add text, typed or read from an image such as a size chart, when the information does not live on a store page.

What can you review in the dashboard?

The dashboard is where setup turns into operational feedback. Use each area for a specific job: configure the assistant, test it, activate it, and learn from the conversations, leads, and sales it influences.

Overview

Use it for: Your home screen, to see at a glance whether the agent is working over the last 30 days.

  • Sales from chat, Orders, Added to cart, and Left their details on plans with lead capture.
  • Chats per day, with orange bars on days with a sale.
  • Recent conversations, Recent sales from chat, and Recently left details, with links to Chat history, Sales & analytics, and Collected leads.

Chat Squeeze handles: Numbers come from chats, cart adds, leads, and Shopify orders credited to the chat.

Your next step: Open a row for the details. Overview always covers the last 30 days and shows sales credited to the chat, not total Shopify revenue. Conversion is on Sales & analytics.

Knowledge base

Use it for: Use this for the non-product knowledge your AI needs: shipping, returns, sizing, warranties, FAQs, brand details, contact details, and special store policies.

  • Add a store page from Pages on your store, or paste any page link.
  • Add text, typed or read from an image such as a size chart.
  • Upload a TXT or CSV file.
  • The Products section: how many products the agent knows, the sync state, and Resync.

Chat Squeeze handles: Your Shopify products sync separately from your sources. Each source says Reading until it is ready, or Couldn't read if it failed.

Your next step: Add or update your policy and FAQ sources, wait until they stop saying Reading, click Teach again after a page changes, and click Resync in the Products section when product answers look out of date.

General settings

Use it for: Use this to set what the store chat says and how it looks, and to try the chat in the preview beside the settings.

  • Store name, Message box hint, Welcome message, Quick start messages, and Line on product pages.
  • Store language and Right to left.
  • Instructions, with Generate with AI.
  • Colors: ready themes, or your own Primary and Background colors.
  • A live chat preview with your unsaved settings.

Chat Squeeze handles: Setup writes the first welcome message, quick starts, and instructions with AI. Generate with AI can write new instructions up to 3 times in 24 hours.

Your next step: Save your changes, test in the preview, and keep long FAQ libraries in Knowledge base rather than Instructions. The chat button's position and size are set in Shopify's theme editor.

Interactive elements

Use it for: Use this to control product card buttons and order tracking inside the shopper chat.

  • Currency symbol.
  • View on store, Add to cart, and View collection, each with a switch and its own text.
  • Order tracking in chat, and whether shoppers track on your tracking page or in a form in the chat.
  • Tracking page link, title, button text, and form wording.

Chat Squeeze handles: Product cards use your synced Shopify product data.

Your next step: Choose which card buttons to show, turn on Order tracking in chat (it saves right away), and add your tracking page link if shoppers track there.

Lead capture

Use it for: On Pro, Premium and Ultra, use this to let the agent show a form when a chat matches it, such as a shopper asking for a person, a quote, or wholesale prices.

  • Collect shoppers' details, the main switch for every form.
  • Up to 5 forms of your own, plus the built-in Talk to Human form.
  • Each form's When to show it, heading, fields, agree checkbox, button text, and thank-you message.
  • Where leads go: Email me new leads, for up to 5 people, and on to Zapier or Make if you connect them.

Chat Squeeze handles: The agent shows a form only when a chat matches its When to show it. Each lead lands in Collected leads, and goes to your lead emails and to Zapier or Make when you set them.

Your next step: Turn on Collect shoppers' details and at least one form, write a clear When to show it, click Save, and follow up with leads yourself or through your Zapier or Make workflow.

Proactive popups

Use it for: Use these to invite shoppers into chat before they open it themselves.

  • Which popup runs: Generic or Smart timing. One runs at a time.
  • Generic: the Show popups switch, then Other pages, Product pages, and Collection pages, each with its own message, button, and wait.
  • Smart timing, on Pro, Premium and Ultra: four situations, Comparing, Shopping around, Can't find it, and Still browsing, each with its own switch, message, and button.
  • Hide if ignored: up to 30 seconds, or Off.

Chat Squeeze handles: With Generic, the Product pages or Collection pages popup shows on those pages, and Other pages covers the rest. Smart timing picks its moment from how the shopper browses. A shopper sees at most one popup of any kind in 24 hours.

Your next step: Pick a popup mode, write short helpful messages, click Save, and test in a new private or incognito window because of the 24-hour rule.

Store status

Use it for: Use this to check whether shoppers see the chat. It sits at the top of every dashboard page, next to your store name.

  • Live, Off · Turn on, Needs attention · Fix, or Couldn't check · Check.
  • Click it for a dialog that shows the app embed's state and the one fix.

Chat Squeeze handles: Chat Squeeze asks Shopify about the app embed each time the dialog opens and when you come back to the app.

Your next step: If it says Off, click Turn on in Shopify, switch on Chat Squeeze in the theme editor, and click Save in Shopify. To test answers before going live, use the preview in General settings.

Chat history

Use it for: Use this to review shopper conversations with your AI agent.

  • Read every chat as the shopper saw it, with product cards, forms, and order tracking.
  • Search chats for words in any message.
  • Show: All chats, Bought, Added to cart, or Left details. When: Any time, Today, Last 7 days, Last 30 days, or Pick dates.
  • What happened beside each chat: what the shopper bought, added to cart, or left as details, and the pages they looked at.

Chat Squeeze handles: Chats appear once shoppers use the chat, and each one shows how it ended.

Your next step: Read chats, use wrong or incomplete answers as a signal to update Knowledge base or Instructions, and set Show and When back to all if a chat seems to be missing.

Collected leads

Use it for: Use this to review contacts captured by lead forms in chat.

  • Each lead's name, email, phone, and form answers.
  • Search leads, and filter by Form and When.
  • The chat each lead came from, with Open chat.
  • Click the email or phone to follow up.

Chat Squeeze handles: Leads appear after a shopper submits a form, and the fields follow the form you built in Lead capture.

Your next step: Set up Lead capture first, follow up with each lead, and check your lead emails and your Zapier or Make runs separately.

Sales & analytics

Use it for: Use this to see how Chat Squeeze contributes to your Shopify sales.

  • Sales from chat, Orders, Added to cart, and Conversion.
  • Sales per day and the order list, with search and a Source choice.
  • Where sales came from: Product page chat, Chat on other pages, View on store, Added in the chat, and From the popup.
  • Top products, and a When choice: Last 7, 30 or 90 days, or All time.

Chat Squeeze handles: A sale is credited when a shopper who chatted, opened a product from the chat, or added one from the chat places a Shopify order.

Your next step: Pick a period, compare sources, and remember this is revenue credited to the chat, not total Shopify store revenue.

Billing

Use it for: Use this to see your plan, start or switch a plan, apply a coupon, or cancel. Open it from Upgrade at the top right.

  • Your plan and what happens next, such as a trial with the days left.
  • Plan cards with the price, how many of your products fit, messages a month, and ticks for Lead capture, Smart timing, and Priority support.
  • Have a coupon? and Cancel plan.

Chat Squeeze handles: Shopify bills every plan in USD every 30 days, and no change happens until you approve it on Shopify's page.

Your next step: Pick a plan, approve it on Shopify, and upgrade when you need more products, more messages, real-time product sync, lead capture, or Smart timing.

How should you read pricing during setup?

Playground is free and includes up to 2,000 products with manual sync and 50 AI messages in total. Paid Shopify plans start with Starter at $22.99/month, followed by Growth at $45.99/month, Pro at $89.99/month, and Premium at $169.99/month. Ultra is $299.99/month for stores that need 3,000 products and 8,000 AI messages a month. Lead capture and Smart timing start on Pro. Paid plans include a 14-day free trial, and Shopify bills in USD every 30 days.

Open Billing from Upgrade at the top right to review your plan, messages used, and how many of your products each plan fits. Upgrade when your store needs higher product limits, higher message limits, real-time product sync, lead capture, or Smart timing.

How do you learn from real shopper activity?

Once the widget is live, real conversations become your improvement loop. Read Chat history to spot missing knowledge, use Collected leads to follow up with captured contacts, and use Sales & analytics to understand revenue, orders, add to cart, view on store, conversion, and product performance attributed to Chat Squeeze.

If an answer is weak, update Knowledge base for missing facts or General settings > Instructions for tone and behavior. If leads are empty, confirm your plan includes lead capture, Collect shoppers' details is on, at least one form is on, and shoppers are submitting it. If sales numbers differ from Shopify Admin, remember that Chat Squeeze shows sales credited to the chat rather than total store revenue.

Automatic vs manual summary

Automatic

  • Shopify connection.
  • AI agent creation.
  • Product sync.
  • Store page reading.
  • First welcome message, quick starts, and instructions.
  • Conversation tracking.
  • Lead records after form submission.
  • Sales credited to the chat.

Manual

  • Brand customization.
  • Knowledge imports beyond product catalog.
  • Plan selection and Shopify billing approval.
  • Turning on the app embed in the theme editor.
  • Proactive popup choice and messages.
  • Lead capture setup, on Pro or higher.
  • Reviewing conversations, leads, and analytics.

FAQ

Is product sync automatic?
Yes. Chat Squeeze starts syncing your Shopify products during setup. Paid plans keep products up to date in real time. Playground includes up to 2,000 products with manual sync and 50 messages in total, so you click Resync in the Products section of Knowledge base to bring in changes.
Are policies and FAQs automatic too?
Partly. Setup reads your store pages, but check that the important ones are on the list. For missing policies or FAQs, add a store page or link, upload a TXT or CSV file, or add text in Knowledge base.
Do I need to edit my Shopify theme code?
No. Switch on the Chat Squeeze app embed in Shopify's theme editor and click Save. Normal setup does not require theme code changes.
Why do sales numbers differ from Shopify Admin?
Sales & analytics shows orders credited to the chat, not total Shopify store revenue.
Why are leads empty?
Lead capture is on Pro, Premium and Ultra. Leads appear only after Collect shoppers' details is on, at least one form is on, and a shopper submits a form.
Where do I fix bad answers?
Use Knowledge base for missing policies, FAQs, sizing, returns, shipping, or brand information. Use General settings > Instructions for tone and behavior guidance.