@voxasphere/widget NPM

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?"
}