Quickstart

Install the website widget

Install the customer widget with a workspace ID. Pro workspaces can also create server-side API keys and signed outbound webhooks. There is no published @evnao/react package, so do not install one.

From setup to verified

WorkspaceConfigure

WidgetInstall

ProductionVerify

State remains inspectable

1. Finish workspace setup

Select Free, Starter, or Pro, complete onboarding, create at least one published knowledge article, and configure the widget’s brand and allowed domains.

Open the interactive installer

2. Copy the workspace-specific code

Use the dashboard installer for the real ID. The placeholder below will not load a widget.

Before the closing </body> tag

<script>
  window.EVNAO_CONFIG = { workspaceId: "YOUR_WORKSPACE_ID" };
</script>
<script src="https://evnao.com/widget.js" defer></script>

3. Restrict and verify

Add every production hostname under Widget Builder → Allowed domains. When the list is non-empty, the embed and chat API reject other parent origins.
Publish the script once. The loader reads its own origin, opens an isolated iframe, and listens only to resize messages from that iframe.
Run Verify installation from the dashboard with the public page URL, then test open, close, message, handoff, resolve, and rating on desktop and mobile.