Zanderio AI

Zanderio AI connects your WordPress site or WooCommerce store to an AI-powered sales agent that

answers customer questions in real time using your live product and order data.

The chat widget is bundled directly inside the plugin — no external scripts are

loaded or executed at runtime. All communication with the Zanderio service uses

plain HTTPS. Connecting is one click on activation with no Application Password

step, so it works on every supported WordPress version. WooCommerce stores are

synced using a read-only REST API key the plugin creates automatically.

Features:

• One-click activation — auto-handshake with Zanderio backend

• No Application Password or manual API keys needed

• WooCommerce product/order sync via a read-only REST key and webhooks

• Widget colour customisation from Settings → Zanderio

• Daily health heartbeat

• Clean uninstall — all data removed from both sides

External Services

ai )

services over plain HTTPS REST calls. There is no WebSocket connection — all

communication, including live streaming chat responses, uses standard HTTPS

requests.

api.zanderio.ai (REST API — store connection)

Used server-side by the plugin (PHP) and client-side by the chat widget (JS)

to bootstrap the widget.

Server-side (PHP):

• On activation — sends your store URL, site name, admin email, WordPress

version, WooCommerce version, and plugin version to register the store.

• Webhooks — WooCommerce product and order data is pushed via webhooks so

the AI agent can answer customer questions accurately.

• Daily heartbeat — a lightweight ping confirming the store is still active.

• On deactivation / uninstall — notifies Zanderio to disconnect the store

and delete associated data.

js) — widget bootstrap:

• POST /v1/widget/bootstrap — on page load, the widget exchanges the

plugin’s public widget key for a short-lived session token and your

appearance settings (brand color, logo, launcher animation). No personally

identifiable visitor data is required for this step; an anonymous visitor

id is generated locally and sent along so return visits resume the same

conversation.

• POST /v1/widget/nudges/fire — only when your store uses proactive

nudges: asks whether a prompt bubble may be shown, sending the store id,

the anonymous visitor id, which nudge it is, and the current conversation id.

agent.zanderio.ai (AI Service — chat)

Used client-side by the chat widget (JS) only, authenticated with the session

token issued by the bootstrap call above.

• POST /v1/threads/{id}/chat — sends the visitor’s typed messages and

streams the AI agent’s reply back over the same HTTPS connection

(Server-Sent Events) as it’s generated.

• GET /v1/threads/{id}/state — restores the visitor’s prior messages

when the widget reopens after a page reload, so conversation history isn’t

lost.

• POST /v1/speech/transcriptions, POST /v1/speech/voice-messages —

only when voice is turned on for your store and the visitor taps the

microphone: uploads their recording to be transcribed, or kept as a voice

message.

• POST /v1/speech/voice-replies, GET /v1/speech/audio/{id} — only in

voice-message mode: has the assistant’s reply spoken aloud, and fetches

earlier voice messages to replay them.

• POST /v1/threads/{id}/images, GET /v1/images/{id} — only when photo

search is turned on for your store and the visitor chooses to send a

product photo: uploads the photo (shrunk in the browser first) to find

matching products, and fetches it again to show it in the conversation.

Links:

• Zanderio Terms of Service

• Zanderio Privacy Policy

Source Code & Build Tools

js is a minified production build. The full,

human-readable source code is available on GitHub:

com/Zanderio-ai/zanderio-wp-widget

js from source:

• Clone the repository: git clone https://github.com/Zanderio-ai/zanderio-wp-widget.git

• Install dependencies: npm ci

• Build for WordPress: WIDGET_ENV=prod npm run build:wordpress

js.

Build toolchain: Vite + React +

Terser (minifier).