授权与 Pro 激活
免费版是运行 Perfex CRM Integration for WHMCS 的一种受支持的永久方式。它可以实时地将客户和联系人从 WHMCS 单向同步到 Perfex。这部分功能永远不需要密钥。
Pro 授权解锁其余全部功能。本页介绍如何购买、激活、检查和移除它。
Pro 解锁了什么
| Pro 解锁的功能 | 在日常工作中意味着什么 |
|---|---|
| 🔁 客户与联系人双向同步 | 在 Perfex 中更正的地址会按您选择的冲突策略回流到 WHMCS |
| 📄 发票镜像 | WHMCS 发票会出现在 Perfex 客户下，包含行项目、税费行和状态 |
| 💳 付款与交易同步 | 已支付的 WHMCS 发票会把其 Perfex 镜像标记为已付款，并记录支付网关和交易 ID |
| 🛒 订单同步 | WHMCS 订单会变成 Perfex 潜在客户、客户备注，或者完全不同步，由您决定 |
| 🎫 支持工单同步 | 工单、回复和状态变更双向流转，并可选为每个工单创建 Perfex 任务以便记录工时 |
| 🌐 服务与域名面板 | 每个 Perfex 客户资料页上都会有一个 WHMCS 选项卡，列出该客户的服务和域名 |
| ⏬ 回填向导 | 导入既有的客户、发票、服务和域名，而不仅仅是 新增的活动 |
| 🗂️ 部门映射下拉菜单 | 通过从列表中选择来映射 WHMCS 工单部门与 Perfex 部门，而不必手动输入 ID |
完整的逐项对比请参阅免费版与 Pro 版对比表。
Perfex 配套模块是免费的，永远不持有密钥。由 WHMCS 插件决定使用哪个版本，并把结果告知 Perfex，这样 Perfex 设置页面才能说明双向同步为何在运行或未运行。您的授权密钥本身绝不会传输到 Perfex。
购买 Pro：结账浮层
这是最快捷的方式，完全不需要复制粘贴。
- 在任意一端的管理页面上，点击升级链接：
- WHMCS：Addons > Perfex CRM Bridge。该链接在 Pro License Key 输入框旁显示为 Buy a Pro licence，在授权检查项一行和 Pro 功能提示框中显示为 Upgrade to Pro。
- Perfex：Setup > WHMCS Bridge 的 WHMCS plan 面板中的 Upgrade to Pro 按钮。
- 一个安全的结账浮层会就地打开，覆盖在您当前所在的页面上。
- 完成购买。
- 激活会自动完成：
- 从 WHMCS 发起：结账响应中返回的授权密钥会被写入设置表单自己的 Pro License Key 输入框，并自动为您提交该表单。保存操作会立即在线验证密钥、切换到 Pro 版，并把结果告知 Perfex 端，这一切都在同一个请求中完成。
- 从 Perfex 发起：密钥会通过签名的桥接通道转发到您的 WHMCS 安装。WHMCS 在存储任何内容之前先在线验证它，随后激活 Pro，并把最新的版本状态直接推送回来，因此 Perfex 的版本面板会就地切换为 Pro，无需刷新页面。Perfex 从不存储该密钥。
- Pro 立即生效。无需等待计划任务，也不用输入任何内容。
如果浮层脚本被浏览器扩展、严格的内容安全策略或缓慢的网络所阻断，该链接就会退回原本的行为，在新标签页中打开托管的结账页面。不会有任何功能损坏，您只需按下面的手动粘贴方式完成即可。
如果浏览器在激活完成前关闭了
您的密钥仍然安全。有两道保障，按顺序如下：
- 在页面上。 如果购买成功但自动激活未能执行，密钥会显示在页面上一个可选中的字段中，Perfex 端还带有 Copy 按钮，并附有粘贴位置的确切说明。已付费的密钥绝不会只存在于一个已关闭的浮层内。
- 在您的收件箱中。 密钥在购买时一定会通过邮件发送给您，同时也可在支付服务商的客户门户中获取。如果浏览器恰好在关键时刻崩溃，请查收邮件。
然后按照下面的手动方式操作。
手动激活密钥
只要您已经拿到密钥，就可以使用这种方式：来自购买邮件、来自客户门户，或者需要把授权迁移到另一套 WHMCS 安装时。
- 在 WHMCS 中，打开 Addons > Perfex CRM Bridge。
- 滚动到 Settings > Pro licence。
- 将密钥粘贴到 Pro License Key 中。密钥以
sk_开头。 - 点击 Save Settings。
激活到此就全部完成了。保存一个确实发生变化的密钥时，系统会当场执行在线检查，因此页面返回时就已经显示您的版本状态了。您不需 要再点击任何按钮，也不需要等待计划任务。
横幅会明确告诉您三种情况之一：
| 横幅 | 含义 | 该怎么做 |
|---|---|---|
| 🟢 绿色 - "Settings saved. Licence verified - your Pro plan is active..." | 授权服务器确认了该密钥。页面标题和 License / plan 检查项已显示为 Pro，Pro 功能提示框已消失，回填向导也已解锁。 | 无需操作。已经完成。 |
| 🔴 红色 - "Settings saved. The licence server rejected this key..." | 密钥被拒绝，消息中会写明服务器给出的具体原因：未知密钥、订阅过期、授权已取消，或激活配额已用完。 | 请检查粘贴的密钥是否与购买邮件中完全一致，没有缺失或多余字符，然后再次保存。 |
| 🟠 琥珀色 - "Settings saved. Could not reach the licence server..." | 既不是通过也不是拒绝：您的服务器此刻无法连接到授权服务。 | 密钥已经保存，并会自动继续重试。请检查您的服务器能否通过 HTTPS 访问 api.freemius.com，然后点击 Check licence now。在此期间，宽限期会为您提供保护。 |
设置会在任何授权检查运行之前写入数据库，因此红色横幅绝不 表示"保存失败"，而是表示"已保存，但您的密钥被拒绝了"。您永远不必重新填写表单。
只有确实发生变化的授权密钥才会触发检查。暂停同步、修改订单同步目标或编辑工单回复管理员都不会发起任何网络请求，横幅也只会显示普通的 "Settings saved."。
Check licence now
Check licence now 按钮位于 WHMCS 模块页面顶部，紧邻 Test Connection 和 Run Sync Now。
它会忽略每天一次的频率限制，立即强制重新检查已存储的密钥。以下情况可以使用它：
- 您刚刚续订或延长了授权，希望马上恢复 Pro；
- 保存时返回了琥珀色横幅，而您此后已经修复了网络或防火墙问题；
- 您想在提交支持工单之前确认当前状态。
该按钮有几秒钟的防连击冷却时间。连按两次时，第 二次会回应"刚刚已检查过"，而不会发出第二个请求。等待几秒后即可正常再次检查。
如果完全没有存储密钥，该按钮会返回红色横幅，说明密钥为空且当前安装使用的是免费版。此时不会有任何请求离开您的服务器。
保持激活状态：每日重新校验与 14 天宽限期
密钥存储后，WHMCS 计划任务会每天重新校验一次。您无需做任何事情。
如果无法连接到授权服务，模块不会把您切换为关闭状态。这种情况会被理解为"我们还不知道"，而绝不是"被拒绝"，同时 14 天宽限期会在重试期间让 Pro 完全正常工作。
有三个细节值得了解：
- 宽限期从最近一次成功检查开始计时，而不是从最近一次尝试开始。页面上显示的倒计时是真实的剩余天数，不会因为每次重试失败而重置。
- 真正的拒绝会立即终止宽限期。 如果授权服务器明确表示该授权已过期、已取消或无效，那就是一个明确答复，宽限期不再适用。在防火墙上阻断授权端点并不能让一个已被吊销的授权继续存活。
- 宽限期只能延长，不能凭空启动。 从未被确认过的密钥没有宽限期可依靠。如果您在授权服务不可达时粘贴一个全新的密钥，该密钥会被存储并重试，但在检查真正成功之前 Pro 不会启用。
您可能在页面标题中看到的版本状态
| 标题文本 | 含义 |
|---|---|
Free plan - no licence key set. | 没有密钥。这是免费版，运行正常。 |
Pro license set - awaiting first verification. | 已存储密钥但从未被确认。请点击 Check licence now。 |
Pro active until YYYY-MM-DD (UTC) | 一切正常。 |
Pro active - lifetime licence | 无到期日期的授权。 |
Pro (grace) - could not reach the licence server, retrying daily. Pro keeps working for N more day(s). | 临时性中断。目前对您没有任何影响。 |
Free plan - this licence has expired. | 请续订，然后点击 Check licence now。 |
Free plan - this licence was cancelled. | 授权已取消或已退款。如果这是误判，请联系支持。 |
Free plan - the licence key was rejected. | 密钥错误，或激活配额已用完。消息中会带有服务器自己的说法。 |
Free plan - the licence server could not be reached and the grace period has run out. | 请修复到授权端点的连通性，然后点击 Check licence now。 |
同样的说明也会出现在安装检查清单的 License / plan 一行中，因此您不必到处寻找。
激活名额
一套 WHMCS 安装占用授权中的一个激活名额。模块只会生成一次稳定的标识符并永久复用，因此重新检查、重新保存或把站点迁移到其他域名都不会额外消耗一个名额。
如果您看到的拒绝信息提到该授权已在最大数量的安装上使用，那么请从不再需要它的安装中移除密钥以立即释放名额，或就配额问题联系支持。
移除密钥并回退到免费版
- 在 WHMCS 中，打开 Addons > Perfex CRM Bridge > Settings > Pro licence。
- 勾选 Remove the stored key (revert to Free)。
- 点击 Save Settings。
随后会发生什么：
- 无论缓存中还残留什么，该安装都会立即回退到免费版。Pro 功能停止工作。
- 激活名额被释放，该授权可以在另一套安装上激活。
- Perfex 端会被告知此次降级，因此它的 WHMCS plan 面板不会在当天剩余时间里继续显示 Pro。
如果您没有先移除密钥就删除了一套 WHMCS 安装，它的激活名额会一直被占用。移除密钥只需五秒钟，却能省去日后一次与支持的往返沟通。
Pro 结束后您的数据会怎样
不会有任何数据被删除。在免费版安装上：
- 客户和联系人同步继续正常工作，保持单向，与以往完全一致。
- WHMCS 停止将发票、付款、订单、服务、域名和工单事件入队。这道门槛设在源头，因此不会有任何积压，也不会有毫无意义的重试。
- 已经排队等待发往 WHMCS 的 Perfex 端变更会被拒绝，Outbound queue 面板上会显示清晰的 "Two-way sync requires Pro on the WHMCS side" 消息，随后重试，最终进入死信状态。
- 已经同步过的一切都会保留在 Perfex 中。客户资料页上的 WHMCS 选项卡仍会显示最后存储的快照，只是不再更新。
重新激活一个有效密钥后，一切都会在下一个事件到来时恢复。
授权故障排查
| 症状 | 原因 | 解决办法 |
|---|---|---|
| 保存密钥后看不到任何变化 | 您粘贴的是 已经存储的同一个密钥。只有发生变化的密钥才会触发检查。 | 点击 Check licence now。 |
| 每次都是琥珀色横幅 | 您的服务器无法通过 HTTPS 访问授权端点。 | 在 WHMCS 服务器上的出口防火墙或代理中放行到 api.freemius.com 的出站 HTTPS。然后点击 Check licence now。 |
| 密钥看起来没问题却提示 "The licence key was rejected" | 粘贴时被截断，或激活配额已用尽。 | 请从购买邮件中一次性重新复制完整密钥。密钥为 32 个字符，可能包含标点符号，因此不要删减任何内容。如果消息中提到安装数量，请先释放一个名额。 |
| WHMCS 已显示 Pro，但 Perfex 仍显示 Free | 版本状态尚未传达到 Perfex。 | 在 WHMCS 中点击 Check licence now 或 Test Connection，两者都会当场把版本状态送达 Perfex。然后重新加载 Perfex 设置页面。 |
| Perfex 的版本面板显示 Unknown | WHMCS 端从未报告过，或已经很久没有报告。 | 在 WHMCS 中点击 Test Connection，然后重新加载 Perfex 页面。如果仍为 Unknown，可能是 WHMCS 计划任务已停止运行，或两端不再处于配对状态。 |
更多内容请参阅故障排查。