Web SDK

Commands

Open, update, identify, track and shut down the widget.

All commands

open

Web SDK 1.8.0

Opens the widget.

whazzup('open')

close

Web SDK 1.8.0

Closes the widget.

whazzup('close')

update

Web SDK 1.8.0

Updates page, title and language after navigation.

whazzup('update', { url: location.href, title: document.title, locale: 'en' })

identify

Web SDK 1.8.0

Links the session to a person and optionally a company - automatically from window.whazzupSettings or with a signed token.

window.whazzupSettings = {
  name: 'Ada Lovelace',
  email: 'ada@example.com',
  userId: '42',
  plan: 'pro',
  signedUpAt: '2025-04-01',
  monthlyValue: 49,
  company: { id: 'acme', name: 'Acme Inc', plan: 'business', size: 120, renewalDate: '2026-04-01' }
};
// or, verified:
whazzup('identify', { token: identityToken })

track

Web SDK 1.8.0

Sends a deliberately selected product event.

whazzup('track', { name: 'trial_started', properties: { plan: 'pro' } })

show / hide

Web SDK 1.8.0

Shows or hides the launcher.

whazzup('hide')
whazzup('show')

logout / reset

Web SDK 1.8.0

Fully ends the current widget session on sign-out or account switch.

whazzup('logout')
// or before switching accounts:
whazzup('reset')

shutdown

Web SDK 1.8.0

Hides the widget; destroy fully removes the instance.

whazzup('shutdown')
whazzup('shutdown', { destroy: true })