Widget Behavior
Configure how the widget interacts with visitors.
Auto-Open Settings
Auto-Open on Page Load
Automatically open the widget when a visitor lands on your site:
Enable: Yes/No
Delay: 0-60 seconds
Considerations:
- Can increase engagement but may feel intrusive
- Respects session state (won't re-open if user closed it)
- Best used with a delay of 3-5 seconds
Auto-Open for Returning Visitors
Only auto-open for visitors who have chatted before:
Enable: Yes/No
This is less intrusive as users are already familiar with your chat.
Sound Settings
Notification Sounds
| Setting | Description |
|---|---|
| New Message | Sound when a new message arrives |
| Widget Open | Sound when widget opens |
| Message Sent | Sound when customer sends a message |
Sound Options
- On - Always play sounds
- Off - Never play sounds
- Respect System - Follow browser/OS settings
Notification Settings
Desktop Notifications
Request permission to show browser notifications:
Enable: Yes/No
Show when widget is closed: Yes/No
Unread Badge
Show unread message count on the launcher:
Enable: Yes/No
Animation: Bounce/Pulse/None
Greeting Behavior
Welcome Greeting
Show an automated greeting when widget opens:
Enable: Yes/No
Message: "Hi! How can we help you today?"
Delay: 1 second
Proactive Greeting
Show a greeting bubble near the launcher:
Enable: Yes/No
Trigger: After 10 seconds on page
Message: "Need help? Chat with us!"
Session Behavior
Session Persistence
How chat history is preserved:
| Mode | Description |
|---|---|
| Persistent | Chat history saved across sessions |
| Session Only | History cleared when browser closes |
| None | History cleared when widget closes |
Visitor Identification
Automatically collected data:
- Browser fingerprint
- Referrer URL
- Current page URL
- Device type and OS
- Location (country/city from IP)
Offline Behavior
When no agents are available:
Offline Mode
| Mode | Description |
|---|---|
| Hide Widget | Widget launcher is not shown |
| Collect Contact | Show form to collect email/phone |
| AI Only | AI continues to respond |
| Leave Message | Allow customers to leave a message |
Offline Message
Customize the offline message:
"We're currently offline. Leave your email and we'll get back to you!"
Typing Indicators
Show Agent Typing
Display "Agent is typing..." when agents are composing:
Enable: Yes/No
Show Customer Typing
Let agents see when customers are typing:
Enable: Yes/No
Message Features
File Attachments
Allow customers to send files:
Enable: Yes/No
Max file size: 10MB
Allowed types: Images, PDFs, Documents
Emoji Picker
Show emoji picker in the message input:
Enable: Yes/No
Message Formatting
Support markdown in messages:
Enable: Yes/No
Input Settings
Placeholder Text
Customize the input placeholder:
"Type your message..."
Character Limit
Maximum characters per message:
Limit: 1000 characters
Show counter: Yes/No
Widget Minimization
Remember State
Remember if user minimized the widget:
Duration: Session / 24 hours / 7 days
Close Behavior
What happens when user clicks X:
| Behavior | Description |
|---|---|
| Minimize | Widget returns to launcher |
| End Chat | Conversation is marked resolved |
| Ask | Prompt user to confirm ending chat |
Mobile-Specific Behavior
Full-Screen Mode
On mobile, widget opens full-screen by default:
Enable: Yes/No
Touch Gestures
| Gesture | Action |
|---|---|
| Swipe down | Minimize widget |
| Swipe left | Go back (in flows) |
Keyboard Handling
Adjust layout when virtual keyboard appears:
Auto-scroll to input: Yes
Resize widget: Yes