Leads & CRM¶

O módulo de Leads gerencia a camada de CRM de contatos da Brandvelia. Ele captura dados de visitantes a partir de formulários nas landing pages, organiza o histórico de engajamento em uma linha do tempo unificada e classifica os leads em um pipeline de qualificação.

Estrutura do Lead¶

Campo	Significado
`id`	Identificador único (`BV_Leads`) no workspace.
`identifiers`	Endereço de e-mail, telefone e nome do contato.
`source`	Campanha, anúncio e landing page de origem da captura.
`events`	Histórico de ações (visitas, preenchimento de formulários, cliques no link de afiliado, conversões).
`pipeline_stage`	Estágio atual no funil: `New`, `Qualified`, `Unqualified`.
`consent`	Registro de opt-in com data, IP e termos aceitos (LGPD / GDPR).

Estágios do Pipeline de CRM¶

New (Novo)  →  Qualified (Qualificado)  →  Unqualified (Desqualificado)

New: Lead recém-capturado em uma bridge page ou opt-in de e-book/newsletter.
Qualified: Lead que demonstrou intenção de compra real (por exemplo, iniciou checkout ou realizou uma compra no ClickBank atribuída ao mesmo e-mail).
Unqualified: Contato inválido, bounce de e-mail ou usuário que solicitou descadastro (opt-out).

Conformidade e Unsubscribe Público¶

A Brandvelia atua como a fonte única da verdade sobre os leads e consentimentos da operação:

Endpoint público de descadastro: /unsubscribe?token=... associado à rota /api/email/unsubscribe.
Ao receber uma solicitação de descadastro, o sistema revoga imediatamente o consentimento ativo, registra o evento na timeline e impede novos envios comerciais para o e-mail.
Pronto para conexão futura com provedores externos de envio (ESP) via adapter EmailProvider.