> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trilo.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Integration

> Connect Shopify to your Trilo workspace for AI-powered store management

Connect Shopify to Trilo and let AI coworkers help with your e-commerce operations. They can check orders, manage inventory, track products, and help your team stay on top of store activity.

## What AI Can Do with Shopify

Once connected, AI coworkers can:

| Capability          | Example Use                                                    |
| ------------------- | -------------------------------------------------------------- |
| **Check orders**    | "How many orders came in today?"                               |
| **Order details**   | "What's the status of order #1234?"                            |
| **Track inventory** | "Which products are low in stock?"                             |
| **Product info**    | "What's the price of the blue t-shirt?"                        |
| **Customer lookup** | "Find orders from [john@example.com](mailto:john@example.com)" |
| **Sales reports**   | "What were our top sellers this week?"                         |

## Prerequisites

* Shopify store with admin access
* Trilo workspace admin (or integration permissions)

## Connecting Shopify

<Steps>
  <Step title="Open Workspace Settings">
    Click **Settings** in the Trilo sidebar.
  </Step>

  <Step title="Go to Integrations">
    Select the **Integrations** section.
  </Step>

  <Step title="Find Shopify">
    In workspace integrations, find **Shopify** and click **Connect**.
  </Step>

  <Step title="Enter Store URL">
    Enter your Shopify store URL (e.g., yourstore.myshopify.com).
  </Step>

  <Step title="Install App">
    You'll be redirected to Shopify. Click **Install app**.
  </Step>

  <Step title="Grant Permissions">
    Review the permissions and click **Install**.
  </Step>
</Steps>

## Configuring Store Access

### Project-Level Setup

<Steps>
  <Step title="Open a Project">
    Navigate to the project that needs Shopify access (e.g., "E-commerce Ops").
  </Step>

  <Step title="Go to Project Settings">
    Click the settings icon.
  </Step>

  <Step title="Add Shopify">
    In the Integrations tab, add the Shopify integration.
  </Step>

  <Step title="Select Store">
    If you have multiple stores, choose which one this project accesses.
  </Step>
</Steps>

### Multiple Stores

If you have multiple Shopify stores:

* Connect each store separately in workspace settings
* Assign different stores to different projects
* AI knows which store to query based on project context

## Using Shopify with AI Coworkers

### In Project Chat

Ask AI about your store in any project with Shopify access:

```
You: How many orders did we get today?
AI: You received 47 orders today totaling $3,842.
    - 32 orders shipped
    - 12 orders processing
    - 3 orders pending payment

You: Any orders over $200?
AI: Yes, 5 orders over $200:
    1. Order #4521 - $342 - Sarah M. (shipped)
    2. Order #4519 - $287 - John D. (processing)
    ...

You: What's the status of order #4519?
AI: Order #4519:
    - Customer: John D.
    - Total: $287
    - Status: Processing
    - Items: 2x Blue T-Shirt, 1x Black Hoodie
    - Payment: Completed via Shopify Payments
```

### Inventory Management

```
You: Which products are running low?
AI: 3 products are below restock threshold:
    - Blue T-Shirt (S): 2 remaining
    - Black Hoodie (M): 4 remaining
    - White Cap: 1 remaining

You: Create a task to reorder Blue T-Shirts
AI: Created task "Reorder Blue T-Shirt (S) - Low Inventory"
    assigned to the current project.
```

### Sales Insights

```
You: What were our top products this week?
AI: Top 5 products by revenue this week:
    1. Black Hoodie - $2,450 (35 units)
    2. Blue T-Shirt - $1,890 (63 units)
    3. Premium Bundle - $1,200 (8 units)
    ...
```

## Permissions Explained

| Permission         | Why It's Needed                   |
| ------------------ | --------------------------------- |
| **Read orders**    | To check order status and history |
| **Read products**  | To look up product information    |
| **Read inventory** | To track stock levels             |
| **Read customers** | To look up customer orders        |

<Info>
  Trilo requests **read-only** permissions by default. AI can view store data but won't modify orders or inventory directly.
</Info>

## Best Practices

<AccordionGroup>
  <Accordion title="Create a dedicated e-commerce project">
    Set up a project specifically for store operations. Add your support and fulfillment team. This keeps store queries organized.
  </Accordion>

  <Accordion title="Use for quick lookups">
    AI is great for "what's the status of..." and "how many..." questions. For complex operations, use Shopify admin directly.
  </Accordion>

  <Accordion title="Combine with tasks">
    When AI finds issues (low inventory, pending orders), ask it to create tasks. This keeps your team accountable.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="AI can't find my orders">
    Check that:

    1. The Shopify integration is connected at the workspace level
    2. The integration is assigned to your current project
    3. You're asking about the correct store (if you have multiple)
  </Accordion>

  <Accordion title="Integration shows disconnected">
    The API credentials may have changed. Click **Reconnect** in Trilo and re-authorize in Shopify.
  </Accordion>

  <Accordion title="Data seems outdated">
    AI queries Shopify in real-time, but there might be brief delays. Try asking again or check Shopify admin directly for time-sensitive data.
  </Accordion>

  <Accordion title="Can't connect my store">
    Ensure:

    1. You're a Shopify store admin
    2. Your store allows third-party apps
    3. You're using the correct store URL format
  </Accordion>
</AccordionGroup>

## Disconnecting Shopify

<Steps>
  <Step title="Go to Settings">
    Click **Settings** → **Integrations**.
  </Step>

  <Step title="Find Shopify">
    Locate the Shopify integration.
  </Step>

  <Step title="Click Disconnect">
    Confirm the disconnection.
  </Step>
</Steps>

Also uninstall from Shopify: **Shopify Admin → Settings → Apps → Trilo → Uninstall**.

## Security Considerations

* **OAuth-based**: Uses Shopify OAuth, not API keys
* **Read-only default**: AI views data but doesn't modify it
* **Store-level access**: You control which stores are connected
* **Project-level control**: Only projects you configure can access store data

## Next Steps

<CardGroup cols={2}>
  <Card title="AI Coworkers" icon="robot" href="/ai-coworkers/overview">
    Learn more about AI capabilities.
  </Card>

  <Card title="Workflows" icon="play" href="/ai-coworkers/workflows">
    Automate store monitoring with AI workflows.
  </Card>

  <Card title="All Integrations" icon="plug" href="/settings/integrations">
    See other available integrations.
  </Card>
</CardGroup>