B Blengi docs
/

Shopify

Shopify app

On a Shopify shop the assistant comes from a Shopify app: an app embed that loads it on every page, and an "AI answer" block that the merchant drags into the theme editor. No code in the theme.

Install

  1. Install the app from the link you received.
  2. In the Shopify admin: Online Store › Themes › Customize › Theme settings › App embeds. Switch on AI assistant and paste the id of the AI employee (on its Website page). Leave the dashboard address as it is, unless your agency gave you its own (without a slash at the end).
  3. Save the theme. The assistant now opens on every page.

The answer block

On a product page in the theme editor, choose Add block › Apps › AI answer and drag it where it should go, for example below the add-to-cart button. Its settings: the layout (Answer in the block, the default, Card or Bar), a title and a placeholder. Height, colours and the source line come from the inline block settings in the dashboard (see Inline embed). The block answers only while the app embed is switched on.

The product on screen

On a product page the app embed tells the assistant which product the visitor is looking at (name, SKU, price, currency, stock and link, straight from Shopify), with every question, ahead of the page's own structured data. "Does this one come in size 43?" is answered about the right product.

Privacy

The app reads nothing from the shop's admin and keeps no Shopify customer data. It answers Shopify's three compliance requests (customer data request, customer redact, shop redact), signed with the app's secret, with nothing to export or delete.

For the platform: setting up the app

The extension lives in packages/shopify. Create the app in the Shopify Partner Dashboard (a custom app for the first merchants, the App Store later), run shopify app config link in that folder to fill in the client id, and shopify app deploy. Put the app's secret in SHOPIFY_API_SECRET; the app's URL is /shopify (the page after installing) and the compliance webhooks go to /shopify/webhooks/compliance.