Help Center / Integrations / Shopify

Shopify integration

Connect your Shopify store with a Dev Dashboard custom app — no install from the Shopify App Store. Each chatbot can have its own store connection under Store tools. Enter your shop domain, Client ID, and Client secret; AI Toruk connects automatically and keeps the Admin API token up to date. Bots search products, share storefront links, and look up order status when shoppers verify their details.

Requirements

• Shopify store with admin access
• Dev Dashboard custom app with read_products, read_orders, and (recommended) read_all_orders Admin API scopes
• Protected customer data enabled for Orders (email) if you use order lookup
• Professional or Agency plan (integrations feature)

Setup

1. In Shopify admin, open Settings → Apps → Develop apps → Build apps in Dev Dashboard and create an app.
2. In Dev Dashboard → Versions, enable read_products, read_orders, and read_all_orders, then Release the version.
3. Install the app on your *.myshopify.com store.
4. In Dev Dashboard → Settings, copy your Client ID and Client secret.
5. In AI Toruk, open Chatbots → [your bot] → Edit settings → Store tools.
6. Enter your *.myshopify.com domain, Client ID, and Client secret, then click Connect store and Test connection.
7. Enable Search products, Product links, and Order status (and other tools as needed) for that chatbot.
8. Set the chatbot Website URL to your live storefront (e.g. https://your-store.myshopify.com) so product links use the correct domain.

You do not need to request or paste an Admin API access token manually. AI Toruk creates and refreshes it automatically.

What the bot can do

• Search products and return titles, prices, stock, and storefront links
• Look up order status when the visitor provides order number and checkout email
• Support store-related escalations when store tools are active on that chatbot

Order lookup format

Visitors should provide the order number from their confirmation email and the email used at checkout (not necessarily the pre-chat form email):

order: #1002
email: buyer@example.com

Troubleshooting

• Connection failed — Use the *.myshopify.com domain, not a custom storefront URL, for the API connection.
• Orders not found — Confirm read_orders and read_all_orders scopes, enable Protected customer data for order email, and verify the checkout email matches.
• Wrong product URLs — Set the chatbot Website URL to your actual storefront domain.
• Widget works differently from API tests — Confirm the embed uses the correct data-chatbot key and data-api-base; use Clear chat to reset a poisoned session.
• Token expired / invalid token — Click Test connection or Connect store again. AI Toruk refreshes the token automatically when Client ID and Client secret are saved.

Security

Client ID, Client secret, and access tokens are stored encrypted and used only for server-side Admin API calls — never exposed in the widget. AI Toruk refreshes access tokens automatically. Use read-only scopes and revoke the custom app in Shopify if you disconnect.