Appearance
Live chat
init() mounts a chat bubble in the bottom-right corner. You need no extra code.
How it works
- A visitor clicks the bubble. The SDK creates or resumes their open conversation.
- Messages arrive live over a WebSocket. If the socket does not connect within about three seconds, the widget polls every four seconds while the panel is open.
- Sending a message always uses a normal HTTP request.
- Your team replies from the Inbox in the dashboard.
Outside business hours, the visitor sees your configured offline message. It is shown only in the widget and is not saved as a message.
Unread badge
The bubble shows a count of agent messages that arrived while the panel was closed. It resets when the panel opens.
Hide chat for some users
Pass disableChat: true to init(). Use it for your own staff. See init.
Several widgets in one corner
Chat, tour launchers, surveys and checklists can share a corner. The SDK stacks them so they do not overlap. You can choose which one sits closest to the corner in Workspace Settings → Widget priority.
Privacy
A conversation belongs to the browser that started it. Calling identify() does not give another browser access to it. Call reset() on sign-out so the next person on a shared browser starts fresh.