Plugin Overview

Voxfor Secure Live Chat and AI Support is a comprehensive live chat solution designed specifically for WordPress websites. It provides real-time communication between website visitors and administrators with a focus on performance, security, and user experience.

Key Features

Installation Guide

System Requirements

Installation Methods

Method 1: WordPress Admin (Recommended)

1. Log in to your WordPress admin dashboard
2. Navigate to Plugins → Add New
3. Search for "Voxfor Secure Live Chat"
4. Click Install Now and then Activate

Method 2: Manual Upload

1. Download the plugin ZIP file
2. Go to Plugins → Add New → Upload Plugin
3. Choose the ZIP file and click Install Now
4. Click Activate Plugin

Quick Start Guide

Get Started in 5 Minutes

1. Access Plugin Settings:

   Go to WP Chat → Settings in your WordPress admin

2. Configure Basic Settings:
   • Set your widget title and welcome message
   • Choose widget position (bottom-right, bottom-left, etc.)
   • Select your brand color
3. Set Agent Status:

   Go to WP Chat → Live Chat and set your status to "Online"

4. Test the Widget:

   Visit your website frontend to see the chat widget in action

5. Optional - Configure AI:

   Add your Anthropic API key in AI Agent → API for automated responses

Live Chat System

The live chat system provides real-time communication with visitors through an elegant, mobile-responsive widget and comprehensive admin interface.

Chat Widget Features

• Real-time Messaging: Instant message delivery using AJAX polling
• File Sharing: Secure upload/download with configurable file types and size limits
• Mobile Optimized: Touch-friendly interface with responsive design
• Multi-language Support: Translation-ready with RTL language support

Agent Status Management

Agents can set their availability status to control how chats are handled:

User Management & Banning

Comprehensive user management system to maintain a safe chat environment:

Banning System Features

• Instant User Banning: Ban users directly from the chat interface
• Flexible Ban Duration: Set temporary or permanent bans
• Multiple Ban Criteria: Ban by IP address, browser fingerprint, or both
• Ban Track Date: Track users date and time of banned
• Easy Unban Process: Remove bans when appropriate

Banning Process

1. Select the problematic chat from the sidebar
2. Click the "Ban User" button in the chat header
3. Enter a reason for the ban (required)
4. Select the ban duration
5. Confirm the ban action
6. The user is immediately blocked from accessing chat

AI Agent (Anthropic Claude)

The AI Agent automates frontline support using Anthropic Claude, delivering fast, context-aware, multilingual replies that follow your rules. It works alongside your team, responds when humans are unavailable (or in hybrid mode), and uses your site's content and the visitor's current page to give accurate answers.

AI Capabilities

AI Configuration

Configure the AI agent at WP Chat → AI Settings:

Basic Settings

AI Personality (System Prompt)

Define how the AI should behave and respond to users:

You are a helpful customer service assistant for {Brand}. Be friendly, concise, and accurate.
Always reference current page context when helpful. If a question requires human approval,
collect details and escalate. Never speculate; if unsure, ask for clarification. Prefer linking
to on-site pages or products with short summaries.

Knowledge Base Management

The Knowledge Base system powers the AI agent with up-to-date information about your website and business. It automatically scans your content and allows manual editing for accuracy.

Knowledge Base Features

• Automatic Content Scanning: Discovers and indexes website content automatically
• Manual Content Management: Add, edit, and organize custom knowledge
• Real-time Updates: Keep AI knowledge current with latest changes
• Content Categories: Organize information by type and topic
• AI Integration: Knowledge directly powers AI responses

Content Types Managed

Knowledge Management Workflow

1. Automatic Scanning: System scans your website for content
2. Content Discovery: Identifies pages, posts, products, and business info
3. Knowledge Processing: Extracts key information and creates summaries
4. Manual Review: Admin can edit, enhance, or remove content
5. AI Integration: Knowledge becomes available to AI agent
6. Continuous Updates: Regular rescanning keeps information current

