Connect Shopify

Shopify in the workspace sidebar, or /workspaces/:id/shopify_connection. Only owners see it. Agents keep working the inbox; they cannot connect or disconnect a shop.

The connect flow requests exactly read_orders. Doorwick refuses the connection if Shopify grants anything else — including write access, all-orders, customers, products, Storefront scopes, or fulfillment and returns writes.

One shop

A workspace can connect one shop. Disconnect it before linking another.

Read-only orders

Connected state shows a Connected chip, the shop domain as text, “Orders · read-only · answered in the widget,” and how many order lookups the assistant made in the last seven days.

Not the widget

Connecting Shopify does not paste or inject the chat snippet. Keep installing the widget in theme.liquid as described in Add the chat widget to your site.

Once a shop is connected, the AI assistant can look up a visitor's orders and answer questions such as “where is my order?” or “what did I buy?”. Each matching order appears in the widget as a card with the order number, date, payment and fulfillment status, items, total, and any carrier tracking links. The assistant summarizes; the card carries the facts.

Verified visitors

A visitor your site identified with a signed identity (see Verified visitors) is matched by the email your server supplied. They can ask about their orders without typing anything else.

Anonymous visitors

The assistant asks for the order number and the email used at checkout. Both must match the same order, lookups are limited to a few attempts per visitor, and a miss never reveals whether the number or the email was wrong.

Read only

Refunds, cancellations, returns, and address changes are handed to your team. The assistant cannot change an order, and the connection never receives write access.

1. Open Shopify in the workspace.
2. Enter the store domain — your-store.myshopify.com or a custom domain like zunlo.store.
3. Click Connect Shopify and approve read-only orders in Shopify.

When it succeeds, the page shows the shop domain, the read-only caption, and Disconnect.

Disconnect on the same page clears Doorwick’s access token and stops order reads. Uninstalling the app in Shopify Admin does the same: Doorwick shows the disconnected connect form again and will not read orders.

The upcoming Shopify catalog settings under widget Behavior let owners select a separate Storefront Connection, primary storefront origin, country and language. Save the settings, then choose Verify saved catalog connection to check the market and currency. Saving alone makes no Shopify request. Changing settings requires verification again.

This setup supports the digital assistant currently in development. Visitor product cards, comparisons and cart controls are not yet released. Your existing order connection continues to use its current order-read permission.

In the digital assistant preview, ask for more results to continue the same product search. Each page shows up to six cards. More product pages and more variants are separate: a search card can show one option while other options remain available through Browse variants. Continuing a search checks current store facts again.

In the digital assistant preview, Browse variants shows the options for a product card. More variants loads the next page. Choosing an option checks its current price and availability and updates that card; it does not add the item to a cart. Expired choices must be checked again. A separate product-link check is required before opening the store page. View selected variant opens a separate tab; Open on this page uses the current tab. When the destination has the Doorwick widget, it can report reaching the selected product. Opening the link alone is not recorded as an arrival or purchase.

View product details opens the product in a separate tab and focuses a section your theme has approved. Before loading the widget snippet, your theme can set window.doorwickSettings.catalogDetails to a map such as { "/products/handle": "product-details" } and give its details heading id="product-details". Preserve any other widget settings. Use exact product paths and simple element IDs, not CSS selectors. If the section is missing, hidden or not registered, the product page opens normally. The assistant never scrolls from a voice request alone.

Preview cart controls let visitors choose a quantity and select Review addition. The review shows the exact variant, quantity and unit price. Only the separate Add to cart button confirms the addition; a typed or spoken yes does not. Cancel addition dismisses the proposal. The assistant checks the existing cart again before adding and reports the observed result. Use Check cart result to recover a missing result, including after reopening the widget. An uncertain result requires inspecting the store cart. After the pending-request wait, the visitor can explicitly finish that review; this does not repeat the addition or prove it succeeded. Any further addition needs a new review and confirmation. Live-store acceptance is still outstanding, so this preview is not ready for merchant rollout.

Workspace owners can prepare the digital assistant’s private order sign-in under widget Behavior → Configure customer account sign-in. Connect the workspace’s Shopify store first, then enter the public Customer Account API client ID. The page shows the exact redirect URL and JavaScript origin to register in Shopify. Do not paste an Admin token or client secret.

Save and verify account settings checks the connected shop and its account endpoints. Saving or disabling settings ends existing customer sign-ins and clears their stored credentials. Owners can disable saved settings even when the workspace is unsubscribed. A stale settings page must be reloaded before saving.

Customer sign-in stops voice before opening Shopify in a separate tab. Customers return to the widget to see their connection status. Closing the widget or selecting Sign out ends the widget’s customer-account session. If sign-out cannot be confirmed, voice stays off and the customer can retry. This does not sign the customer out of Shopify itself.

After sign-in, select Show my recent orders to see up to five recent orders, their items, payment and fulfillment status, and available tracking. These details stay outside the chat transcript. They clear when the widget is hidden, when you sign out, or after a short display period; select the button again to retrieve current details. Select Show older orders to browse the next page, or Return to latest orders to start again. More items and More shipments open additional pages for that order. Each page replaces the previous private view, and Return to recent orders retrieves the order summaries again. Pages show up to ten items or five shipments at a time; a shipment may have no tracking details yet.

Select Ask a person about these orders to review the order names and statuses you want to share. Share these details and request support saves that reviewed information in a support-only note and queues your existing conversation for the team. It ends private account access in the widget. Items, addresses and tracking details are not included in the note. Cancel sharing closes the review without requesting support.

If the result is missing, Retry the same request checks that request again. It may already be queued. A queued request does not mean an operator is currently present. If the conversation cannot reload afterward, Refresh conversation retrieves its current state.