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
your store’s existing Application Password credentials over HTTPS.

Features:

• One-click activation — auto-handshake with Zanderio backend
• Application Password authentication (no manual API keys)
• WooCommerce product/order sync via webhooks
• Widget colour customisation from Settings → Zanderio
• Daily health heartbeat
• Clean uninstall — all data removed from both sides

External Services

This plugin connects your WordPress site to two Zanderio (zanderio.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.

Client-side (loader.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.

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.

Links:

• Zanderio Terms of Service
• Zanderio Privacy Policy

Source Code & Build Tools

The file assets/loader.js is a minified production build. The full,
human-readable source code is available on GitHub:

Source repository: https://github.com/Zanderio-ai/zanderio-wp-widget

To build loader.js from source:

1. Clone the repository: git clone https://github.com/Zanderio-ai/zanderio-wp-widget.git
2. Install dependencies: npm install
3. Build for WordPress: npm run build:wordpress:prod

The compiled file is output to sources/wordpress/assets/loader.js.

Build toolchain: Vite + React +
Terser (minifier).