Directory / plugin
Zanderio AI
v1.8.0 · by Zanderio AI
Connect your WordPress / WooCommerce store to Zanderio's AI-powered Sales Agent.
About this plugin
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
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.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:
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 ci - Build for WordPress:
WIDGET_ENV=prod npm run build:wordpress
The compiled file is output to sources/wordpress/assets/loader.js.