Skip to main content

Getting Started

The WHMCS Integration module for Perfex CRM provides seamless, automated synchronization of client and invoice data from your WHMCS billing platform directly into Perfex CRM. Designed as a one-way sync, WHMCS serves as the single source of truth โ€” all client records, invoices, and related billing data flow from WHMCS into Perfex CRM, ensuring your CRM always reflects the latest information without manual data entry.

This integration is ideal for hosting companies, SaaS providers, and service businesses that rely on WHMCS for billing but want to leverage Perfex CRM's powerful project management, lead tracking, and customer relationship tools.

Key Featuresโ€‹

  • Automated Client Sync โ€” client profiles created or updated in WHMCS are automatically mirrored in Perfex CRM, including contact details, company information, and custom fields
  • Invoice Synchronization โ€” invoices generated in WHMCS are pulled into Perfex CRM with full line-item detail, payment status, and due dates
  • One-Way Data Flow โ€” WHMCS remains the authoritative source; changes made in Perfex CRM are not pushed back to WHMCS, preventing accidental overwrites
  • Bulk Contacts & Groups โ€” import and organize WHMCS contacts into groups within Perfex CRM for targeted communication and management
  • Bot Automation โ€” configure automated actions triggered by sync events, such as sending welcome emails or assigning tasks when a new client is synced
  • Template Support โ€” use predefined templates for notifications and communications triggered by WHMCS sync events

Requirementsโ€‹

RequirementDetails
Perfex CRMv3.0 or higher
PHP7.4 or higher
WHMCSActive installation with API access enabled
WHMCS APIAPI credentials (Identifier and Secret) with appropriate permissions
ServercURL extension enabled, outbound HTTPS connectivity to WHMCS
info

The WHMCS API must be enabled and configured before you can connect the module. Refer to the WHMCS API documentation for instructions on generating API credentials.

Installationโ€‹

Follow these steps to install the WHMCS Integration module in your Perfex CRM instance:

  1. Log in to your Perfex CRM as an Administrator.
  2. Navigate to Setup > Modules from the main menu.
  3. Click the Upload Module button.
  4. Select the ZIP file downloaded from CodeCanyon and press Install.
  5. Once uploaded, locate the WHMCS Integration module in the modules list.
  6. Click Activate to enable the module.
  7. Enter your License Key when prompted to verify your purchase.

After successful activation, the WHMCS Integration module will appear in your Perfex CRM sidebar navigation.

tip

If the module does not appear in the sidebar after activation, clear your browser cache and refresh the page. If the issue persists, verify that your license key was accepted and the module status shows "Active" under Setup > Modules.

Post-Installation Checklistโ€‹

Before using the module, make sure you have completed the following:

  • WHMCS API credentials generated (Identifier and Secret)
  • API access restricted to your Perfex CRM server IP (recommended for security)
  • Module activated and license key verified
  • WHMCS URL accessible from your Perfex CRM server over HTTPS

What's Next?โ€‹

  • Configuration โ€” connect your WHMCS instance, configure API credentials, and set up sync preferences
  • Usage Guide โ€” learn how to run syncs, manage imported data, use bots, templates, and bulk contacts