Shopify

Managed auth required

Product search on Shopify storefronts

BotChap adds a chat-style product search widget to your Shopify store. When a visitor types a query, BotChap searches your product catalog via Shopify's Admin GraphQL API and returns the top three matching products — including title, description, and price.

This is a product search widget — not a general AI chat. The visitor's message is used as a Shopify product search query. BotChap does not use an AI model or LLM in this integration.
BotChap returns up to 3 matching products per query with title, description, and price. For a full AI shopping assistant, use the n8n or Custom REST integration with your own AI backend.
This integration requires a Shopify Admin API access token with the read_products permission. The token is stored on the BotChap server and is never sent to the browser.

Why use this integration

Use this integration when you want a conversational product search experience on your Shopify storefront. Visitors can type natural queries and see matching products — without needing a separate AI backend or chatbot platform.

How it works

  1. 1
    Visitor types a product query in the BotChap widget
  2. 2
    BotChap sends the query to the BotChap server proxy
  3. 3
    The server runs a Shopify Admin GraphQL product search with the visitor's query
  4. 4
    Shopify returns the top 3 matching products
  5. 5
    BotChap displays product names, descriptions, and prices in the chat window

Required fields

Shopify Store URL
Your store URL (e.g. https://your-store.myshopify.com or your custom domain).
Shopify Admin API Access Token
A private app or custom app token with read_products access. Stored on the BotChap server.

What BotChap sends

BotChap runs this Shopify Admin GraphQL query server-side:

{
  products(first: 3, query: "<visitor message>") {
    edges {
      node {
        title
        description
        priceRange {
          minVariantPrice { amount currencyCode }
        }
      }
    }
  }
}

Sample request

POST https://your-store.myshopify.com/admin/api/2024-01/graphql.json
X-Shopify-Access-Token: <your-token>
Content-Type: application/json

{
  "query": "{ products(first:3,query:\"blue jacket\"){edges{node{title description priceRange{minVariantPrice{amount currencyCode}}}}}}"
}

Sample response

# BotChap formats and returns:
"**Blue Denim Jacket**
A classic denim jacket in washed blue.
Price: 89.00 USD

**Blue Bomber Jacket**
Lightweight bomber in cobalt blue.
Price: 65.00 USD"

Best use cases

  • Product search on Shopify product pages
  • Quick catalog lookup for support chats
  • Shop assistant for gift finding and browsing

Frequently asked questions

Does this use AI to answer questions?
No. BotChap sends the visitor's message directly as a Shopify product search query and returns matching products. There is no LLM involved.
Can I build a full AI shopping assistant?
Yes — but use the n8n or Custom REST integration. Connect BotChap to an n8n workflow that calls Shopify and an LLM together.
What Shopify API permissions are needed?
Your access token needs the read_products permission. No other scopes are required.
Can I embed this on a Shopify theme?
Yes. Add the BotChap script tag to your theme's layout.liquid file (or use a custom HTML block) and it will appear on all store pages.

Related integrations

n8n
Workflow automations and AI agents
Custom REST API
Any HTTP endpoint

Ready to connect Shopify to BotChap?

Create a free widget, configure the integration, and embed it on your site in minutes.

View all integrations