Web Widget Profile Settings
Configure the appearance, interaction behavior, and conversation lifecycle settings for a Web widget profile.
The Settings tab of a Web widget profile controls how the widget looks and behaves on your website – from the teaser message and branding to conversation lifecycle and available interaction tools.
Teaser
The teaser is the small text bubble displayed next to the collapsed widget to invite users to interact.
| Field | Description |
|---|---|
| Teaser message | Short text shown next to the widget when collapsed (e.g., "Hi! Need help?") |
Keep the teaser short, friendly, and relevant to the page context. It is the first thing users see and should clearly signal what the virtual being can help with.
AI Disclaimer
When enabled, a brief disclosure message is shown to users indicating they are interacting with an AI assistant. This supports transparency requirements and helps set user expectations.
| Field | Description |
|---|---|
| AI Disclaimer | Toggle to show/hide the disclaimer. When on, the disclaimer text appears on the bottom of the widget. |
Conversation Start Settings
Control when the conversation automatically starts (before the user explicitly opens the widget):
| Option | Description |
|---|---|
| Page focused | Conversation starts when the page is in focus (the tab is active and the user is viewing it). More proactive – good for high-intent landing pages. |
| Widget focused | Conversation starts when the widget is focused on. Less intrusive – better for general website pages. |
| Manual only (both options turned off) | The virtual being does not auto-start; the user must click to open and begin the conversation. |
Conversation Signals Settings
Signals are events fired at specific points in the conversation lifecycle. These are used in the Conversation Editor (Handlers and Route by Signal nodes) to drive logic:
| Signal | Description |
|---|---|
| Start signal | Fires when a new conversation session begins. Used to trigger On conversation-start handler logic. |
| Interrupt signal | Fires when the user manually interrupts the virtual being's response (e.g., pressing the stop button mid-speech). Off by default. Enable only if your flows handle this event explicitly. |
| Stop signal | Fires when the conversation ends (session timeout, session reset, end conversation flow reached). Used to trigger On conversation-stop handler logic. |
Conversation Settings on Page Refresh
Controls whether the conversation persists or resets when the page is reloaded:
| Option | Description |
|---|---|
| Always | A new conversation starts on every page load. Best for public or shared devices. |
| After [X] minutes | The conversation resets if the user has been inactive for longer than X minutes. Maximum: 720 minutes. Good for general website use. |
| Never | The conversation persists across page refreshes indefinitely. Best for complex, multi-step interactions where continuity matters. |
Widget Configuration
Control which UI elements are shown to users:
Communication
| Option | Description |
|---|---|
| Show chat | Display the conversation transcript panel |
| Show text input | Allow users to type messages |
| Show recording button | Allow users to send voice input |
Accessibility
| Option | Description |
|---|---|
| Show subtitles | Display spoken text as on-screen subtitles – essential for noisy environments or hearing accessibility |
| Show mute button | Allow users to mute the virtual being's audio output |
| Muted on start | Virtual being starts muted; user can unmute manually, recommended for websites |
Controls
| Option | Description |
|---|---|
| Show reset button | Display a button allowing users to restart the conversation from the beginning |
Customize 3D Scene
Configure the visual environment around the avatar:
| Option | Description |
|---|---|
| Ground color | Color of the base surface the avatar stands on |
| Skybox color | Background environment color |
| Custom background | Upload a custom image as the widget background |
Choose neutral colors that don't compete with the avatar for attention.
Customize Widget UI
Brand the widget to match your visual identity (availability depends on subscription plan):
| Option | Description |
|---|---|
| Background color | Main background color of the widget panel, and chat |
| Text color | Color of conversation text – ensure sufficient contrast |
| Accent color | Highlights buttons and interactive elements |
| Show/hide Virbe logo | Control whether the Virbe branding is visible in the widget footer |
All colors should follow your brand guidelines while meeting accessibility contrast standards.
Profile Settings
Touchpoint-specific configuration for the Settings tab of a Profile – Web widget appearance and behavior, or Metahuman Kiosk hardware and scene setup.
Metahuman Kiosk Profile Settings
Configure behavior, focus state, camera angle, hardware signals, and security for a Metahuman Kiosk profile.