Perfex CRM Integration for WHMCS
Perfex CRM Integration for WHMCS 将您的 WHMCS 计费平台与 Perfex CRM 安装连接起来，并自动让两者保持一致。客户、联系人、发票、付款、订单、服务、域名和支持工单近乎实时地在两个系统之间流转，因此您的 CRM 始终反映真实的计费状况，而您的计费系统也始终反映销售和支持团队在 CRM 中所做的操作。
免费版提供可靠的单向同步，将客户和联系人从 WHMCS 同步到 Perfex CRM。Pro 授权则解锁双向同步（在 Perfex 中的修改会回流到 WHMCS），另外还包括发票、付款、订单、支持工单、Perfex 中的服务与域名面板，以及用于导入既有历史数据的回填向导。
它解决的问题
WHMCS 是您的计费和开通系统。Perfex CRM 则是您管理潜在客户、项目、任务和客户关系的地方。如果两者之间没有桥梁，同一个客户会在两个数据库中各存在一份，而这两份副本会在几周内出现偏差。有人在 WHMCS 中更新了地址，另一个人在 Perfex 中记录了电话号码，于是两个系统都不再可信。
本产品消除了手工复制的工作。每一次相关变更都会产生一个事件，事件进入队列，队列再通过签名的 HTTPS 通道投递到另一个系统。
两个模块，缺一不可
本产品以两个组件发布，两者都必须安装。任何一半单独存在都无法发挥作用。
| 组件 | 安装位置 | 作用 | 授权方式 |
|---|---|---|---|
⚙️ perfexbridge（WHMCS 插件） | WHMCS，位于 modules/addons/perfexbridge | 付费模块。监听 WHMCS 事件，将其入队、签名并推送到 Perfex。保存所有同步设置和 Pro 授权密钥。在 WHMCS 后台中显示为 Perfex CRM Bridge。 | 默认为免费版。Pro 授权密钥可解锁 Pro 功能。 |
🧩 whmcs_bridge（Perfex CRM 配套模块） | Perfex CRM，位于 modules/whmcs_bridge | 免费的配套模块。接收签名事件，并将客户、联系人、发票、付款、潜在客户和工单写入 Perfex。在客户资料页渲染 WHMCS 选项卡。在 Perfex 后台中位于 Setup > WHMCS Bridge。 | 永久免费。永远不需要授权密钥。 |
如果只安装 WHMCS 插件，事件会堆积在队列中而无处投递。如果只安装 Perfex 配套模块，则永远不会有内容发送给它。使用哪个版本（免费版还是 Pro 版）完全由 WHMCS 端的授权密钥决定。无论哪种情况，Perfex 配套模块都完全相同。
两个组件使用相同的版本号，当前为 1.3.4，并且应始终一起更新。
产品全称是 Perfex CRM Integration for WHMCS。在两个应用内部，模块以更简短的名称标识自己：WHMCS 插件在 Addon Modules 下显示为 Perfex CRM Bridge，Perfex 配套模块在 Setup > Modules 下显示为 WHMCS Bridge。安装时请留意这两个名称。
免费版与 Pro 版对比
| 功能 | 免费版 | Pro 版 |
|---|---|---|
| 👥 客户单向同步，从 WHMCS 到 Perfex CRM | ✅ | ✅ |
| 👤 联系人单向同步，从 WHMCS 到 Perfex CRM | ✅ | ✅ |
| ⚡ 通过 WHMCS 钩子实时捕获事件，由 WHMCS 计划任务投递 | ✅ | ✅ |
| 🔗 使用连接代码一次粘贴完成配对 | ✅ | ✅ |
| ✅ 安装检查清单与 Test Connection | ✅ | ✅ |
| 📝 两端的活动日志 | ✅ | ✅ |
| 🔁 客户与联系人双向同步，Perfex 中的修改回流到 WHMCS * | ➖ | ✅ |
| 📄 发票镜像，WHMCS 发票生成对应的 Perfex 发票 * | ➖ | ✅ |
| 💳 付款与交易同步，镜像发票在 Perfex 中结清 * | ➖ | ✅ |
| 🛒 订单同步，WHMCS 订单转为 Perfex 潜在客户或客户备注 * | ➖ | ✅ |
| 🎫 支持工单同步，工单、回复和状态双向同步 * | ➖ | ✅ |
| 🌐 Perfex 客户资料页上的服务与域名面板 * | ➖ | ✅ |
| ⏬ 用于导入既有历史数据的回填向导 * | ➖ | ✅ |
| 🗂️ Perfex 中的工单部门映射下拉菜单 * | ➖ | ✅ |
| ⏱️ 为每个工单创建 Perfex 任务，以便使用原生工时表记录时间 * | ➖ | ✅ |
* 需要 Pro 授权。
所有 Pro 相关字段在免费版中都可见并可保存，只是在有效授权激活之前不会生效，管理 页面也会在每个字段旁说明这一点。购买和激活方法请参阅授权与 Pro 激活。
系统要求
| 要求 | 详情 |
|---|---|
| 🖥️ WHMCS | 8.x 或 9.x。已在 8.1.3 及以上版本测试。 |
| 🐘 PHP | 7.2 至 8.5。同一个构建版本可在所有这些环境中运行。两个模块都自带兼容性适配层，因此无需按 PHP 版本下载不同的安装包。 |
| 📇 Perfex CRM | 3.x，已在 3.4.0 上验证。 |
| 🔒 两端均需 HTTPS | 必需。 传输层强制使用 HTTPS 并验证 TLS 证书。按设计，纯 http:// 地址会导致每次发送都失败；Perfex 端的 WHMCS URL 字段也会拒绝保存不以 https:// 开头的地址。 |
| ⏰ WHMCS 系统计划任务 | 必须正在运行。桥接模块在计划任务触发时投递排队事件并重新校验授权。没有计划任务就不会投递任何内容。 |
| 🌐 网络（Pro 双向同步） | 您的 WHMCS 安装还必须能被 Perfex 服务器通过 HTTPS 访问。 |
| 🔌 PHP 扩展 | 两台服务器都需要 cURL。 |
这是"它从来不发送任何东西"最常见的原因。HTTP 传输层被限制为仅使用 https 协议，并在两端验证证书。只有当自签名证书在发起调用的服务器上确实能通过验证时，才可以使用。系统没有提供关闭该验证的设置，这是有意为之：共享密钥和您的客户数据都要经过这条通道传输。
一段话讲清同步原理
在管理员等待时，系统不会即时发送任何内容。WHMCS 钩子触发后，事件被写入**发件箱（outbox）**表，WHMCS 系统计划任务随后清空该队列，并通过 HTTPS 将每个事件 POST 到 Perfex。每个请求都使用两端共同持有的共享密钥进行 HMAC-SHA256 签名，并限制在 300 秒的重放窗口内。失败的请求会以逐步递增的退避间隔重试，在 15 次尝试后进入死信状态，等待运维人员检查。Pro 版的 Perfex 到 WHMCS 方向使用同一条签名通道的反向传输，由 Perfex 计划任务驱动。多层回声抑制机制可防止同一次变更在两个系统之间无限往返。完整说明请参阅工作原理与日常使用。
开始之前
准备好以下内容，整个配置过程大约需要十分钟：
- 同时拥有 WHMCS 和 Perfex CRM 的管理员权限。
- 能访问 WHMCS 服务器的主机面板 File Manager 或 FTP。WHMCS 没有后台内置的模块安装器。
- 两套系统均可通过 HTTPS 访问，且证书有效。
- 确认 WHMCS 系统计划任务正在运行。WHMCS 会在 Utilities > System > System Health Status 中显示最近一次计划任务的运行时间。
- 已下载并解压
upload.zip(themesic.com/marketplace/whmcs-perfex.zip)，从中得到whmcs-addon/addon.zip和perfex-module/module.zip。
接下来做什么
- 安装 - 先安装 Perfex 配套模块，再安装 WHMCS 插件，并绕过 Access Control 这个常见陷阱。
- 配置 - 用一个连接代码完成两端配对，然后设置各项选项。
- 授权与 Pro 激活 - 购买、激活、验证和移除 Pro 授权。
- 工作原理与日常使用 - 同步引擎、各类数据的同步方向、日志位置以及回填向导。
- 故障排查 - 每一种常见故障，及其成因和解决办法。
WHMCS 是 WHMCS Ltd. 的商标。Perfex CRM 是 MSTdev 的商标。Themesic Interactive 是独立开发商，与上述两家公司均无隶属关系，也未获得其认可或赞助。