Shopify stores

AI customer support for Shopify: order status and policy answers in the chat

PepoChat puts an AI support agent on your Shopify storefront. It answers shipping, returns and product questions from the pages and policies you import, looks an order up in Shopify when a shopper gives the order number, and hands the conversation to your team inbox when a person is needed. It installs with one script tag in your theme and connects to the store through a small app you create yourself in Shopify's Dev Dashboard, with read-only access to orders.

It suits Shopify merchants whose support arrives through the storefront and is mostly order status and policy questions, and who would rather not make shoppers sign in to ask. It is not a Shopify App Store app, and it reports on orders without changing them.

  • Every chat feature on the free plan
  • No credit card

Order status from Shopify

0:36 · no sound

The agent asks for the order number, reads the payment and fulfillment status from Shopify, then answers a returns question from the store's own page.

Rendered from the widget's own markup with a sample store

How it works

How a Shopify store sets it up

  1. 1

    Import your pages and policies

    In Knowledge Base, import the store's sitemap with an include path of /pages, and paste your policy addresses, such as /policies/refund-policy and /policies/shipping-policy, as individual links. A sitemap import keeps up to 200 pages and counts as one knowledge source; each pasted link counts as one.

  2. 2

    Create the app in Shopify's Dev Dashboard

    Create an app named PepoChat, release a version with the read_orders scope and nothing else, and install it on your store. The app and the store must belong to the same Shopify organization. The docs put the setup at about five minutes, and it needs no Shopify approval.

  3. 3

    Paste the Client ID and secret into PepoChat

    Under Integrations, open Shopify and enter your store domain (your-store.myshopify.com, or paste your admin URL), the Client ID and the Client secret, then tick Check order status and add the action. PepoChat fetches its own short-lived access token and renews it, so there is no token to copy or rotate.

  4. 4

    Test with a real order, then switch it on

    Click Test on the action and enter a real order number from the last 60 days. The test runs the real request and shows the response exactly as the agent would see it. The action starts switched off; flip it on when the result looks right.

  5. 5

    Write the greeting and the rules

    Set a greeting and three suggested questions such as 'Where is my order?' and 'How do returns work?'. Under Never do this, add 'Never promise a delivery date' and 'Never say whether a product, size or color is in stock; point the shopper to the product page'.

  6. 6

    Paste the tag into your theme

    In Online Store, Themes, choose Edit code, open theme.liquid and paste the script tag from Widget Setup on the line above the closing body tag. A Custom Liquid section in the theme's Footer area takes the same tag without opening a code file. Then add your domain and your-store.myshopify.com under Allowed domains.

Plans

What each plan gives a Shopify store

CapabilityFreeStarterGrowthScale
AI replies a month100, then conversations go to your inbox1,000, then $39 per 1,0005,000, then $39 per 1,00017,000, then $39 per 1,000
Shopify order status actionIncludedIncludedIncludedIncluded
Helpdesk tickets (Zendesk, Freshdesk, Zoho Desk, HubSpot, Salesforce)IncludedIncludedIncludedIncluded
Knowledge sources5 (a sitemap import or crawl counts as one)UnlimitedUnlimitedUnlimited
Knowledge base text20 MB200 MB1 GB5 GB
Weekly re-fetch of imported store pagesNot included; sync by handIncludedIncludedIncluded
Team members13, extra seats $15 a month10, extra seats $15 a month20, extra seats $15 a month
Actions per workspace, integrations and custom combined20202020
New-lead emails to the teamNot includedIncludedIncludedIncluded
"Powered by PepoChat" on the widgetShownShownShownShown

Prices in US dollars; yearly plans cost ten months' price. Overage on paid plans is billed on the next invoice.

Where the widget goes in a Shopify theme

PepoChat is not in the Shopify App Store; the install is one script tag in your theme. In Online Store, Themes, choose Edit code and open theme.liquid in the layout folder, the layout file your theme's pages render through, then paste the tag on the line above the closing body tag. If your theme has a Custom Liquid section, adding one to the Footer area and pasting the tag there does the same job from the theme editor. Paste it in one place only; a second copy does nothing.

A theme script reaches the pages your theme draws: home, collections, products, cart, search, blog and the policy pages. Shopify builds the checkout, the Thank you page and the Order status page outside the theme, so the launcher is not on them. A shopper with a question after paying asks it back on the storefront, which is where the order lookup answers it.

The launcher sits bottom right by default, and data-position="bottom-left" on the tag moves it when a cart button or another chat already uses that corner. A new theme starts without the tag, so paste it again when you switch themes. Add your own domain and your-store.myshopify.com to the allowed-domains list so the tag starts conversations only on your store.

How the store connects: a Dev Dashboard app with read_orders

The connection is a small app you create yourself in Shopify's Dev Dashboard, not an App Store install. You name it, release a version whose only scope is read_orders, install it on your store, and copy its Client ID and Client secret into the Shopify card under Integrations. Nothing has to be approved by Shopify, and you leave the distribution method unpicked because it is not needed.

PepoChat exchanges those two values for a short-lived access token and renews it by itself, so nobody copies or rotates a token. The secret is encrypted before it is stored and is never shown again in the dashboard. The scope only reads orders, so the credential cannot change one whatever a visitor asks for.

