Wix App

The Conferbot Wix app installs the AI chat widget on a Wix site. It handles OAuth via the Wix installer and pushes your bot ID and embed type into a Wix Embedded Script component, which Wix then renders on every page of the site.

See it in action

Paste the Chatbot ID in the app settings, save, and the chat is live (recorded against the mock Wix site from the e2e suite):

How it works

Install and runtime flow
user adds the app from the Wix App Market
  -> Wix opens {APP_URL}/auth/start?token=...
  -> we bounce to https://www.wix.com/installer/install (appId + redirectUrl)
  -> Wix redirects to /auth/callback?code=&instanceId=
  -> code exchanged at wixapis.com/oauth/access -> tokens stored per instance

merchant saves settings (/app -> /app/save)
  -> app pushes {{botId}}/{{embedType}} via POST wixapis.com/apps/v1/scripts
  -> Wix renders the embedded script (embedded-script.html) on every page
  -> loader boots window.ConferbotWidget(botId, embedType,
       { customData: { platform: "wix" } })

The embedded script boots the standard Conferbot web widget - appearance and behavior stay dashboard-driven.

Requirements

A Wix site
A Conferbot account with a published chatbot, or the built-in demo bot to try it first
Self-hosting the app: Node.js, a public HTTPS APP_URL, and an app in the Wix Dev Center with an Embedded Script component

Installation

Install the Conferbot app on your Wix site (OAuth via the Wix installer).
Open the app settings page and paste your Chatbot ID.
On save, the app pushes the bot ID and embed type to Wix's Embedded Script, which loads the widget on every page (placement: body end).

Running your own instance from source:

Create an app in the Wix Dev Center: add an Embedded Script component (paste embedded-script.html, declare the botId and embedType parameters, placement: body end, load on all pages), set the App URL to {APP_URL}/auth/start and the Redirect URL to {APP_URL}/auth/callback.
Copy .env.example to .env with the app ID/secret. APP_URL must be public HTTPS.
npm install && npm start, then install the app on a free Wix test site from the Dev Center.

Configuration

The only merchant-facing setting is the Chatbot ID - paste the bare ID, the full embed snippet, or a dashboard URL and it is extracted automatically. A one-click demo bot (691c970890527a0468f9b2c9) works without a Conferbot account. The settings page accepts either a signed ?instance= token (production, HMAC-verified with the app secret) or a bare ?instanceId= (draft/dev).

What the app passes to the widget

customData - platform: "wix". The Wix embedded script runs with the site visitor's page context; no logged-in user identity is passed by this integration.

Troubleshooting

💡

Widget blank after install?

Confirm the bot is published in the dashboard and the Chatbot ID is the 24-character hex value. The embedded script renders only after you save the settings once. The demo bot 691c970890527a0468f9b2c9 isolates setup problems from bot configuration.

Source

Open source (MIT) on GitHub: Conferbot/conferbot-wix. 10 tests cover instance-token verification, the installer redirect, OAuth code exchange, the embed-parameter push to the Wix API, output sanitization, and a real-browser widget mount.