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

# Shopify

> Connect ChatterMate to Shopify: the AI agent tracks orders and answers product questions, and your team refunds, cancels and edits orders from the inbox.

# Shopify

The ChatterMate app for Shopify connects your store to an AI agent and to your team's inbox. Install it from the Shopify App Store, pick the agent that answers your store, and turn on the chat in your theme.

[ChatterMate for Shopify: refunds, cancellations and order details in the chat](https://www.youtube-nocookie.com/embed/_lz9RtBgWMs)

> [!NOTE]
>
> The Shopify app is part of ChatterMate Cloud. Plans bought through the app are billed by Shopify.

## What the AI agent does

* **Order tracking.** It shows the order's status and the tracking for every parcel once the customer gives the order number and the email used at checkout. A wrong email gets the same reply as a missing order, so nobody can look up someone else's order.
* **Product answers.** It searches your catalogue from the customer's own words, shows product cards in the website widget and says when an item is sold out. On Growth, customers add to the cart from the card.
* **Orders by email.** On Growth, a customer confirms their email with a code and sees their recent orders without an order number.
* **Handing over.** Refunds, damaged items and anything it can't do go to your team with the whole conversation.

## Orders in the inbox

When a chat's AI agent is connected to Shopify, the customer details beside the thread show:

* what the customer has spent, their number of orders, their average order and how long they've been a customer;
* their latest orders, each with its items, shipping address, tracking and a link that opens it in Shopify.

Orders found by an email the customer only typed, rather than confirmed with a code, say so.

![The inbox with a handed-over chat and, beside it, the customer's Shopify orders: total spent, number of orders, average order, and order #1043 opened to show its items, no tracking yet and the shipping address](https://mintcdn.com/chattermatechat/B3gGOj9UKFsfJrjc/images/shopify-inbox-orders.webp?fit=max\&auto=format\&n=B3gGOj9UKFsfJrjc\&q=85\&s=62cb36627f2d87f0e21347f216bf5667)

## Order actions for your team

On **Growth** and **Pro**, your team acts on an order from the inbox without opening Shopify. Open an order's menu in the customer details:

| Action | When it's offered | What happens |
| - | - | - |
| **Refund** | Something can still be refunded | A full or partial refund to the original payment |
| **Cancel order** | Nothing has shipped | Cancels the order, refunds it to the original payment, and can restock the items and email the customer |
| **Change shipping address** | Nothing has shipped | Saves the new address on the order |
| **Create discount code** | Always | A one-use code for this customer only, as a percent or an amount off, valid for the days you choose |

Each action opens a confirm dialog that says exactly what will happen, checks the order in the store again first, and adds a note to the conversation that only your team sees. Clicking twice never acts twice.

![The Refund #1012 dialog with Part of it selected, an amount of 32 USD, Email the customer ticked, and a Refund \$32.00 button](https://mintcdn.com/chattermatechat/B3gGOj9UKFsfJrjc/images/shopify-refund.webp?fit=max\&auto=format\&n=B3gGOj9UKFsfJrjc\&q=85\&s=80a7b6fdb1bc8dfdc1263fad71c067ef)

![The Cancel order #1043 dialog saying it cancels the order and refunds \$160.00 to the original payment, with a reason, Put the items back in stock and Email the customer ticked](https://mintcdn.com/chattermatechat/B3gGOj9UKFsfJrjc/images/shopify-cancel-order.webp?fit=max\&auto=format\&n=B3gGOj9UKFsfJrjc\&q=85\&s=2fdfa7d0b37c0cd23df17a5d4701677b)

An order paid outside Shopify's checkout, such as cash or a bank transfer marked as paid, can't be refunded from here: refund it in Shopify.

### Who can do what

Each action has its own role permission (see [Roles & Permissions](https://docs.chattermate.chat/features/roles.md)):

| Permission | Allows | Default roles |
| - | - | - |
| `refund_orders` | Refunds | Admin |
| `cancel_orders` | Cancelling orders | Admin |
| `edit_orders` | Changing the shipping address | Admin, Agent |
| `create_discounts` | Discount codes | Admin, Agent |

The menu shows only the actions a person's role allows, and the server checks the permission on every action.

## Order actions for the AI agent

On **Pro**, the AI agent can act on orders too. Every action is off until you turn it on, for each agent, under **AI Agents → your agent → Integrations → Let the AI agent act on orders**:

* **Cancel orders** that haven't shipped, optionally only orders placed in the last few hours.
* **Change the shipping address** of an order that hasn't shipped, in the same country unless you allow a new one.
* **Give a discount code**, up to the most percent or amount you set, valid for the days you choose.

![The agent's Integrations tab with Shopify connected and Let the AI agent act on orders: Cancel orders, Change the shipping address and Give a discount code turned on, with their limits and a Save order actions button](https://mintcdn.com/chattermatechat/B3gGOj9UKFsfJrjc/images/shopify-ai-order-settings.webp?fit=max\&auto=format\&n=B3gGOj9UKFsfJrjc\&q=85\&s=9103246202124516aefa173d6e7212df)

The AI agent **never refunds**. It can't check a customer's word that something went wrong, so refund requests always go to a person.

Before anything changes:

1. The customer writes the order number and their checkout email in the chat.
2. They confirm the email with a code sent to it. The chat shows the box for it.
3. They approve a card in the chat that says what will happen. If they decline, nothing changes.

![The chat widget after the customer confirmed their email, showing a card asking Cancel order #2043 and refund it, with the order, a refund of 45.00 USD to the original payment, and Cancel order #2043 and refund it and Keep my order buttons](https://mintcdn.com/chattermatechat/B3gGOj9UKFsfJrjc/images/shopify-ai-approval.webp?fit=max\&auto=format\&n=B3gGOj9UKFsfJrjc\&q=85\&s=861b97333ce89418ec97184fe140a5a3)

The server checks everything again after the customer approves, then acts. When a request is outside your limits or something isn't right, the customer isn't shown a card: the agent tells them a teammate will help and hands over, and a note in the conversation tells your team why. A customer gets at most one AI discount code a month, and only if they have ordered from you before.

Turning an action on for the AI needs that action's permission too, so someone who can't cancel orders can't let the AI cancel them. These actions are offered in the website widget only, because it's the one channel that shows the approval card.

## Allow order actions in Shopify

Order actions need two extra permissions in Shopify: editing orders and discounts. A store owner grants them once:

1. Open the ChatterMate app in your Shopify admin.
2. On the app's home, click **Allow order actions**.
3. Approve Shopify's request.

Until then, the order menu and the AI settings show a link to this page, and the app only reads your store.

> [card] [Chat Management](https://docs.chattermate.chat/features/chat-management.md)
>
> Next: Learn how your team works in the inbox


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.