ESTA DOCUMENTAÇÃO ESTÁ EM DESENVOLVIMENTO E CONSTANTE ATUALIZAÇÃO.

CRM — Contatos & Segmentação

Manual completo sobre o gerenciamento de base de dados de contatos, atribuição de tags e criação de segmentos dinâmicos no CRM.

A Base de Contatos

Toda a operação do DevCod Agency gira em torno dos contatos. O banco de dados armazena perfis ricos, capturando dados cadastrais, origem e histórico de engajamento do lead.

  • E-mail Único por Tenant: O e-mail do contato é único dentro do escopo do mesmo siteId, permitindo a identificação imediata do lead durante webhooks e disparos.
  • Campos Nativos: Mapeamento padrão incluindo nome, e-mail, telefone, empresa, cargo, origem (source) e score de qualificação.

Modelo de Dados (DevCod ORM: `Lead`)

Abaixo está o schema DevCod ORM que representa a entidade de lead no sistema:

{`
model Lead {
  id                String           @id @default(cuid())
  siteId            String
  email             String
  name              String?
  source            String?
  status            String           @default("new")
  score             Int              @default(0)
  notes             String?
  dealValue         Decimal          @default(0.0)
  whatsapp          String?
  linkedIn          String?
  twitter           String?
  tags              Json             @default("[]")
  lastEmailOpen     DateTime?
  totalEmailsOpened Int              @default(0)
  totalClicks       Int              @default(0)
  createdAt         DateTime         @default(now())
  agencyLeadId      String?          @unique
  fbclid            String?
  firstTouchSource  String?
}
          `}

Segmentos Dinâmicos

Os segmentos permitem agrupar contatos dinamicamente com base em regras e tags. São utilizados para direcionar campanhas de e-mail específicas e fluxos de automação.

  • Filtros por Tags: Seleciona apenas contatos que contenham tags específicas (Ex: checkout-iniciado, dj-producao).
  • Filtros por Score: Cria listas de leads qualificados (Ex: Score > 70) para atuação prioritária do time de vendas.
Próximo: CRM — Pipelines Kanban →