The Shopify integration unlocks store tools for your AI agent — order lookup, product search, customer history — and powers a separate Shopify knowledge sync that ingests your storefront content into the AI’s training data.Documentation Index
Fetch the complete documentation index at: https://docs.keloa.ai/llms.txt
Use this file to discover all available pages before exploring further.
Connect your store
The connection uses a Shopify custom app with an Admin API access token. This works on every Shopify plan and doesn’t require a public app review.Create a custom app in Shopify
Shopify admin → Settings → Apps and sales channels → Develop apps → Create an app. Name it “Keloa” (or anything you’ll recognize).
Set the API scopes
Click Configure Admin API scopes and enable:
Save. You can leave Storefront API scopes alone — Keloa doesn’t use them.
| Scope | Used for |
|---|---|
read_orders | Order lookup tool |
read_products | Product search tool + Products knowledge sync |
read_customers | Customer enrichment in the inbox |
read_online_store_pages | Pages knowledge sync |
read_content | Articles knowledge sync |
Install the app and copy the token
Click Install app. Shopify generates an Admin API access token — copy it now (you can’t see it again later).
Paste credentials into Keloa
In Keloa, sidebar → Settings → Integrations → Shopify → Connect store. Enter:
- Your shop domain (
your-store.myshopify.com) - The Admin API access token from the previous step
Store tools for the AI
After connect, these tools appear in Integrations → Tools and can be toggled on your agent:| Tool | What it does |
|---|---|
| Orders: look up | Finds an order by number + email; returns status, items, tracking |
| Products: search | Searches your live catalog by keyword |
| Products: details | Fetches variants, price, stock for a product |
| Tracking: fetch | Pulls live tracking URL for a fulfillment |
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 also sync your storefront content (pages, blog articles, products) into the AI’s training data. See the Shopify knowledge sync guide for setup. Great for “Do you have this in blue?”, “What’s your return policy?”, or “What does the About page say?”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
| Issue | Fix |
|---|---|
| ”App not found” on install | Make sure you entered the full .myshopify.com domain. |
| Token rejected on connect | Double-check the token was copied right after install (Shopify hides it after). Re-generate by Uninstall + Install the custom app. |
| Product search returns nothing | Likely a missing read_products scope. Edit the custom app scopes, re-install, paste the new token. |
| AI can’t find an order | Order lookup needs both order number and email matching the order. Make sure your system prompt asks for both. |
| Tracking tool returns empty | Order not yet fulfilled. Tracking only exists post-fulfillment. |
| Knowledge sync didn’t pick up Pages | Verify read_online_store_pages scope. For articles, you also need read_content. |