Configure experimental shopping cards and photo previews

Before you begin

Open workspace Settings and select Connections or Messaging as appropriate. Use an account authorised to connect the external business or store.

Step by step

1. 1

   Verify the product source

   Use an active WooCommerce, PrestaShop or supported custom connector, or configure the merchant website and registered read-only catalog actions. Website photo previews require a public product page on that configured host with Product structured data or explicit product Open Graph metadata; the server resolves its product image independently. Store permissions and signed-in ownership checks remain authoritative for connector actions.

2. 2

   Choose independent capabilities

   Keep the commerce master enabled and review cart, customer and order capabilities. Shopping experience is experimental and off by default; enable it and Product cards only for the intended agent. View product remains the primary button for an available, permitted product link. Toggle Add to cart and Try it in your photo independently, then save. Hiding the cart button leaves the assistant's cart tools available; disabling Cart actions also prevents card cart actions. Existing cards use current button settings when history is reloaded, and the server rechecks disabled actions on use.

3. 3

   Enable photo impressions deliberately

   Try it in your photo is separately off by default and needs configured image generation, private storage and workspace AI credits. Each new completed generation costs 20 workspace credits; failed, cancelled or unconfirmed new results are released. Reopening, comparing and downloading do not incur another generation charge. Existing jobs retain their original pricing. Analytics shows recorded image requests, their outcomes and exact charged credits by model, respecting period, assistant and channel filters; CSV/PDF exports include the same aggregate data. Set the label, placement guidance, quality, conversation/day limits, retention of 1–72 hours and download permission. Validate actual sample results before offering it to shoppers.

4. 4

   Offer a photo when the shopper asks

   In Workflows, choose Show how a product looks (Laat zien hoe een product eruitziet). Review its appearance-question condition and Offer a product photo and visualization action, optionally set a button label, assign the intended agent and publish. It uses the discussed product and asks for clarification when ambiguous. The action offers a catalog photo and upload button; the shopper still uploads their own photo and starts generation explicitly. Pause the workflow to stop these contextual offers; the agent's existing shopping and photo switches also apply.

5. 5

   Test a shopper journey

   Ask for a real product and verify its card. When an authorized cart action is offered, Add to cart uses the shop's own cart and waits for confirmation. Products needing choices must be configured in the shop. A custom connector needs an updated live SDK advertising productCardActions and durable idempotency. Website photo-preview cards do not grant cart actions.

6. 6

   Review and remove an impression

   Choose Try it in your photo, upload JPG/PNG/WebP up to 12 MB and start the transformation. Close and reopen to resume; use the keyboard or drag the before/after slider. Download only when allowed, or delete the photos. Photo access expires automatically and cleanup removes expired private assets.

Check the result

Verify the connection status, correct agent assignment and one complete test in the external channel. External permissions and delivery rules still apply.

Questions & troubleshooting