Skip to main content

How do I connect my Shopify or WooCommerce store to my agent?

Connect a Shopify store with your own Shopify app, or a WooCommerce store with a REST API key, and fix common errors.

Store agents can read your products, orders, inventory and more, and change them if you allow it. You connect your store with credentials you create yourself, so you decide exactly what the agent may do.

Shopify

Wiro has no shared Shopify app. You create a small app for your store in Shopify's Dev Dashboard, and the agent can do only what that app's scopes allow.

  1. In the Dev Dashboard, create an app and give it only the Admin API scopes the agent needs (for example, read products, or read and write orders). Release a version and install it on your store.

  2. Copy the app's Client ID and Client Secret from its Settings page.

  3. On the agent's Shopify card, enter the store's myshopify.com domain in lowercase, such as example-store.myshopify.com. Don't use your custom storefront domain, and leave out https://, /admin and any path.

  4. Choose Client ID + Secret when the app and the store belong to the same Shopify organization. Wiro exchanges them for a short-lived token and renews it automatically.

  5. For a store in another Shopify organization, choose the customer-owned OAuth app option instead: add the redirect URL from the field help to your app, then connect and approve.

If you see "Shopify could not exchange or validate these app credentials...", check the myshopify.com domain, that the app and store are in the same organization, and the app's granted scopes.

WooCommerce

  1. In WordPress, go to WooCommerce, then Settings, then Advanced, then REST API, and add a key for a dedicated store user. Choose Read, or Read/Write only if the agent must change the store.

  2. Copy the Consumer Key (ck_...) and Consumer Secret (cs_...). The secret is shown only once.

  3. On the agent's WooCommerce card, enter the store's public HTTPS address, including any subfolder (such as https://example.com/shop) but without /wp-json/wc/v3. HTTP, localhost and private IP addresses aren't accepted.

WooCommerce errors:

  • 401: the key or secret is wrong, revoked, or belongs to another store.

  • 403: the key's WordPress user doesn't have permission for that action.

  • 404: the store address or subfolder is wrong, or the store's REST API or permalinks need setting up.

  • Blocked by a firewall or proxy: allow authenticated requests to the WooCommerce REST API.

Did this answer your question?