B Blengi docs

Shopify

Shopify app

Deze pagina is nog niet beschikbaar in het Nederlands, daarom lees je hem in het Engels.

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. A layout chosen in the dashboard (Customize › Inline block › Layout) applies to this block too; leave it on As set on the page to let the theme setting decide. 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.

Signed-in customers

Paste the identity secret from your dashboard (Settings › Widget › Identify signed-in customers) in the app embed's settings, and the embed tells the AI employee who is signed in: the customer id signed with the secret (Shopify's hmac_sha256 filter, on Shopify's side), the e-mail address and the name. That is what recognises a customer on every device — see Identify signed-in customers. Without the secret nothing is sent and every visitor stays anonymous.

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.