🛡️ VoiceGuard - AI-Powered Voice Scam Detection

VoiceGuard is an intelligent voice call analysis platform that detects and prevents scam calls in real-time using advanced AI technology. Built with React, Node.js, and the Retell API, VoiceGuard provides comprehensive protection against phone scams with detailed analytics and insights.

✨ Features

🎯 Core Capabilities

• Real-time Scam Detection - AI-powered analysis of voice calls to identify potential scams
• Interactive Voice Calls - Integrated with Retell API for live call handling
• Comprehensive Dashboard - View key metrics, trends, and insights at a glance
• Conversation Analytics - Detailed transcripts and analysis of all calls
• Smart Labeling - Categorize calls as scam, legitimate, or suspicious
• Export Functionality - Download conversation data in CSV format

📊 Dashboard Metrics

• Total calls processed
• Scam detection rate
• Customer churn & retention analysis
• Real-time feedback tracking
• Trending patterns and insights

🎨 Modern UI/UX

• Beautiful landing page with smooth animations
• Responsive design for all devices
• Dark mode optimized
• Intuitive navigation and user flows

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• PostgreSQL database
• Retell API account and credentials

Installation

1. Clone the repository

git clone https://github.com/shaibaank/customer-support-n8n.git
cd customer-support-n8n

2. Install frontend dependencies

npm install

3. Install backend dependencies

cd server
npm install

4. Set up environment variables

Create a .env file in the server directory:

DATABASE_URL="postgresql://username:password@localhost:5432/voiceguard"
RETELL_API_KEY="your_retell_api_key"

5. Initialize the database

cd server
npx prisma migrate dev
npx prisma db seed

6. Start the application

Terminal 1 (Backend):

cd server
npm start

Terminal 2 (Frontend):

npm run dev

The app will be available at http://localhost:5173

📁 Project Structure

voiceguard/
├── src/
│   ├── Components/
│   │   ├── Hero.jsx              # Landing page with beautiful design
│   │   ├── Dashboard.jsx         # Analytics dashboard
│   │   ├── Conversations.jsx    # Call history and transcripts
│   │   ├── Call.jsx              # Live call interface
│   │   ├── Login.jsx             # Authentication
│   │   └── Navbar.jsx            # Navigation
│   ├── hooks/
│   │   ├── useAuth.js            # Authentication hook
│   │   ├── usePhoneCall.js       # Call management hook
│   │   └── useDebounce.js        # Utility hook
│   ├── styles/
│   │   └── colors.css            # Brand colors and themes
│   └── App.jsx                   # Main app component
├── server/
│   ├── server.js                 # Express server
│   ├── retellClient.js           # Retell API integration
│   ├── db.js                     # Database connection
│   ├── routes/
│   │   └── conversations.js      # API routes
│   └── prisma/
│       ├── schema.prisma         # Database schema
│       └── seed.js               # Sample data
└── README.md

🔧 Technology Stack

Frontend

• React 18 - UI framework
• Vite - Build tool and dev server
• Framer Motion - Smooth animations
• Lucide React - Beautiful icons
• React Router - Navigation
• TailwindCSS - Utility-first styling

Backend

• Node.js & Express - Server framework
• Prisma - Database ORM
• PostgreSQL - Database
• Retell API - Voice call handling
• CORS & Body Parser - Middleware

🎮 Usage

Making a Call

1. Navigate to the Call section
2. Enter the phone number to test
3. Click "Start Protected Call"
4. VoiceGuard will analyze the conversation in real-time

Viewing Analytics

1. Access the Dashboard to see overall metrics
2. View conversation history in the Conversations section
3. Click on any call to see detailed transcript and analysis
4. Label calls as scam/legitimate for improved detection

Exporting Data

1. Navigate to Conversations
2. Click "Export CSV" to download all call data
3. Use the data for further analysis or reporting

🔐 Security Features

• End-to-end call encryption
• Secure authentication system
• Protected API endpoints
• Environment variable protection
• SQL injection prevention via Prisma

📊 API Endpoints

Calls

• POST /api/create-phone-call - Initiate a new call
• GET /api/health - Health check

Conversations

• GET /api/conversations - List all conversations
• GET /api/conversations/:id/transcript - Get transcript
• POST /api/conversations/ingest - Store conversation data
• POST /api/conversations/:id/label - Label a conversation
• GET /api/conversations/export/csv - Export data

🎨 Customization

Brand Colors

Edit src/styles/colors.css to customize the color scheme:

--brand-1: #your-primary-color;
--brand-2: #your-secondary-color;

Landing Page

Modify src/Components/Hero.jsx to update:

• Hero section content
• Feature highlights
• Testimonials
• Pricing plans

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Authors

• Shaib - @shaibaank

🙏 Acknowledgments

• Retell API for voice call infrastructure
• The React and Node.js communities
• All contributors and testers

📞 Support

For support, email support@voiceguard.com or open an issue on GitHub.

🗺️ Roadmap

• Multi-language support
• Mobile app (iOS/Android)
• Advanced ML model training
• Integration with CRM systems
• Real-time team collaboration
• Custom alert configurations

---

Made with ❤️ by the VoiceGuard Team