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:
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:
- Clone the repository:
git clone https://github.com/Zanderio-ai/zanderio-wp-widget.git - Install dependencies:
npm install - Build for WordPress:
npm run build:wordpress:prod
The compiled file is output to sources/wordpress/assets/loader.js.