Important product naming update: Sidekick is now called Gladly (AI) and Gladly Hero (the Platform) is now Gladly Team. Please keep this in mind as you read through our documentation.

Shopify on App Platform Overview

Prev Next

Gladly's Shopify integration connects your Shopify store to Gladly AI and to your team. Customers can resolve everything order-related, from "where's my order?" to refunds, cancellations, address changes and replacement orders, in a Conversation with Gladly AI, and you control what Gladly AI can do through Guides. On the Customer Profile, a Shopify card shows the Customer's three newest orders with every item, the totals, the shipping address and each shipment's tracking link, and team members can cancel, refund, or edit an order's note or tags without leaving the Conversation.

Key benefits

Empower customer self-service

Customers resolve their own order questions, such as tracking, cancellations, refunds and reorders, in a Conversation with Gladly AI, any time. Routine requests are resolved instantly, and every answer draws on the customer's real Shopify data, not what they remember.

See recent orders on the Customer Profile

The Shopify card shows the customer's three newest orders, newest first, live from Shopify. Each order shows its first item's picture, its order number linked to the order in Shopify, its status, total and date, and opens to show its items, order details, shipping address and shipments. The card's heading gives the customer's real order count, so a team member sees at a glance how much history sits behind the three shown.

Act on orders without leaving Gladly

Team members can cancel an order, refund it in full, or replace its staff note or tags from forms on the Customer Profile. Each form starts from the customer's own orders, and the change is made in Shopify straight away.

Make it right in the moment

Turn a damaged delivery into a devotion moment: your Guides can have Gladly AI create a $0 replacement order, issue store credit, or send a one-time discount code while the customer is still in the Conversation.

Let customers pay securely through Shopify

Gladly AI builds the order on the customer's behalf and emails them a Shopify checkout link to pay. Prices can be locked when the order is a quote, and no payment details ever pass through the Conversation.

Design AI workflows you can trust

Guides define exactly which actions Gladly AI can take and when. Refund amounts are previewed and confirmed with the customer before they're issued, inventory is checked before a replacement is promised, and every change returns a clear result.

Supported features

The Shopify App Platform integration is available in the following areas of Gladly:

Gladly Team

The Shopify card is available on the Customer Profile. When a team member opens a Conversation, the app looks up the customer in Shopify and renders their three newest orders alongside the Conversation.

Team members can also act on orders from four agent forms in the + menu on the Customer Profile: Cancel order, Refund order, Edit order note and Edit order tags.

Shopify is connected by entering the store's subdomain in Gladly Settings and authorizing the app in Shopify.

Gladly AI

All 21 actions are available to Gladly AI through Guides, together with the customer, order and metafield data pulls. Gladly AI starts every order Conversation already knowing the customer's Shopify account and recent orders. Administrators choose which actions team members and Gladly AI can use in Agent Actions.

Rules and Routing

The same Shopify data feeds Rules, so Conversations can be routed and classified on Shopify data. Metafields are also available to Rules.

Details

What data can you access

Shopify card

  • Orders: the three newest, each with a picture of its first item, its order number linked to the order in Shopify, its status, total and date. The heading shows the customer's total order count.

  • Items: fulfilled, unfulfilled or, on a cancelled order, cancelled, each with its product image

  • Order details: store (labeled Instance on the card), status, financial status, subtotal, discounts, discount codes, shipping, tax, total, item count, tags and marketing consent. Amounts are in the currency the customer paid in, with the store's amount alongside when the two differ.

  • Shipping address: street, city, state, country and ZIP code

  • Shipments: each shipment's status, contents and tracking link

Data available to Gladly AI

  • Name, email and phone, with email and SMS marketing consent

  • Lifetime spend, total order count and how long they've been a customer

  • Tags and staff notes from Shopify

  • Default and saved addresses

  • Their most recent orders: order number, financial and fulfillment status, subtotal, discounts, shipping, tax and total, the amounts received, refunded and outstanding, line items with product, variant and price, shipping address and delivery method, and a link to the order status page

  • Metafields: the custom data your store attaches to customers and orders, also available to Rules

Available actions

Find and understand orders

  • Look up orders by email: finds a customer's most recent orders by the email address used at checkout (available to Gladly AI)

  • Look up customers by phone number: finds up to 3 customers whose phone number, or the phone number on one of their saved addresses, matches, each with their 5 most recent orders. Numbers are accepted in any common format. (available to Gladly AI)

  • Look up an order by order number: finds one order by the number the customer sees, for example #1001 (available to Gladly AI)

  • Get order details: every line item's lifecycle (ordered, shipped, refundable, removed), shipments with tracking, carrier delivery estimates and when each shipment was created and first scanned in transit, the delivery promise made at checkout, returns, refunds, the sales channel and the delivery method (available to Gladly AI)

Change an order

  • Cancel an order: with a reason, a choice of refund (original payment method, store credit with an optional expiry, or no refund), whether to restock items, a staff note, and whether to notify the customer. Shopify cancels in the background, and Check job status confirms when it completes. (agent form and Gladly AI)

  • Edit the order note, Edit the order tags: replace the staff note, or replace all tags on the order (agent forms and Gladly AI)

  • Check job status: confirms when a background cancellation has completed (available to Gladly AI)

  • Update the shipping address: with address validation and clear, field-level errors (available to Gladly AI)

  • Send an order invoice: emails the customer a link to pay an unpaid order (available to Gladly AI)

