Skip to content

Connect your Shopify store using your own app

Connect your Shopify store to StrataBlue Support using a custom Shopify app. Once connected, your team can view customer orders, payment status, and fulfillment status from the conversation sidebar.

This option is available for selected workspaces. Contact StrataBlue Support support if you would like it enabled.

  • Administrator access to your StrataBlue Support workspace.

  • Permission to create and install apps for your Shopify store.

  • Access to a Shopify Partner organization in the Dev Dashboard. This setup requires a Custom distribution installation link.

You can connect one Shopify store per workspace. This integration connects order information; it does not install a live chat widget or change your subscription. Custom-app setup is unavailable for workspaces billed through Shopify.

  1. Open the Shopify Dev Dashboard and select your Partner organization.

  2. Go to Apps → Create app → Start from Dev Dashboard.

  3. Name your app, for example StrataBlue Support Support, and create it.

  4. Open Versions and create an initial version.

  5. Turn off Embed app in Shopify admin. If Shopify requires an App URL, use https://shopify.dev/apps/default-app-home temporarily. You will replace it in step 4.

  6. Release the initial version.

See Shopify’s app creation guide for more information.

Section titled “2. Find your app credentials and installation link”

Open your app’s Settings → Credentials and locate the Client ID and Client secret. Keep this page open.

Return to the app overview and find the Distribution card:

  1. Select Custom distribution.

  2. Enter your permanent store domain, such as your-store.myshopify.com, and restrict installation to your intended store.

  3. Generate and copy the complete installation link.

Shopify does not let you change the distribution method after selecting it. The Distribution card is available for apps belonging to a Partner organization. If it is missing, check which organization owns your app. See Shopify’s distribution guide.

3. Save the app details in StrataBlue Support

Section titled “3. Save the app details in StrataBlue Support”

Open Settings → Integrations → Shopify and expand Connect using your own Shopify app.

  • Shopify store domain: enter your permanent domain, such as your-store.myshopify.com, without https:// or a path.

  • Client ID: copy it from your app’s Shopify credentials page.

  • Client secret: copy it from the same credentials page.

  • Shopify installation link: paste the full link generated under Custom distribution. It must belong to the same app and store.

Select Save and get setup URLs. StrataBlue Support stores the client secret encrypted and does not display it again. Saving these details does not connect your store yet.

StrataBlue Support now displays the callback URL, required permissions, and webhook URL for your workspace. Keep this page open.

Create a new version in your Shopify app. Copy the callback URL displayed in StrataBlue Support into both App URL and Allowed redirection URL(s).

Keep Embed app in Shopify admin turned off. If the form shows Use legacy install flow, keep it enabled for this connection flow.

Always copy the URL from your own workspace. Do not use a staging URL or an account ID from an example screenshot.

Add these Admin API access scopes:

read_customers,read_orders,read_fulfillments

Use Shopify CLI to configure app-specific webhook subscriptions when the Dev Dashboard does not expose subscription fields. Changing Webhooks API version alone does not create subscriptions. Run these commands in a terminal on your computer. Ask the developer managing your Shopify app for help if needed.

1. Install Shopify CLI. Install Node.js and Git using the requirements in Shopify’s CLI guide, then run:

npm install -g @shopify/cli@latest

2. Link your existing Shopify app. Save and release the app URL, redirect URL, and scope changes above in the Dev Dashboard before linking, so the CLI downloads the current configuration. Open a terminal in your app’s local project folder. If you created the app entirely in the Dev Dashboard, create a folder for its configuration first:

mkdir chatwoot-shopify-app
cd chatwoot-shopify-app
shopify app config link

Sign in with access to the Partner organization that owns the app. Select the existing app whose Client ID you entered in StrataBlue Support. Do not create a second app. The command downloads its configuration into a TOML file, usually shopify.app.toml. If you already have a local project, use that project and keep a copy of its configuration before linking.

3. Add the uninstall subscription. Open the generated TOML file. Keep its existing app URL, redirect URLs, scopes, install-flow settings, and webhook API version. Add this subscription alongside any existing subscriptions:

[[webhooks.subscriptions]]
topics = ["app/uninstalled"]
uri = "YOUR_CHATWOOT_WEBHOOK_URL"

Replace YOUR_CHATWOOT_WEBHOOK_URL with the webhook URL shown in your StrataBlue Support workspace. Do not use the OAuth callback URL. If the file has no [webhooks] section, add one before the subscription and set api_version to the Webhooks API version selected for your app, for example:

[webhooks]
api_version = "2026-10"

Privacy subscriptions: Shopify requires compliance topics for apps distributed through the Shopify App Store. This guide uses Custom distribution. If you also need to configure privacy subscriptions, add a separate entry using compliance_topics:

[[webhooks.subscriptions]]
compliance_topics = ["customers/data_request", "customers/redact", "shop/redact"]
uri = "YOUR_CHATWOOT_WEBHOOK_URL"

Replace the URL placeholder here too. Keep each topic/destination pair only once. See Shopify’s webhook subscription guide for details.

4. Deploy the configuration. From the same folder, run:

shopify app deploy

Review the selected app and configuration changes before confirming. The command creates and releases a new app version. It publishes the local app configuration, so confirm that the callback URLs and required scopes from the steps above are included. If you used a named configuration file, select that configuration with --config.

5. Verify the subscriptions. In the Dev Dashboard, open your app → Versions → active version → Configuration → Subscriptions. Confirm that app/uninstalled points to your StrataBlue Support webhook URL, along with any privacy topics you configured. Allow a few minutes for the released version to take effect. You do not need to uninstall an already connected app to add these subscriptions.

The CLI deployment above creates and releases the updated version. Confirm that Shopify marks it Active and that it includes the URLs, permissions, and webhook subscriptions above.

This screenshot shows an example workspace. Copy the setup URLs from your own StrataBlue Support workspace.

  1. Return to StrataBlue Support and select Connect store in Shopify.

  2. Sign in to the intended Shopify store and complete any two-factor verification.

  3. Approve the installation or requested access in Shopify.

  4. After authorization, return to StrataBlue Support. The integration page will confirm that your store is connected.

Open a conversation with a contact whose email address or phone number matches the customer’s Shopify record. Expand Shopify Orders in the conversation sidebar.

Available orders show their total, payment status, and fulfillment status. Select an order to open it in Shopify. If you see No orders found, check that the contact details match a Shopify customer who has orders.

Before connecting, select Edit app details to update the client secret or installation link. Leave the secret blank to keep the saved value, and paste the installation link again when updating the form.

If you saved the wrong store or Client ID, select Reset setup and enter the correct details.

After connecting, use Delete on the integration page to disconnect. This also removes the custom-app configuration and credentials saved in StrataBlue Support.

Contact StrataBlue Support support to check whether custom-app setup is enabled for your workspace.

Copy the callback URL from StrataBlue Support again. Confirm that it appears in the active Shopify app version, then start a fresh connection attempt.

Shopify requires two-factor authentication

Section titled “Shopify requires two-factor authentication”

Complete verification in Shopify, then return to StrataBlue Support and select Connect store in Shopify again.

Check the permanent store domain, credentials, and installation link. Use the complete Shopify-generated custom installation link for the same app and store.