# Shopify

> Connect Shopify so your agent can look up orders, search products, process returns, and help customers with their purchases.

## What you can do

* Look up customer order history and tracking information
* Search and browse your product catalog
* Process returns, refunds, and cancellations
* Generate visual product carousels in chat
* Check product inventory and variant details

## Connecting Shopify

### OAuth (recommended)

Install eesel AI from the Shopify App Store.

1. Go to **Integrations > Shopify**
2. Select **Install Marketplace App**
3. Follow the Shopify installation flow
4. Authorize eesel AI to access your store data

### Access token

Connect with a Shopify Admin API access token.

1. Go to **Integrations > Shopify**
2. Select **Credentials**
3. Enter your shop name and Admin API access token
4. Click **Connect**

## Actions

### Customer and order lookup

| Action                    | Description                                     |
| ------------------------- | ----------------------------------------------- |
| **Get Customer by Email** | Look up customer profile and details            |
| **Get Order History**     | Retrieve a customer's order history by email    |
| **Get Order by ID**       | Get detailed information about a specific order |
| **Get Order Fulfillment** | Check shipping status and tracking information  |

### Product information

| Action                        | Description                                              |
| ----------------------------- | -------------------------------------------------------- |
| **Search Products**           | Search your product catalog by query                     |
| **Get Products**              | Retrieve all products in your store                      |
| **Get Product Variants**      | Get variant details (size, color, SKU, price, inventory) |
| **Get Product Metafields**    | Get custom product metadata                              |
| **Get Variant Metafields**    | Get custom variant metadata                              |
| **Generate Product Carousel** | Create a visual product display in chat                  |

### Order management

| Action            | Description                 |
| ----------------- | --------------------------- |
| **Create Return** | Initiate a product return   |
| **Refund Order**  | Process a refund            |
| **Cancel Order**  | Cancel an unfulfilled order |

## Common scenarios

**"Where's my order?"** Agent looks up the customer by email → gets order history → finds the relevant order → checks fulfillment status → replies with tracking info.

**"I want to return this item"** Agent looks up the order → verifies it's eligible for return → creates a return request.

**"What products do you have for...?"** Agent searches the product catalog → presents relevant products → optionally generates a product carousel in chat.

## Tips

**Pair with a helpdesk.** Shopify works best alongside a helpdesk integration like [Zendesk](https://docs.eesel.ai/connect-your-tools/helpdesks/zendesk) or [Gorgias](https://docs.eesel.ai/connect-your-tools/helpdesks/gorgias). The agent handles tickets while looking up Shopify data as needed.

**Enable HITL for order management.** Turn on [Human in the Loop](https://docs.eesel.ai/configure-your-agent/human-in-the-loop) for sensitive actions like refunds and cancellations.

**Use product carousels in chat.** The Generate Product Carousel action creates a visual product display — great for the [Chat Bubble](https://docs.eesel.ai/configure-your-agent/testing-and-deployment#chat-bubble) on your website.

## Troubleshooting

**Can't connect?**

* Ensure you have admin access to your Shopify store
* For API token connections, verify the token has the correct scopes

**Product data seems outdated?**

* Product data is fetched in real-time from Shopify, so it should always be current
* If issues persist, try disconnecting and reconnecting