Skip to main content
The Shopify integration does two things:
  1. Lets you embed the widget on your storefront (like webchat, but pre-configured).
  2. Unlocks store tools for your AI agent — look up orders, search products, fetch tracking, answer pre-sales questions from live product data.

​
Install the Shopify app

1

Start the install

Sidebar → Integrations → Shopify → Connect → enter your *.myshopify.com domain.Keloa redirects you to Shopify’s app install page.
2

Authorize

Review the permissions Keloa needs — read orders, products, customers, write app-block on storefront. Click Install.
3

Return to Keloa

Shopify redirects back. Your store is now connected.
4

Add the chat block to your theme (optional)

In your Shopify admin → Online Store → Themes → Customize → + Add block → Keloa chat. Saves you pasting the widget snippet into theme.liquid.

​
Store tools for the AI

After connect, these tools appear in Integrations → Tools and can be toggled on your agent:
ToolWhat it does
Orders: look upFinds an order by number + email; returns status, items, tracking
Products: searchSearches your live catalog by keyword
Products: detailsFetches variants, price, stock for a product
Tracking: fetchPulls live tracking URL for a fulfillment
Enable them per-agent in AI agents → edit → Tools.

​
Example conversation

Customer: “Where is my order? It’s #1234 and my email is jane@example.com.” AI → calls Orders: look up → “Your order #1234 shipped yesterday via PostNL. Tracking says it’s out for delivery today. Here’s the live link: …”
All of this runs inside the same conversation — the customer never sees a form or a hop.

​
Knowledge from catalog (optional)

For pre-sales questions, you can add a Shopify catalog knowledge source:
  • Sidebar → Knowledge → New source → Shopify catalog.
  • Picks products from your connected store and indexes title, description, variants.
  • Refreshed daily.
Great for “Do you have this in blue?” or “What’s the price range for X?”

​
What we don’t touch

  • We don’t modify orders or products. Tools are read-only.
  • We don’t access payment data.
  • We don’t write to customer accounts.

​
Uninstalling

Integrations → Shopify → Disconnect, or from Shopify admin → Apps → Keloa → Uninstall. Both revoke the API token and stop webhooks. Historical conversations stay in Keloa — only live tools and webhooks are severed.

​
Troubleshooting

IssueFix
”App not found” on installMake sure you entered the full .myshopify.com domain.
AI can’t find an orderOrder lookup needs both order number and email matching the order. Make sure your system prompt asks for both.
Tracking tool returns emptyOrder not yet fulfilled. Tracking only exists post-fulfillment.
Chat block not in theme editorSome themes cache the block list. Remove and re-add the app, or re-save the theme.