Synapse AI Autopilot - WHMCS Addon

Enterprise-grade AI automation for WHMCS hosting providers. Automatically resolve customer tickets using advanced AI with human oversight.

Features

• AI-Powered Resolution: Dual-LLM system with planner and verifier
• Smart VM Management: Automatic diagnostics and fixes for VPS/dedicated servers
• Multi-Platform Support: Proxmox, VirtFusion, Virtualizor integration
• Human Oversight: Configurable confidence thresholds and approval workflows
• Secure Communication: AES-256 encryption and HMAC signature validation
• Audit Trail: Immutable logging of all AI actions and decisions

Requirements

• WHMCS 8.0+
• PHP 8.0+
• OpenSSL extension
• cURL extension
• Active Synapse Control Panel license

Installation

1. Upload Files

Extract the addon to your WHMCS installation:

unzip synapse-whmcs-addon.zip
cp -r synapse/ /path/to/whmcs/modules/addons/

2. Activate Addon

1. Login to WHMCS Admin Area
2. Navigate to Setup → Addon Modules
3. Find "Synapse AI Autopilot" and click Activate
4. Click Configure to set up your license

3. Configuration

Required Settings:

• License Key: Your Synapse license key (format: SYN-XXXX-XXXX-XXXX)
• Backend URL: Your Synapse Control Panel URL
• Department Mapping: Configure which departments use AI automation

Optional Settings:

• Confidence Threshold: Minimum AI confidence required (default: 85%)
• Auto-Close: Automatically close resolved tickets
• Debug Mode: Enable detailed logging for troubleshooting

4. Test Connection

Use the built-in connection tester to verify:

• License key validation
• Backend connectivity
• Webhook signature verification

Configuration

Department Rules

Configure AI behavior per department:

• Observe: AI analyzes but takes no action
• Copilot: AI suggests actions requiring human approval
• Autopilot: AI executes safe actions automatically

Security Settings

• IP Whitelist: Restrict backend access to specific IPs
• Signature Validation: All webhooks verified with HMAC-SHA256
• Encryption: Ticket data encrypted with AES-256-GCM

API Integration

The addon communicates with your Synapse backend via secure webhooks:

Inbound (WHMCS → Synapse)

• New ticket creation
• Customer replies
• Ticket status changes

Outbound (Synapse → WHMCS)

• Post AI-generated replies
• Update ticket status
• Add internal notes

Troubleshooting

Common Issues

"License key invalid"

• Verify license key format: SYN-XXXX-XXXX-XXXX
• Check license status in Synapse Control Panel
• Ensure WHMCS URL matches licensed domain

"Backend unreachable"

• Verify backend URL and SSL certificate
• Check firewall rules and IP whitelist
• Test connectivity with built-in diagnostics

"Webhook signature mismatch"

• Verify license key matches backend configuration
• Check system clock synchronization
• Enable debug logging for detailed error info

Debug Mode

Enable debug logging in addon configuration:

// Check WHMCS System Logs for detailed output
tail -f /path/to/whmcs/storage/logs/laravel.log | grep Synapse

Support Logs

Generate support package for troubleshooting:

1. Admin Area → Synapse → Diagnostics
2. Click "Generate Support Package"
3. Send the generated ZIP to support@synapse.yecoai.com

Changelog

v1.0.0 (2026-07-12)

• Initial release
• Full AI automation pipeline
• Multi-platform VM management
• Security hardening
• Enterprise admin interface

License

Proprietary license. See LICENSE file for terms.

Support

• Documentation: https://docs.synapse.yecoai.com/whmcs
• Support Portal: https://support.synapse.yecoai.com
• Email: support@synapse.yecoai.com
• Enterprise Support: Available 24/7 for Business+ plans