Voxasphere Widget

A lightweight, customizable sales call widget for instant customer communication on your website

✨ Features

• 🎤 High-Quality Audio: Echo cancellation, noise suppression, and auto gain control
• 🔄 Multiple Variants: Choose from Full, Expand, or Compact widget layouts
• 📊 Audio Visualization: Real-time audio level visualization
• ⚡ Lightweight: Minimal bundle size with optimized performance
• 🔒 Secure: Built with security-first approach and permission handling
• 🌐 Easy Integration: Simple script-based installation

🚀 Quick Start

Add the widget to your website by including this script:

<script>
  // Initialize _voxa queue before loading widget
  window._voxa = window._voxa || [];
  window._voxa.widgetId = "your-widget-id";
</script>
<script
  async
  src="https://unpkg.com/@voxasphere/widget@latest/dist/widget.js"
></script>

🔧 Configuration

All widget configuration is managed through the Voxasphere dashboard. The widget will automatically fetch its configuration using the provided widgetId.

Widget Variants

• FULL: Complete widget with all features visible
• EXPAND: Collapsible widget that expands on interaction
• COMPACT: Minimal widget for space-conscious layouts

Audio Features

The widget includes advanced audio processing capabilities:

• Echo cancellation
• Noise suppression
• Auto gain control
• Real-time audio visualization
• Automatic microphone permission handling

Configuration Options

interface WidgetConfig {
  variant: "FULL" | "EXPAND" | "COMPACT";
  avatar: {
    color1: string;
    color2: string;
  };
  backgroundColor: string;
  textColor: string;
  buttonColor: string;
  buttonTextColor: string;
  borderColor?: string; // default: "#e1e1e1"
  borderRadius?: string; // default: "8px"
  buttonRadius?: string; // default: "4px"
  startCallText?: string; // default: "Start Call"
  endCallText?: string; // default: "End Call"
  expandText?: string; // default: "Need Help?"
}

📱 Mobile Support

The widget follows a mobile-first approach and automatically adapts to different screen sizes:

• Responsive layout adjustments
• Touch-friendly interactions
• Optimized performance on mobile devices
• Automatic audio device handling

🔒 Security

• Secure audio permission handling
• No data collection or tracking
• Secure communication protocols
• Regular security updates

📄 License

MIT

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.