poneva Docs

Quick start — install the embed

Your install snippet lives in the dashboard under Integration → Install & health, with your store id already filled in. It looks like this:

html
<script async src="https://poneva.com/widget/embed.js?store=YOUR_STORE_ID"></script>

Paste it into your storefront's <head> (or your tag manager). That is the entire install — the same snippet powers every capability you later turn on.

What happens once it's on your site

  • The loader is silent and safe. It loads asynchronously, never blocks page render, and never throws errors into your site. It fetches your store's published configuration from Poneva and only renders something when your Storefront AI is ready and the widget is switched on in your dashboard. Until then, shoppers see your unchanged site.
  • Install detection is automatic. The snippet reports a lightweight heartbeat, so within about a minute the dashboard's Install & health page flips from "Not detected yet" to "Live on your store". The same page shows a per-capability runtime health breakdown, so you can see exactly what is ready before anything goes live.
  • The Shopping Assistant appears when you turn it on. Shoppers get a launcher that opens a chat panel; the assistant answers from your real catalog and shows live product cards, with add-to-cart on supported stores. See Shopping Assistant for the settings.

Preview before going live

Once your store is ready, opening any page on your site with ?skaii_preview=1 appended to the URL shows you the widget even while it is still switched off for shoppers.

The widget on/off toggle, the snippet, and placement options also live under Shopping Assistant → Settings → Install & placement.

Poneva · agentic-commerce infrastructure Terms Privacy