Shopify

With Shopify connected, "where is my order?" is answered with the live payment and fulfillment status from your store. Setup takes about five minutes in Shopify's Dev Dashboard and needs no Shopify approval.

What the agent can do

The agent may read only the order's name, creation date, financial status and fulfillment status.

Before you start

• A Shopify store where you can create apps in the Dev Dashboard.
• The store must belong to the same Shopify organization as the app you create.

Connect Shopify

1. Open Shopify's Dev Dashboard

   Go to dev.shopify.com/dashboard and sign in with the account that owns the store. From the store admin you can also go to Settings → Apps and sales channels → Develop apps → Build apps in Dev Dashboard.

2. Create the app

   Apps → Create app → Start from Dev Dashboard, name it PepoChat, and click Create.

3. Create a version

   Versions → Create version. Fill in only these, then click Release:

   • App URL: https://app.pepochat.com (a placeholder; PepoChat never loads inside Shopify).
   • Embed app in Shopify admin: turn off.
   • Scopes: read_orders. It covers the last 60 days of orders; read_all_orders is gated and needs a Shopify-approved access request.
   • Leave optional scopes, redirect URLs, POS and app proxy empty. If Shopify insists on a redirect URL, enter https://app.pepochat.com there too.

4. Install the app on your store

   Home → Install app, pick your store, Install. Do not pick a distribution method: it is not needed and cannot be changed later.

5. Paste the credentials into PepoChat

   In the app's Settings, copy the Client ID and Client secret. In PepoChat open App Integrations → Shopify, enter your store domain (your-store.myshopify.com, or paste your admin URL), the Client ID and the Client secret, tick Check order status, and click Add actions.

6. Test, then enable

   Click Test on the action, enter a real order number and check the result. Then switch the action on.

PepoChat fetches its own short-lived access token from the client credentials and renews it automatically; you never handle tokens.

Example

Visitor: Has my order shipped? It's 1042.

Agent: Order #1042 is paid and fulfilled, so it is on its way. Anything else I can check?

Good to know

• Only orders from the last 60 days are visible with the read_orders scope.
• If the test says "app_not_installed", finish the Install app step for the store.
• A legacy custom-app admin token still works as a custom action with an X-Shopify-Access-Token header, but new stores should use the client credentials flow above.
• Selling on WordPress instead? See WooCommerce.