Widget Integration Overview

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:

1. Load: Async script loads without blocking your page
2. Initialize: Widget initializes with your publishable key and configuration
3. Ready: Chat interface is ready for user interaction
4. Context-Aware: Automatically detects page content for better responses
5. Interactive: Users can chat, select text, and get instant AI assistance

Getting Started

Ready to add the SiteAssist widget to your website?

1. Install the widget - Choose your integration method
2. Configure options - Customize appearance and behavior
3. Use the API - Control the widget programmatically
4. 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.