WebIntegration Data Model

A Web Messenger is a WebIntegration record on your organisation. This is the field reference for what the dashboard stores; for the runtime config the widget consumes, see WidgetConfig.

Top-level

Field	Type	Meaning
`_id`	id	Integration id.
`name`	string	Internal label (1–100 chars). Not visitor-facing.
`publicKey`	string	Embed identity (`pk_live_…`). Public.
`allowedOrigins`	`string[]`	Origins permitted to load the widget. Enforced server-side.
`disabled`	boolean	When true, the widget is paused.
`defaultTab`	enum	Tab the widget opens on.
`createdAt` / `updatedAt`	datetime	Timestamps.

`aiAutoReply`

Field	Meaning
`mode`	`org-default`, `specific`, or `disabled`.
`assistantId`	Which AI assistant answers visitors (with `specific`).

`theme`

Field	Meaning
`light` / `dark`	Two palettes, each with the 15 tokens.
`radii`	`sm`, `md`, `lg`, `xl` (px).
`themeMode`	`light` / `dark` / `auto`.
`fontFamily`	Widget font stack.
`launcherPosition`	Screen corner for the launcher.

Palette tokens (×15, per mode): background, surface, surfaceElevated, text, textMuted, textSubtle, border, borderStrong, primary, primaryHover, primaryForeground, launcherBackground, launcherForeground, success, danger.

`features`

Surface toggles: home, messenger, help, news, profile.

`security`

Field	Meaning
`requireAuth`	Force sign-in before messaging.
`google.enabled` / `google.clientId`	Google sign-in.
`passkey.enabled`	Passkey sign-in.

`botProtection`

Field	Meaning
`turnstileEnabled`	Cloudflare Turnstile on/off.
`turnstileSiteKey`	Turnstile site key.

`branding`

Field	Meaning
`hidden`	Hide the "Powered by Wexio" badge. Pro+ only.

Media & avatars

Field	Meaning
`logo`	`light` and `dark` media uploads.
`operatorAvatars[]`	Each has `alt` text + a media reference.

Copy (translatable)

Translatable fields store the base value on the field and locale overrides in a matching …I18n field.

Field	Meaning
`greeting`	`headline`, `subheadline`. Overrides in `greetingI18n`.
`messenger`	Title, description, AI avatar, `commands`, `messages[]`, related-content + reaction toggles, profile field order. Overrides in `messengerI18n`.
`prechatForm`	`enabled` + `fields[]` (`kind`, `key`, `label`, `required`). Overrides in `prechatFormI18n`.
`homeLayout`	Ordered Home blocks. Per-locale copy in `homeLayoutI18n`.

`sounds`

Field	Meaning
`enabled` / `volume`	Master toggle + volume.
`inbound` / `outbound`	Each is a built-in preset id or an uploaded media reference.

Localisation

Field	Meaning
`defaultLocale`	Base language (default `en`).
`supportedLocales[]`	All offered languages.
`contentLocaleFallback`	Fallback for untranslated content.
`localeStrategy`	How the active locale is chosen per visitor.

Not on the record

Shared secret — returned only at creation/rotation, never stored on the read model or sent to the page.
Help articles / folders / tags and news posts / categories / tags — separate collections scoped to the integration.
Knowledge chunks — derived automatically from published help articles for AI retrieval.

WebIntegration Data Model

On this page