更新日志
此处记录了 Facebook 和 Instagram Leads 集成模块的所有重要更改。
[2.0.0] - 2026-02-05
新增
- 按页面分配 Lead - 将不同员工分配给不同页面（Page A 的 leads 分配给 Alice，Page B 的 leads 分配给 Bob）
- Instagram Lead Ads 支持 - 完整支持 Instagram Lead Ads（相同 webhook，自动）
- 设置向导 - 首次配置的 5 步 guided 设置向导
- 同步历史仪表板 - 查看所有 lead 同步的状态、时间戳和详情
- 连接测试 - 一键验证凭证和权限
- Test Lead - 发送测试 lead 以验证集成是否正常工作
- 重复检测 - 可配置选项防止重复导入同一 lead
- 字段映射界面 - 将自定义表单字段映射到 Perfex CRM 字段的可视化界面
- 重试队列 - 失败的 lead 同步的自动重试机制
- 电子邮件通知 - 从 Facebook/Instagram 收到新 lead 时收到通知
- Webhook 验证状态 - 显示 webhook 是否已验证的可视指示器
- 统计仪表板 - 显示同步成功/失败率的实时统计
- 侧边栏导航 - 从侧边栏轻松访问所有功能
- 数据库日志 - 全面记录所有同步活动
- 自定义字段支持 - 映射到任何 Perfex CRM 自定义字段
更改
- Graph API 版本 - 从 v5.0 更新到 v19.0（最新稳定版）
- Token 交换 - 移至服务端以提高安全性（App Secret 不再在 JavaScript 中）
- Webhook 处理器 - 完全重写，支持异步处理和即时 200 响应
- 设置界面 - 现代化、直观的设计，组织更清晰
- 页面管理 - 改进的订阅界面，带状态指示器和 lead 计数
- 错误处理 - 更好的错误消息和用户反馈
修复
- 严重： 修复缺失的 Facebook PHP SDK 引用
- 严重： 修复导致 lead 丢失的 webhook 处理器会话依赖
- 安全： 从客户端 JavaScript 中移除 App Secret
- 安全： 添加适当的输入验证和清理
- 安全： 从生产代码中移除调试文件写入
- 安全： 添加 webhook 签名验证 (X-Hub-Signature-256)
- 错误： 修复 CSRF 排除（现在使用 proper hooks 而非 config 修改）
- 错误： 修复国际 leads 的国家查找
移除
- 调试文件写入功能
- 未使用的 GuzzleHttp 导入
- 旧版设置页面视图
安全改进
- 所有 POST 端点验证 CSRF tokens
- 访问 tokens 不再在 HTML onclick 处理程序中暴露
- App Secret 仅在服务端使用
- 启用 webhook 签名验证
[1.0.0] - 2020-01-15
新增
- 初始版本
- 基本 Facebook 和 Instagram Lead Ads 集成
- 页面访问的 OAuth 连接
- 实时 leads 的 webhook 支持
- 多页面监控
- 自定义字段同步
未来版本计划
- 高级分析和报告
- 自动 token 刷新
- 移动应用通知
- 多语言支持
- Lead 导入时的 CRM 自动化触发器
- 基于表单数据的 lead 评分
- 按页面 lead 来源和状态覆盖（数据库就绪，UI 即将推出）