Managing Knowledge Base

Access the Knowledge Base manager at WP Chat → AI Settings → Knowledge Base:

// Scan website content
Click "Manage Knowledge Base" → "Scan Website Content"

// Edit knowledge items
Select item → Edit inline → Save changes

// Add custom knowledge
Click "Add Custom Knowledge" → Enter title and content → Save

Analytics & Reports

Comprehensive analytics help you understand chat performance and visitor behavior with real-time data visualization and actionable insights.

Analytics Dashboard Features

• Real-time Statistics: Live chat counts, active users, and response times
• Historical Data: Customizable date ranges (7, 30, 90 days)
• Interactive Charts: Beautiful SVG charts with hover details
• Performance Monitoring: System health and optimization recommendations
• Agent Analytics: Individual performance tracking and comparison

Key Metrics Tracked

Chart Types & Visualizations

• Line Charts: Trend analysis over time periods with smooth animations
• Bar Charts: Comparative data visualization with color coding
• Pie Charts: Distribution and percentage breakdowns
• Gauge Charts: Performance indicators and KPI tracking
• Table Views: Detailed data with sorting and filtering

Live User Tracking

Advanced real-time visitor tracking system that monitors user behavior and provides insights for better customer engagement while respecting privacy.

Tracking Capabilities

• Real-time Visitor Monitoring: See who's on your site right now
• Page View Tracking: Monitor visitor navigation patterns
• Referrer Tracking: Track from which source the user came from
• Session Insights: Time on page, total session duration
• Device Information: Desktop, Mobile, Tablet
• Geographic Data: IP-based location tracking
• Engagement Scoring: Identify high-intent visitors

User Behavior Metrics

Privacy & Compliance

Bot Detection System

Advanced algorithms automatically identify and filter automated traffic:

• User Agent Analysis: Detect known bot signatures
• Behavioral Patterns: Identify non-human interaction patterns
• Speed Analysis: Flag unusually fast navigation
• JavaScript Execution: Verify browser capabilities
• Mouse Movement Validation: Detect natural vs. programmatic movement
• Fingerprint Analysis: Unique browser fingerprinting

Customization & Styling

Extensive customization options to match your brand and website design perfectly.

Widget Customization

Configure the chat widget appearance at WP Chat → Settings:

CSS Customization

Add custom styles to match your theme perfectly:

/* Main widget container */
.awc-chat-widget {
    border-radius: 15px !important;
    box-shadow: 0 10px 30px rgba(0, 0, 0, 0.2) !important;
}

/* Widget header */
.awc-widget-header {
    background: linear-gradient(45deg, #007cba, #005a87) !important;
    color: white !important;
}

/* Message bubbles */
.awc-message.user {
    background: #007cba !important;
    color: white !important;
}

.awc-message.agent {
    background: #f1f3f4 !important;
    color: #333 !important;
}

/* Send button */
.awc-send-button {
    background: #007cba !important;
    border-radius: 50% !important;
}

Mobile Responsiveness

Advanced Customization

• Template Override: Create custom templates in your theme
• Hook Integration: Use WordPress hooks to modify behavior
• Conditional Display: Show/hide widget based on page, user role, or device
• Custom Fields: Add additional data collection fields

Troubleshooting

Common Issues & Solutions

Database Repair Tool

If you encounter database-related issues, use the built-in repair tool:

1. Go to Tools → AWC Database Repair
2. Review missing tables
3. Click Repair Database Tables
4. Reactivate the plugin if needed

Performance Optimization

• Increase Polling Interval: Reduce server load by increasing message check frequency
• Enable Database Cleanup: Automatically remove old chat data
• Optimize Server Resources: Ensure adequate memory and processing power
• Use Caching: Compatible with popular caching plugins
• Limit Concurrent Chats: Set maximum simultaneous conversations

Frequently Asked Questions

Technical Requirements