An intelligent customer support automation system powered by multiple AI providers (OpenAI, Claude, Gemini) that automatically categorizes, analyzes, and responds to customer inquiries with human-like understanding.
ReplyPilot AI is a modular PHP-based customer support automation platform designed to streamline email and form submissions processing. It features automatic ticket generation, intelligent categorization, AI-powered response generation, and comprehensive analytics tracking. The system supports multiple AI providers and includes both user-facing submission forms and a full-featured admin dashboard.
The system currently integrates the Envato Market license API and is designed to be easily extended to support other license APIs, and future use cases. It automatically replies to user messages in a custom tone (e.g., Friendly, Professional), categorizes submissions (Sales, Support, Spam), and stores everything securely in a MySQL database.
- 💬 Multi-Provider AI Integration: Seamlessly switch between OpenAI GPT, Anthropic Claude, and Google Gemini
- 🔒 Purchase Code Validation Via Envato Market API (optional)
- 🗂️ Intelligent Categorization: Automatically classify submissions into predefined categories
- 🤖 Smart Response Generation: Context-aware, personalized AI responses
- 🎟️ Ticket Tracking System: Unique ticket IDs for every submission with tracking interface
- 📊 Analytics Dashboard: Comprehensive metrics and reporting capabilities
- ⚡ Response Caching: Optimize API costs with intelligent response caching
- 📩 Email Notifications: Automated admin alerts and customer confirmations
- 🛡️ Security Focused: CSRF protection, input validation, and secure session handling
- 🌐 Cross-Platform: Works on Linux, and standard web hosting
- 🎯 Tone Selector For controlling the reply tone
- 📧 PHPMailer Integration To email AI replies to visitors and admin
- 📂 Modular Structure Using organized OOP-based architecture
- 🧪 Installer Tool For quick browser-based setup
- PHP: 7.4 or higher (8.0+ recommended)
- MySQL: 5.7+ or MariaDB 10.3+
- Web Server: Apache 2.4+ with mod_rewrite enabled
- PHP Extensions:
- PDO with MySQL driver
- cURL
- JSON
- Session
- OpenSSL
- Mbstring
- Backend: PHP 7.4+ with OOP architecture
- Database: MySQL/MariaDB with PDO
- Frontend: HTML5, CSS3, Vanilla JavaScript
- AI Providers: OpenAI API, Anthropic Claude API, Google Gemini API
- Architecture: MVC-inspired with Repository pattern
- Security: CSRF tokens, prepared statements, input sanitization
-
Download and Extract
# Download the latest release wget https://github.com/fluent-themes/replypilot-ai/archive/main.zip # Extract to your web server directory unzip main.zip -d /var/www/html/ cd /var/www/html/replypilot-ai
-
Set Directory Permissions
# Linux/Unix chmod 755 storage/ chmod 755 storage/logs/ chmod 755 storage/mail/ # Ensure web server can write chown -R www-data:www-data storage/
-
Configure Web Server
For Apache, ensure
.htaccessfiles are enabled:<Directory /var/www/html/replypilot-ai> AllowOverride All Require all granted </Directory>
-
Run Web Installer
Navigate to your installation URL with the setup token:
https://yourdomain.com/?page=install&token=setup123 -
Complete Installation Wizard
- Enter database credentials
- Configure AI provider API keys
- Set Envato API token (optional)
- Configure email settings (optional)
-
🔑 Security: Change Default Token
IMPORTANT: After installation, immediately change the default setup token:
- Login to admin panel:
https://yourdomain.com/admin/ - Navigate to Settings → Advanced Settings
- Update the installer token
- Save changes
- Login to admin panel:
-
Clone or Download Repository
git clone https://github.com/fluent-themes/replypilot-ai.git cd replypilot-ai -
Create Database
CREATE DATABASE replypilot_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'replypilot_user'@'localhost' IDENTIFIED BY 'strong_password'; GRANT ALL PRIVILEGES ON replypilot_db.* TO 'replypilot_user'@'localhost'; FLUSH PRIVILEGES;
-
Configure Environment
cp .env.example .env # Edit .env with your database and API credentials nano .env -
Run Database Migrations
php scripts/auto_migrate.php
The system is designed to work with minimal dependencies. Optional Composer support is available:
{
"require": {
"php": ">=7.4",
"ext-pdo": "*",
"ext-curl": "*",
"ext-json": "*"
}
}If you prefer using Composer for autoloading:
composer install --no-devThe system will automatically detect and use Composer autoloader if available, otherwise falls back to built-in autoloading.
-
🛑 500 Internal Server Error
- Check PHP error logs:
storage/logs/error.log - Verify
.htaccessis being processed - Ensure all required PHP extensions are installed
- Check PHP error logs:
-
🔗 Database Connection Failed
- Verify credentials in
.envfile - Check MySQL service is running
- Ensure database exists and user has permissions
- Verify credentials in
-
🤖 AI Provider Not Responding
- Verify API keys are correct
- Check API rate limits
- Review provider-specific error messages in logs
-
📧 Email Not Sending
- Verify SMTP settings in admin panel
- Check firewall rules for SMTP ports
- Test with
admin/send_email.php
Enable debug mode for detailed error messages:
-
Edit
.envfile:APP_DEBUG=true APP_ENV=development -
Check debug logs:
tail -f storage/logs/debug.log
- ⚡ Enable response caching in admin settings
- 🗄️ Configure proper MySQL indexes
- 🌐 Use CDN for static assets
- 🔥 Enable PHP OPcache
- Installation Guide:
INSTALL.md - Admin Manual:
docs/admin-guide.md - API Integration:
docs/api-integration.md - Troubleshooting:
docs/DEBUG.md
- Architecture Overview:
docs/architecture.md - Endpoint Map:
docs/audit/EndpointMap.md - Security Audit:
docs/security-audit.md - Contributing Guide:
CONTRIBUTING.md
.env.example- Production environment template.env.mockmode- Mock/Test environment template
- 🛡️ CSRF Protection: All forms include CSRF token validation
- 🗄️ SQL Injection Prevention: PDO prepared statements throughout
- ✨ XSS Protection: Input sanitization and output escaping
- ⏱️ Session Security: Secure session handling with timeout
- 🔑 Access Control: Admin authentication with guard middleware
- 📉 Rate Limiting: Built-in rate limiting for API endpoints
If you discover a security vulnerability, please email support@fluentthemes.com instead of using the issue tracker. All security vulnerabilities will be promptly addressed.
- 🔑 Always change default installer token after setup
- 🔒 Use strong passwords for admin accounts
- ♻️ Keep PHP and dependencies updated
- 📜 Regularly review access logs
- 🌐 Enable HTTPS in production
- 🖥️ Restrict admin panel access by IP if possible
This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details.
GPL-3.0-or-later License
Copyright (c) 2025 Md Mazharul Islam / Fluent-Themes
For support, please:
- 📖 Check the documentation in the
docs/directory - 🔍 Review closed issues on GitHub
- 📩 Contact support: support@fluentthemes.com
See CHANGELOG.md for a detailed list of changes and version history.
- Built with ❤️ using PHP
- Maintained by Fluent Themes
Current Version: 1.0.0 Last Updated: August 27, 2025 Status: Production Ready