Perfex CRM Integration for WHMCS
Perfex CRM Integration for WHMCS connects your WHMCS billing platform to your Perfex CRM installation and keeps the two in step automatically. Clients, contacts, invoices, payments, orders, services, domains and support tickets flow between the systems in near real time, so your CRM always reflects billing reality and your billing system always reflects what your sales and support teams did in the CRM.
The Free plan gives you reliable one-way sync of clients and contacts from WHMCS into Perfex CRM. A Pro licence unlocks two-way sync (edits made in Perfex flow back into WHMCS), plus invoices, payments, orders, support tickets, a services and domains panel inside Perfex, and a backfill wizard for your existing historical data.
The problem it solvesโ
WHMCS is your billing and provisioning system. Perfex CRM is where you run leads, projects, tasks and customer relationships. Without a bridge between them the same customer exists twice, in two databases, and the two copies drift apart within weeks. Somebody updates an address in WHMCS, somebody else logs a phone number in Perfex, and neither system is trustworthy any more.
This product removes the manual copying. Every relevant change raises an event, the event is queued, and the queue is delivered over a signed HTTPS channel to the other system.
Two modules, both requiredโ
The product ships as two components, and both must be installed. Neither half does anything useful alone.
| Component | Installed in | What it does | Licensing |
|---|---|---|---|
โ๏ธ perfexbridge (WHMCS addon) | WHMCS, at modules/addons/perfexbridge | The paid module. Listens to WHMCS events, queues them, signs them and pushes them to Perfex. Holds every sync setting and the Pro licence key. In the WHMCS admin it appears as Perfex CRM Bridge. | Free tier by default. A Pro licence key unlocks the Pro features. |
๐งฉ whmcs_bridge (Perfex CRM companion) | Perfex CRM, at modules/whmcs_bridge | The free companion. Receives the signed events and writes customers, contacts, invoices, payments, leads and tickets into Perfex. Renders the WHMCS tab on the customer profile. In the Perfex admin it appears under Setup > WHMCS Bridge. | Always free. No licence key, ever. |
Install only the WHMCS addon and events pile up in a queue with nowhere to land. Install only the Perfex companion and nothing ever sends it anything. The plan (Free or Pro) is decided entirely by the licence key on the WHMCS side. The Perfex companion is identical either way.
Both components carry the same version number, currently 1.3.4, and should always be updated together.
The product is Perfex CRM Integration for WHMCS. Inside the two applications the modules identify themselves more briefly: the WHMCS addon is listed as Perfex CRM Bridge under Addon Modules, and the Perfex companion is listed as WHMCS Bridge under Setup > Modules. Those are the names to look for while installing.
Free vs Proโ
| Capability | Free | Pro |
|---|---|---|
| ๐ฅ One-way client sync, WHMCS to Perfex CRM | โ | โ |
| ๐ค One-way contact sync, WHMCS to Perfex CRM | โ | โ |
| โก Real-time event capture through WHMCS hooks, delivered on the WHMCS cron | โ | โ |
| ๐ One-paste pairing with the Connection code | โ | โ |
| โ Setup checklist and Test Connection | โ | โ |
| ๐ Activity logs on both sides | โ | โ |
| ๐ Two-way client and contact sync, Perfex edits flow back into WHMCS * | โ | โ |
| ๐ Invoice mirroring, WHMCS invoices become Perfex invoices * | โ | โ |
| ๐ณ Payment and transaction sync, mirrored invoices settle in Perfex * | โ | โ |
| ๐ Order sync, a WHMCS order becomes a Perfex lead or a customer note * | โ | โ |
| ๐ซ Support ticket sync, tickets, replies and status in both directions * | โ | โ |
| ๐ Services and domains panel on the Perfex customer profile * | โ | โ |
| โฌ Backfill wizard for existing historical data * | โ | โ |
| ๐๏ธ Ticket department mapping dropdowns in Perfex * | โ | โ |
| โฑ๏ธ Per-ticket Perfex task for native timesheet time logging * | โ | โ |
* Pro licence required.
Every Pro field is visible and saveable on the Free plan. It simply has no effect until a valid licence is active, and the admin page says so next to each one. See Licensing and Pro activation for how to buy and activate.
Requirementsโ
| Requirement | Detail |
|---|---|
| ๐ฅ๏ธ WHMCS | 8.x or 9.x. Tested from 8.1.3 upwards. |
| ๐ PHP | 7.2 through 8.5. A single build runs on all of them. Both modules ship their own compatibility shims, so there is no separate download per PHP version. |
| ๐ Perfex CRM | 3.x, verified against 3.4.0. |
| ๐ HTTPS on both sides | Mandatory. The transport pins HTTPS and verifies the TLS certificate. A plain http:// URL fails every send by design, and the Perfex-side WHMCS URL field refuses to save unless it starts with https://. |
| โฐ WHMCS system cron | Must be running. The bridge delivers queued events and revalidates the licence on the cron tick. No cron means nothing is delivered. |
| ๐ Network, for Pro two-way sync | Your WHMCS installation must also be reachable from the Perfex server over HTTPS. |
| ๐ PHP extensions | cURL, on both servers. |
This is the single most common cause of "it never sends anything". The HTTP transport is restricted to the https protocol and validates the certificate on both ends. A self-signed certificate is acceptable only if it genuinely validates on the calling server. There is no setting to turn this off, and that is deliberate: the shared secret and your customer data travel over this channel.
How the sync works, in one paragraphโ
Nothing is sent inline while an admin waits. A WHMCS hook fires, the event is written to an outbox table, and the WHMCS system cron drains that queue and POSTs each event to Perfex over HTTPS. Every request is signed with HMAC-SHA256 using a shared secret that both sides hold, inside a 300-second replay window. Failures retry with growing backoff and, after 15 attempts, land in a dead-letter state for an operator to inspect. Pro's Perfex to WHMCS direction uses the same signed channel in reverse, driven by the Perfex cron. Layered echo suppression stops a single change bouncing between the systems forever. The full explanation is in How it works and daily use.
Before you startโ
Collect these and the whole setup takes about ten minutes:
- Admin access to both WHMCS and Perfex CRM.
- Access to your hosting panel's File Manager, or FTP, for the WHMCS server. WHMCS has no in-admin module installer.
- Both installations reachable over HTTPS with valid certificates.
- Confirmation that the WHMCS system cron is running. WHMCS reports the last cron run under Utilities > System > System Health Status.
- The
upload.zipyou downloaded from themesic.com/marketplace/whmcs-perfex.zip, unpacked so that you havewhmcs-addon/addon.zipandperfex-module/module.zip.
What's nextโ
- Installation - install the Perfex companion first, then the WHMCS addon, and get past the Access Control gotcha.
- Configuration - pair the two sides with a single Connection code, then set every option.
- Licensing and Pro activation - buy, activate, verify and remove a Pro licence.
- How it works and daily use - the sync engine, what syncs where, where the logs are, and the backfill wizard.
- Troubleshooting - every common failure, with its cause and its fix.
WHMCS is a trademark of WHMCS Ltd. Perfex CRM is a trademark of MSTdev. Themesic Interactive is an independent developer and is not affiliated with, endorsed by, or sponsored by either.