Refund an order

  • Refund order (agent form): refunds everything still refundable on an order, including shipping, to the original payment method. A reason is required, and notifying the customer is optional. The form shows the amount before the refund is made, and reports a refund as done only when every payment's refund succeeded; a pending refund reads as still processing.

  • Preview a refund: shows exactly what a refund will be before it's issued, for the whole order or specific items, with or without shipping, to the original payment method or store credit (available to Gladly AI)

  • Refund an order: issues the previewed refund. Supports full and partial refunds, several payment methods on one order, and store credit with an optional expiry. (available to Gladly AI)

Create a new or replacement order

  • Create a draft order for a customer: from catalog products and custom items, with item and order discounts (a 100% discount creates a $0 replacement order), optional tax exemption, and the option to lock today's prices for a quote paid later (available to Gladly AI)

  • Create a draft order from an order: copies an existing order into a new draft, for reorders (available to Gladly AI)

  • Update a draft order: changes its email, phone, note, purchase order number or shipping address (available to Gladly AI)

  • Send a draft order invoice: emails the customer a Shopify checkout link; the order is created once they pay (available to Gladly AI)

  • Complete a draft order: turns the draft into an order straight away, with payment pending or marked as paid (available to Gladly AI)

Products, inventory and promotions

  • Get product inventory: live stock for products and variants, including whether it's in stock, how many are left and whether it can be bought online (available to Gladly AI)

  • Create a one-time customer discount: a single-use, amount-off code for one customer, for the whole order or for specific collections, products or variants (available to Gladly AI)

  • Get metafields, Get files: the custom data and files, such as a return label PDF, your store attaches to orders, products and other Shopify records (available to Gladly AI)

When Shopify refuses a change, the team member or Gladly AI sees why it was refused.

How does customer matching work?

The app matches on the email addresses on the Gladly Customer Profile.

Every email address on the profile is looked up in Shopify, by exact match. If the profile has no email address, its phone numbers are used instead, also by exact match. If exactly one Shopify customer matches, the card and Gladly AI see their account and orders; if no customer or more than one matches, no data is shown.

Gladly AI can also look up a customer by phone number directly. On a call, it can use the number the customer is calling from, so they don't have to spell out an email address. Because several customers can share a number, this lookup returns up to 3 customers, each with their 5 most recent orders.

Key use cases

1. Answer "where is my order?"

Use case: A customer asks where their order is, or when it shipped.

How it works: Gladly AI finds the order and shares the shipment's tracking link, the carrier's delivery estimate, and the date the shipment was created and first scanned in transit. A team member reads the same from the Shipments section of the order on the card.

Business impact: Order status questions are answered from Shopify's record without leaving the Conversation.

2. Make a damaged delivery right

Use case: A customer received a damaged item.

How it works: Gladly AI previews a refund for just that item, confirms the amount with the customer and issues it to store credit or the original payment method, or checks stock and creates a $0 replacement order on the spot.

Business impact: The customer is made whole in the same Conversation, and every refund is confirmed before it's issued.

3. Cancel or refund an order

Use case: A customer has changed their mind about an order, or asks for their money back.

How it works: Gladly AI cancels an unfulfilled order and refunds the original payment method, or issues store credit instead. A team member uses the Cancel order or Refund order form from the + menu, picks the order from the customer's own orders and confirms. The Refund order form shows the amount before refunding.

Business impact: Cancellations and refunds are made without switching to Shopify admin.

4. Fix a wrong shipping address

Use case: A customer entered the wrong shipping address at checkout.

How it works: Gladly AI updates the address before the order ships, with field-level errors if part of the new address is invalid.

Business impact: The order ships to the right place, without a cancellation and reorder.

5. Reorder a past purchase

Use case: A customer wants to buy the same order again.

How it works: Gladly AI copies the original order into a draft, checks that the items are still in stock, and emails the customer a Shopify checkout link to pay.

Business impact: Repeat purchases happen in the Conversation, and no payment details pass through it.

6. Recover from a frustrating experience

Use case: A customer had a bad experience and the store wants to make it right.

How it works: Gladly AI creates a one-time discount code for the customer's next purchase.

Business impact: The customer leaves with a reason to come back.

7. Leave a note or tag on an order

Use case: A team member needs to record what was agreed, or flag an order for follow-up.

How it works: Edit order note replaces the order's staff note, and Edit order tags replaces its tags. Both are in the + menu on the Customer Profile.

Business impact: Store staff working in Shopify see what was agreed, and tagged orders are easy to find.

Notes and limitations

Order lookups by order number, email or phone number can retrieve any order in your store. For security and privacy, verify the customer's identity (for example by confirming their ZIP code or phone number) before sharing order details or making changes.

Upgrading from a previous version

From an earlier release of version 5: no new Shopify permissions are needed. After upgrading, add the Shopify card to the Customer Profile layout and the four agent forms in Agent Actions.

From version 4 or earlier: version 5 is where all new Shopify capabilities land: the Customer Profile card and forms, refunds, replacement orders, order details, inventory and everything that follows. Upgrading takes one re-authorization and a review of your Guides and Rules.

  • Re-authorize the app. The newer version requests additional Shopify permissions. Configure the Shopify app from the Apps page, then authorize it and approve the updated permissions.

  • Update Guides that use changed actions. Look up order by order number, Look up orders by email and the orders data pull now return a slimmer order. For shipment tracking, returns, refunds and the item lifecycle, follow up with Get order details. Preview a refund now covers the whole order by default and needs an explicit choice on refunding shipping; issue the refund with Refund an order. Cancel an order's yes/no refund became a choice of original payment method, store credit or no refund. Update the shipping address now returns only the order and its updated address.

  • Review Rules against the slimmer order data. Transactions, billing address and fulfillment details moved to Get order details. Point any Rule that used them at the new fields.