使用指南
本页面涵盖 WHMCS Integration 模块的日常操作——运行同步、查看导入数据，以及利用机器人、模板和批量联系人来简化工作流程。
运行手动同步
虽然基于 cron 的自动同步处理常规导入，但您可以随时按需触发同步。
- 从 Perfex CRM 侧边栏导航到 WHMCS Integration。
- 在模块仪表板上点击 Sync Now 按钮。
- 选择要同步的数据类型：Clients、Invoices 或 All。
- 点击 Start Sync 并等待进程完成。
同步进度指示器显示当前状态，包括已处理、已创建、已更新和已跳过的记录数。
初次同步后，后续同步是增量的——仅导入自上次同步以来新增或修改的记录。即使 WHMCS 数据库很大，同步时间也很短。
管理已同步的客户
从 WHMCS 导入的客户出现在标准的 Perfex CRM Customers 部分。每个同步的客户资料包括：
- 完整的联系方式（姓名、邮箱、电话、地址）
- 公司信息
- 用于溯源的 WHMCS 客户 ID 引用
- 字段映射中配置的任何自定义字段
识别 WHMCS 客户
已同步的客户在其资料上标有 WHMCS 徽章，方便区分它们与直接在 Perfex CRM 中创建的客户。
编辑已同步的客户
您可以像编辑其他客户一样在 Perfex CRM 中编辑已同步的客户记录。但请注意：
在 Perfex CRM 中对已同步客户记录的更改 不会 同步回 WHMCS。如果同步设置为 Update 模式，本地编辑可能会在下次同步周期中被覆盖。要保留本地更改，请将该记录的重复处理模式切换为 Skip。
管理已同步的发票
从 WHMCS 导入的发票可在标准的 Perfex CRM Sales > Invoices 部分访问。每张同步的发票包括：
- 发票号和 WHMCS 引用 ID
- 完整的行项目明细（描述、数量、单价、税金）
- 支付状态（Paid、Unpaid、Partially Paid、Cancelled）
- 截止日期和支付日期（如适用）
- 关联的客户链接
已同步的发票默认为只读，以保持与 WHMCS 的数据完整性。支付状态更新在每次同步周期中反映。
机器人
机器人功能允许您设置基于同步事件触发的自动化操作。机器人可以帮助减少手动工作并确保及时跟进。
创建机器人
- 导航到 WHMCS Integration > Bots。
- 点击 New Bot。
- 配置机器人：
- Trigger — 选择事件（例如 "New Client Synced"、"Invoice Synced"、"Invoice Overdue"）
- Action — 选择执行的操作（例如发送邮件、创建任务、分配给员工、添加标签）
- Conditions — 可选地添加筛选条件（例如仅对来自特定国家的客户触发）
- 点击 Save。
示例机器人工作流
| 触发器 | 操作 | 描述 |
|---|---|---|
| 新客户已同步 | 发送欢迎邮件 | 当客户资料首次导入时自动问候新客户 |
| 发票逾期 | 创建任务 | 为账户经理分配跟进任务 |
| 新客户已同步 | 添加标签 | 为导入的客户标记"WHMCS"标签以便筛选 |
模板
模板定义机器人和与 WHMCS 同步数据相关的手动通信所使用的内容。
管理模板
- 前往 WHMCS Integration > Templates。
- 点击 New Template 创建消息模板。
- 填写 名称、主题（用于邮件）和 消息正文。
- 使用 合并字段 插入动态数据（例如
{client_name}、{invoice_number}、{amount_due}）。 - 点击 Save。
模板支持纯文本和 HTML 格式。使用合并字段使用从同步记录中提取的客户或发票数据来个性化消息。
批量联系人和分组
批量联系人功能让您将已同步的 WHMCS 客户组织成组，以实现有针对性的通信和管理。
创建分组
- 导航到 WHMCS Integration > Bulk Contacts & Groups。
- 点击 New Group。
- 输入 组名 和可选的 描述。
- 将联系人添加到组：
- 手动选择 — 从列表中选择个别客户
- 基于筛选 — 添加匹配特定条件的所有客户（例如国家、发票状态、同步日期）
- 点击 Save。
使用分组
分组可在整个模块中用于：
- 批量通知 — 一次向组中所有联系人发送邮件或消息
- 机器人定位 — 将机器人操作限制为特定组的成员
- 报告 — 按组成员资格筛选同步报告和分析
基于 WHMCS 产品或服务类型创建动态分组，以便为有 针对性的营销活动或支持工作流细分您的客户群。
同步仪表板
模块仪表板提供同步健康状况和活动的概览：
- Last Sync — 最近一次同步的时间戳和状态
- Records Summary — 已同步的客户、发票和联系人总数
- Sync History — 所有过去同步操作的日志，包含已创建、已更新和已跳过记录的详情
- Error Log — 同步失败的任何记录，附带原因和建议操作
定期查看仪表板以确保集成平稳运行，并及时处理任何同步错误。