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:

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

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

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

Plugin tags