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.