Widget Integration Overview
Learn how to integrate and customize the SiteAssist chat widget on your website
What is the SiteAssist Widget?
The SiteAssist widget is a powerful, customizable chat interface that brings AI-powered assistance directly to your website visitors. It's designed to be lightweight, fast, and easy to integrate while providing a rich, interactive experience.
Key Features
🎨 Fully Customizable
- Multiple widget types (floating bubble, sidepanel, iframe)
- Theme support (light, dark, auto)
- Customizable colors, positioning, and styling
- Brand-aligned appearance
💬 Intelligent Text Selection
- Users can select text on your page and instantly ask the AI about it
- Context-aware responses based on selected content
- Configurable selection areas (restrict to specific content sections)
- Seamless integration with page content
📱 Responsive Design
- Works perfectly on desktop, tablet, and mobile devices
- Automatic fullscreen mode on mobile
- Adaptive layout based on screen size
⚡ Performance Optimized
- Lightweight script (~10KB gzipped)
- Async loading doesn't block page rendering
- Minimal impact on site performance
🔒 Privacy & Security
- Secure publishable key authentication
- No tracking of user data without consent
- GDPR compliant
Widget Types
SiteAssist offers three integration methods to fit different use cases:
Floating Bubble
The most popular option - a floating chat button that appears in the corner of your website.
Best for:
- Marketing websites
- E-commerce stores
- General business websites
- Blogs and content sites
Features:
- Unobtrusive when closed
- Expandable chat interface
- "Ask AI" button with text selection support
- Configurable text selection areas
- Customizable position (bottom-left or bottom-right)
Sidepanel
A fixed side panel that integrates with your website's layout.
Best for:
- Web applications
- Dashboards
- Admin panels
- SaaS products
Features:
- Always visible or toggleable
- Pushes page content when opened
- Seamless integration with app layout
- Customizable container selector
Iframe Embed
A simple iframe for full control over placement and styling.
Best for:
- Custom implementations
- Embedded in specific pages
- Full-page chat experiences
- Custom layouts
Features:
- Direct embedding anywhere on your page
- Complete control over size and placement
- No additional UI elements
- Standalone chat interface
How It Works
The SiteAssist widget follows a simple lifecycle:
- Load: Async script loads without blocking your page
- Initialize: Widget initializes with your publishable key and configuration
- Ready: Chat interface is ready for user interaction
- Context-Aware: Automatically detects page content for better responses
- Interactive: Users can chat, select text, and get instant AI assistance
Getting Started
Ready to add the SiteAssist widget to your website?
- Install the widget - Choose your integration method
- Configure options - Customize appearance and behavior
- Use the API - Control the widget programmatically
- Explore advanced features - Unlock powerful capabilities
Browser Support
The SiteAssist widget works on all modern browsers:
- ✅ Chrome 90+
- ✅ Firefox 88+
- ✅ Safari 14+
- ✅ Edge 90+
- ✅ Mobile browsers (iOS Safari, Chrome Mobile, Samsung Internet)
Note: Internet Explorer is not supported. For legacy browser support, please contact our team.
Need Help?
Have questions about widget integration? We're here to help!
- Documentation: Browse our comprehensive guides
- Support: Email us at support@siteassist.io
- Community: Join our Discord community (coming soon)
Let's get your AI assistant integrated! Continue to the installation guide to begin.