> ## 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.

# Shopify

> Route Shopify storefront chat into the Keloa inbox.

<Tip>
  Track availability on the [Keloa roadmap](https://keloa.ai/roadmap).
</Tip>

<Note>
  **Coming soon.** Shopify-as-a-channel — receiving inbound storefront chat into Keloa — is not yet shipped. The flow below describes the planned setup.
</Note>

<Info>
  Looking for product catalog ingestion or order/product lookup tools? That's the **Shopify integration**, which is live today. See the [Shopify knowledge source](/knowledge/shopify) for catalog sync and the Shopify integration in **Settings → Integrations** for order, product, and tracking tools your AI agent can call.
</Info>

This page covers the planned **Shopify channel** — meaning inbound chat conversations from your Shopify storefront flowing into the Keloa inbox alongside email and the web widget. For Shopify as an AI tool source (orders, products, tracking) or as a knowledge source (storefront pages, articles, products), use the integration instead.

## Connect your store (planned flow)

The connection will use a **Shopify custom app** with an Admin API access token. This works on every Shopify plan and doesn't require a public app review.

<Steps>
  <Step title="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).
  </Step>

  <Step title="Set the API scopes">
    Click **Configure Admin API scopes** and enable:

    | 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                       |

    Save. You can leave Storefront API scopes alone — Keloa doesn't use them.
  </Step>

  <Step title="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).
  </Step>

  <Step title="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

    Keloa verifies the token by fetching shop info. On success, the integration card flips to **Connected**.
  </Step>
</Steps>

<Tip>
  The same connection will power the [Shopify knowledge sync](/knowledge/shopify) and the AI tools (orders, products, tracking) — one app, multiple surfaces.
</Tip>

## Store tools for the AI (live today via integration)

Once the Shopify integration is connected, 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                         |

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](mailto: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 (live today)

For pre-sales questions, sync your storefront content (pages, blog articles, products) into the AI's training data. See the [Shopify knowledge sync guide](/knowledge/shopify) 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`.                                                    |