Wocha Docs

Enterprise widgets

SSO, SCIM, and audit widgets for customer self-service enterprise setup.

Wocha provides embeddable enterprise widgets for customer self-service: SSO configuration, SCIM provisioning, and audit log viewing. Import from @wocha/ui or the dedicated enterprise entry point.

Installation

pnpm add @wocha/ui @wocha/react
Or scaffold with the CLI
npx @wocha/cli init --framework nextjs
import { WochaSSOWidget, WochaSCIMWidget, WochaAuditWidget } from "@wocha/ui";
 
// Or the combined enterprise setup flow
import { EnterpriseSetup, SSOSetup, SCIMSetup, DomainVerification } from "@wocha/ui/enterprise";

WochaSSOWidget

Multi-step SSO setup wizard (SAML or OIDC).

<WochaSSOWidget
  organisationId="org_abc123"
  apiUrl="https://acme.api.wocha.ai/v1"
  accessToken={accessToken}
  onComplete={() => router.push("/settings/security")}
/>
PropTypeDefaultDescription
organisationIdstring—Organisation to configure
apiUrlstring—Customer API base URL
accessTokenstring—OAuth access token (fetched from context if omitted)
onComplete() => void—Called when setup finishes
appearanceWochaAppearance—Visual customisation
classNamestring—Additional class name

WochaSCIMWidget

SCIM credential management and IdP setup guides.

<WochaSCIMWidget
  organisationId="org_abc123"
  apiUrl="https://acme.api.wocha.ai/v1"
/>
PropTypeDefaultDescription
organisationIdstring—Organisation to configure
apiUrlstring—Customer API base URL
accessTokenstring—OAuth access token
onComplete() => void—Called when SCIM is enabled
appearanceWochaAppearance—Visual customisation
classNamestring—Additional class name

WochaAuditWidget

Filterable audit log viewer with export.

<WochaAuditWidget
  organisationId="org_abc123"
  apiUrl="https://acme.api.wocha.ai/v1"
  maxEvents={100}
  autoRefresh
  autoRefreshIntervalMs={30000}
/>
PropTypeDefaultDescription
organisationIdstring—Organisation whose logs to display
apiUrlstring—Customer API base URL
accessTokenstring—OAuth access token
maxEventsnumber—Maximum events to fetch
eventTypesstring[]—Filter by event type
autoRefreshboolean—Periodically refresh logs
autoRefreshIntervalMsnumber—Refresh interval in milliseconds
appearanceWochaAppearance—Visual customisation
classNamestring—Additional class name

Enterprise setup bundle

The @wocha/ui/enterprise entry provides a tabbed setup experience with domain verification:

import { EnterpriseSetup } from "@wocha/ui/enterprise";
 
<EnterpriseSetup
  portalToken={portalToken}
  portalBaseUrl="https://console.wocha.ai"
  onComplete={() => console.log("Setup complete")}
/>

Theming

<WochaThemeProvider appearance={{ variables: { "--wocha-color-primary": "#2563eb" } }}>
  <WochaSSOWidget organisationId={orgId} apiUrl={apiUrl} />
</WochaThemeProvider>

Framework notes

Widgets require a valid access token and Customer API apiUrl. Generate portal tokens from the Wocha Console for embedded setup flows.

Previous

Modal

Next

MFA API

On this page