Changelog
Todas as alterações notáveis no módulo de Integração Facebook & Instagram Leads são documentadas aqui.
[2.0.0] - 2026-02-05
Adicionado
- Per-Page Lead Assignment - Atribua diferentes membros da equipe a diferentes Pages (leads da Page A vão para Alice, leads da Page B vão para Bob)
- Instagram Lead Ads Support - Suporte completo para Instagram Lead Ads (mesmo webhook, automático)
- Setup Wizard - Assistente de configuração guiado em 5 passos para configuração inicial
- Sync History Dashboard - Visualize todas as sincronizações de leads com status, timestamps e detalhes
- Connection Test - Botão de um clique para verificar credenciais e permissões
- Test Lead - Envie um lead de teste para verificar se a integração está funcionando
- Duplicate Detection - Opção configurável para impedir importar o mesmo lead duas vezes
- Field Mapping Interface - Interface visual para mapear campos de formulário personalizados para campos do Perfex CRM
- Retry Queue - Mecanismo de nova tentativa automático para sincronizações de leads com falha
- Email Notifications - Seja notificado quando novos leads chegarem do Facebook/Instagram
- Webhook Verification Status - Indicador visual mostrando se o webhook está verificado
- Statistics Dashboard - Estatísticas em tempo real mostrando taxas de sucesso/falha de sincronização
- Sidebar Navigation - Acesso fácil a todos os recursos pela barra lateral
- Database Logging - Registro abrangente de todas as atividades de sincronização
- Custom Field Support - Mapeie para qualquer Custom Field do Perfex CRM
Alterado
- Graph API Version - Atualizado de v5.0 para v19.0 (última estável)
- Token Exchange - Movido para servidor por segurança (App Secret não mais em JavaScript)
- Webhook Handler - Completamente reescrito com processamento assíncrono e resposta 200 instantânea
- Settings Interface - Design moderno e intuitivo com melhor organização
- Pages Management - Interface de assinatura aprimorada com indicadores de status e contagens de leads
- Error Handling - Melhores mensagens de erro e feedback do usuário em todo o módulo
Corrigido
- Crítico: Corrigida referência faltante do Facebook PHP SDK
- Crítico: Corrigida dependência de sessão do webhook handler que causava perda de leads
- Segurança: Removido App Secret do JavaScript do lado do cliente
- Segurança: Adicionada validação e sanitização adequada de entrada
- Segurança: Removida escrita de arquivos de debug do código de produção
- Segurança: Adicionada verificação de assinatura do webhook (X-Hub-Signature-256)
- Bug: Corrigida exclusão CSRF (agora usa hooks corretos em vez de modificação de config)
- Bug: Corrigida busca de país para leads internacionais
Removido
- Funcionalidade de escrita de arquivos de debug
- Import GuzzleHttp não utilizado
- Visualização legada da página de configurações
Melhorias de Segurança
- Todos os endpoints POST validam tokens CSRF
- Tokens de acesso não mais expostos em handlers onclick HTML
- App Secret usado apenas no servidor
- Verificação de assinatura do webhook ativada
[1.0.0] - 2020-01-15
Adicionado
- Lançamento inicial
- Integração básica de Facebook & Instagram Lead Ads
- Conexão OAuth para acesso à página
- Suporte a webhook para leads em tempo real
- Monitoramento de múltiplas páginas
- Sincronização de campos personalizados
Planejado para Versões Futuras
- Análises e relatórios avançados
- Atualização automática de token
- Notificações de app móvel
- Suporte multilíngue
- Gatilhos de automação CRM na importação de leads
- Pontuação de leads baseada em dados do formulário
- Overrides de origem e status de leads por página (banco pronto, UI em breve)