Two details save a support email later. The app and the store must belong to the same Shopify organization, and a test that answers 'app_not_installed' means the Install app step was not finished for that store. An older admin token from a legacy custom app is not what the Shopify card takes; it still works as a custom action with an X-Shopify-Access-Token header.

What the order lookup takes and what it returns

The agent asks for the order number, sends it to Shopify and answers in plain language. The input is the number alone, digits only, so 1042 rather than #1042. Four fields come back to the agent: the order's name, its creation date, its payment status and its fulfillment status. Before answering, the agent confirms that the returned order name matches the number the shopper gave.

Those four fields are everything the model sees. There is no tracking number, carrier or tracking link, no line items and no address, so the answer is 'paid and fulfilled' and never the parcel's whereabouts. If Shopify finds no order, the agent asks the shopper to double-check the number; on any other error it offers a person.

The read_orders scope covers orders from the last 60 days, which is where almost every order-status question lands. An older order is not visible to the lookup, and Shopify's read_all_orders scope needs an access request that Shopify approves.

The lookup does not check who is asking. It runs on whatever number is typed, with no sign-in and no email check, and order numbers count upwards. That is why the action exposes those four fields and nothing personal.

Policies, product questions and the handoff

Everything that is not an order lookup is answered from what you import. Shopify publishes store policies at fixed addresses such as /policies/refund-policy and /policies/shipping-policy. Paste those as individual links: a pasted link is fetched even when the store's robots.txt disallows the path, while crawls and sitemap imports obey it. Write a Q&A pair for anything shoppers phrase differently from the policy text.

Product answers come from the product pages you import, not from Shopify's catalog or inventory. A sitemap import keeps up to 200 pages, so a large catalog can fill it before the help pages are reached: import /pages first and /products as a second import. On Shopify's Dawn theme every size and color option carries a hidden 'sold out or unavailable' label that an import reads as plain text, which is the reason for the stock rule in the setup steps.

When a case needs a person, a damaged item, a refund request, an order that shows fulfilled but has not arrived, the conversation turns escalated in your inbox and every workspace member gets an email with the last three messages. With Zendesk, Freshdesk, Zoho Desk, HubSpot or Salesforce connected, the agent can also file a ticket and tell the shopper its number.

What it does not do for a Shopify store

  • PepoChat is not in the Shopify App Store and has no app embed. The widget is a script tag you paste into the theme, and a new theme needs it pasted again.
  • The widget does not appear on Shopify's checkout, Thank you or Order status pages. Shopify builds those outside the theme, so a theme script never loads there.
  • The Shopify action looks an order up by order number only. There is no lookup by email, so a shopper without the number needs the confirmation email or a person on your team.
  • The lookup returns the order name, date, payment status and fulfillment status, for orders from the last 60 days. No tracking number, carrier, tracking link, line items or address.
  • The agent reports on orders and cannot cancel, edit or refund one, change an address or add a product to the cart. No PepoChat action moves money.
  • Order lookups are not gated by sign-in or by email verification. Anyone who types an order number hears those four fields.
  • Shopify's catalog and inventory are not read. Product answers come from the pages you import, so leave stock questions to the product page.

Shopify stores: questions teams ask

Is PepoChat a Shopify app?
Not an App Store app. You paste one script tag into theme.liquid, or into a Custom Liquid section, and connect order status through a small app you create yourself in Shopify's Dev Dashboard with the read_orders scope. Nothing is installed from the Shopify App Store and nothing needs Shopify's approval.
Where does the script tag go in a Shopify theme?
Online Store, Themes, Edit code, then theme.liquid in the layout folder, on the line above the closing body tag. Duplicate the theme first and test on the copy. If the theme has a Custom Liquid section, add one to the Footer area and paste the tag there instead.
Can it tell a shopper where their package is?
It can tell them whether the order is paid and whether it is fulfilled, by order number. It does not return a tracking number, a carrier or a tracking link. Put your delivery times on a policy page so the agent can set expectations, and let your team pick up anything that looks stuck.
Can a customer look up a Shopify order by email?
No. The Shopify action takes the order number only. A shopper who has lost it can find it in the confirmation email, or the agent hands the conversation to your team. A lookup by email exists on the WooCommerce integration, not on Shopify.
Can the agent cancel or refund a Shopify order?
No. The Dev Dashboard app has read-only access to orders, and the agent has no action that edits, cancels or refunds one. It explains your returns policy from your content and hands the case to your team, with a helpdesk ticket if you connected one.
Does the chat show during checkout?
No. The widget shows on the pages your theme renders, such as the home page, collections, products, the cart and the policy pages. Checkout, the Thank you page and the Order status page are built by Shopify outside the theme, so the launcher is not on them.
What does it cost for a Shopify store?
The Shopify action is on every plan, including Free with 100 AI replies a month. Starter is $39 a month with 1,000 replies, Growth $149 with 5,000 and Scale $499 with 17,000, and replies past a paid allowance cost $39 per 1,000. Test chats in the dashboard drawer are free.

Still unsure? Email [email protected] or talk to us.

Order status from Shopify, answered in the chat

Paste one script tag or install the WordPress plugin, point the agent at your content, and the first conversation resolves itself. Every chat feature is on the free plan.

  • No credit card
  • About ten minutes to set up
  • Claims checked against the docs on November 13, 2026