Skip to main content

​
Shopify Agent Tools

These tools work internally to provide your chatbot with complete Shopify store capabilities. Your agents can search for products, check inventory, track orders, and more.
These tools operate automatically in the background. Users interact with your chatbot naturally, and the agent intelligently selects and uses these tools to provide accurate and up-to-date information about your store.

Products

Search and get detailed information about products from your store

Product

Get detailed information about a specific product

Collections

Access collections and better organize your catalog

Orders

Track and query order status

​
Products

​
getProducts

Get a list of products from the store with optional filtering. Available fields:
FieldTypeRequiredDescription
productNamestringOptionalFilter products by name
variantNamestringOptionalFilter by variant name (color, size, etc.)
productTypestringOptionalFilter by product type/category
productTagstringOptionalFilter by product tag
productVendorstringOptionalFilter by product vendor
minPricenumberOptionalMinimum price filter (default 0 if not provided)
maxPricenumberOptionalMaximum price filter (default 0 if not provided)
bringOnlyAvailablebooleanOptionalFilter to show only in-stock products (default false)

Usage examples

  • User: “What t-shirts do you have available?”
    • The agent uses: getProducts with productName: "t-shirt" and bringOnlyAvailable: true
  • User: “Show me shoe products between 50and50 and 100”
    • The agent uses: getProducts with productType: "shoes", minPrice: 50, maxPrice: 100
  • User: “Do you have blue shirts?”
    • The agent uses: getProducts with productName: "shirt" and variantName: "blue"

​
getProduct

Get detailed information about a specific product. Available fields:
FieldTypeRequiredDescription
productIdstringRequiredShopify product ID in format “gid://shopify/Product/1234567890”

Usage example

  • User: “Show me the details of product 1234567890”
    • The agent uses: getProduct with productId: "gid://shopify/Product/1234567890"

​
Collections

​
getCollections

Get a list of collections from the store. Available fields:
FieldTypeRequiredDescription
collectionNamestringOptionalFilter collections by name

Usage examples

  • User: “What collections do you have?”
    • The agent uses: getCollections without filters to list all collections
  • User: “Show me the summer collection”
    • The agent uses: getCollections with collectionName: "summer"

​
getCollection

Get detailed information about a specific collection. Available fields:
FieldTypeRequiredDescription
collectionIdstringRequiredShopify collection ID in format “gid://shopify/Collection/1234567890”

Usage example

  • User: “Show me the details of collection 1234567890”
    • The agent uses: getCollection with collectionId: "gid://shopify/Collection/1234567890"

​
Orders

​
getTrackingInfo

Get tracking/status information for a specific order. Available fields:
FieldTypeRequiredDescription
orderIdstringRequiredOrder ID (e.g., “#1001”, “EN1001”, or “1001-A”)
emailstringRequiredCustomer email for order verification

Usage example

  • User: “What’s the status of my order #1001?”
The agent can handle different order ID formats. It accepts simple numbers, codes with prefixes like ”#” or “EN”, and formats with suffixes like “1001-A”.

​
Next Steps

Abandoned Carts

Learn how to configure and manage abandoned carts in your Shopify integration.