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 soundThe 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
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
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
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
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
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
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
| Capability | Free | Starter | Growth | Scale |
|---|---|---|---|---|
| AI replies a month | 100, then conversations go to your inbox | 1,000, then $39 per 1,000 | 5,000, then $39 per 1,000 | 17,000, then $39 per 1,000 |
| Shopify order status action | Included | Included | Included | Included |
| Helpdesk tickets (Zendesk, Freshdesk, Zoho Desk, HubSpot, Salesforce) | Included | Included | Included | Included |
| Knowledge sources | 5 (a sitemap import or crawl counts as one) | Unlimited | Unlimited | Unlimited |
| Knowledge base text | 20 MB | 200 MB | 1 GB | 5 GB |
| Weekly re-fetch of imported store pages | Not included; sync by hand | Included | Included | Included |
| Team members | 1 | 3, extra seats $15 a month | 10, extra seats $15 a month | 20, extra seats $15 a month |
| Actions per workspace, integrations and custom combined | 20 | 20 | 20 | 20 |
| New-lead emails to the team | Not included | Included | Included | Included |
| "Powered by PepoChat" on the widget | Shown | Shown | Shown | Shown |
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?
Where does the script tag go in a Shopify theme?
Can it tell a shopper where their package is?
Can a customer look up a Shopify order by email?
Can the agent cancel or refund a Shopify order?
Does the chat show during checkout?
What does it cost for a Shopify store?
Still unsure? Email [email protected] or talk to us.
More use cases
- SaaS product supportSupport teams at software companies
- E-commerce and order supportShopify, WooCommerce and Stripe stores
- WooCommerce storesWooCommerce stores on WordPress
- Sales teamsSDRs, account executives and founders who sell
- Agencies and consultanciesWeb agencies, freelancers and consultants
- Clinics and service businessesClinics, salons, trades and local services
- Course creators and coachesOnline educators, coaches and consultants
- Customer onboardingB2B onboarding and customer success teams
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
