CRM

O CRM do Zivlo é um pipeline visual estilo Kanban para gerenciar oportunidades de venda.

Pipelines

• Crie múltiplos pipelines para diferentes processos (Vendas, Pós-venda, etc.)
• Cada pipeline tem cor personalizável
• Troque entre pipelines com o seletor no topo

Estágios

• Cada pipeline tem estágios customizáveis (Ex: Qualificação → Proposta → Negociação → Fechado)
• Configure estágios em CRM > Configurações
• Arraste deals entre estágios via drag-and-drop

Deals (Oportunidades)

• Crie deals manualmente ou via automação (nó "Criar Deal")
• Cada deal tem: nome, valor, contato vinculado, estágio, notas
• Mova deals entre estágios arrastando os cards
• Clique em um deal para ver detalhes e editar

Automações do CRM

Configure automações específicas para o CRM em CRM > Automações:

• Disparar ação quando deal muda de estágio
• Notificar agente quando deal é criado
• Enviar mensagem automática ao contato do deal

Integração com Automações

Use o nó "Criar Deal" nos fluxos para criar oportunidades automaticamente durante o atendimento.

O CRM do Zivlo tem 10 telas agrupadas em 4 camadas funcionais. Este artigo é o mapa mental — use como referência rápida para saber em qual tela ir.

## As 4 camadas

## As 10 telas

## Regra de ouro — qual tela abrir

• Quero criar/mover um deal específico → Kanban
• Quero ver a saúde geral do pipeline → Dashboard
• Quero mandar mensagem em massa com IA → Smart Campaigns
• Quero mandar follow-up em UM deal que eu escolhi → Cadências
• Quero que algo aconteça automaticamente quando um evento ocorrer → Automações (V1 se simples, V2 se tem condições)
• Quero definir a voz da IA → Personas
• Quero desenhar o funil do zero → Configurações

A dúvida mais comum do CRM. As três podem enviar mensagens, mas têm propósitos e comportamentos muito diferentes.

## Comparação lado a lado

## Regras práticas

Use Smart Campaigns quando:

• Tem 50+ leads frios e quer reativar todos com mensagens personalizadas pela IA
• Não quer escrever mensagem — quer descrever objetivo e deixar a IA trabalhar
• Quer cadência com scheduling inteligente (horário ideal por lead)
• Quer controle granular de custo e intensidade

Use Cadências quando:

• Quer controle fino dos textos ou usar templates WhatsApp aprovados
• Está fazendo follow-up de deals específicos, um por vez
• Precisa de 10+ steps com delays longos (dias)
• Quer reutilizar o mesmo playbook em vários deals

Use Automações quando:

• Quer uma reação instantânea a um evento (ex: quando deal é criado, atribua ao time X)
• A ação é pontual — uma mensagem, uma atribuição, uma mudança de campo
• Quer encadear: "quando X acontecer, inicie uma Cadência" (via action start_followup_sequence) ou "qualifique com IA" (via ai_qualify)

## Como se combinam

As três podem trabalhar juntas:

1. 1Automação V2 detecta stage_enter: Proposta + lead_score >= 60
2. 2A automação dispara action ai_qualify (roda BANT/SPIN)
3. 3Se score ≥ 70, a mesma automação dispara start_followup_sequence: Fechamento 5d
4. 4A Cadência roda step a step
5. 5Se o deal ficar cooling_status='cold' depois, entra numa Smart Campaign de recuperação

Assim cada ferramenta faz o que faz de melhor.

Parecem a mesma coisa, mas são complementares.

## lead_score (campo no card do deal)

• É o número atual (0-100) que aparece no card do deal no Kanban
• Atualizado na última rodada de qualificação
• Usado por: filtros de Smart Campaigns, triggers de Automação V2, ordenação do Kanban
• É o resultado final

## Qualificações IA (tela /crm/qualifications)

• É o histórico de todas as rodadas de qualificação que a IA rodou em cada deal
• Mostra o raciocínio completo: BANT expandido, SPIN, resumo, prompt usado, modelo, tokens, custo, latência
• Read-only — é auditoria, não ação
• Útil para: entender *por que* o lead virou 73, comparar custos entre modelos, debugar regressões

## Analogia

• lead_score é o boletim do aluno
• Qualificações é o caderno de provas mostrando cada prova, erros, acertos e correções

## Como a IA calcula o score (framework BANT)

• Budget (0-25): o lead tem orçamento?
• Authority (0-25): está falando com quem decide?
• Need (0-25): há necessidade real?
• Timeline (0-25): há urgência/prazo?

Soma = lead_score. Cada item vem com evidência extraída da conversa.

## Salvaguardas da qualificação IA

• Throttle: 1 qualificação por deal a cada 24h (para evitar re-scoring em loop)
• Lock Redis: impede corridas concorrentes
• Não sobrescreve score humano se diferença < 10 pts (a não ser force=true)
• Modelo default: Haiku (~$0.0005/qualificação)
• Throttle por tokens: se a quota do mês estourou, pula

Vide também o artigo *Como funciona o AI Lead Qualifier*.

Ambos usam IA, mas servem para coisas diferentes.

## O que define uma Persona IA

• Nome e role (SDR, closer, CS…)
• Tom: formal / amigável / casual / empático / urgente / consultivo
• Idioma: pt-BR / en-US / es
• Assinatura (opcional): texto no final da mensagem
• Guard rules: restrições duras do tipo

- "Nunca prometer desconto sem autorização"

- "Não mencionar concorrentes"

- "Sempre terminar com CTA claro"

## O que define um AI Agent

• Prompt de sistema completo (ilimitado)
• Modelo escolhido (Haiku, Sonnet, Opus…)
• Temperature, max_tokens, tools conectados
• Knowledge base (RAG sobre documentos carregados)
• URLs, Q&A pairs, contexto
• Limites de interação por sessão

## Regra prática

• Gerar UMA mensagem isolada (email, follow-up, campanha) → Persona
• Atender o cliente em conversa → Agent

## Como se conectam

Um AI Agent pode usar uma Persona como base do tom. A Persona é o "como falar"; o Agent é o "como conversar". Personas são leves e compartilháveis entre features; Agents são pesados e específicos.

Rotas vizinhas, mas papéis totalmente diferentes.

## /crm/sequences — Cadências

Lista dos templates de follow-up.

• Cada linha é a definição de uma cadência (nome, tom, steps, max_attempts, flags)
• Ações: criar, editar, ativar/pausar, excluir, iniciar em um deal (botão ▶)
• Uma cadência existe mesmo sem estar rodando

## /crm/sequences/followups — Follow-ups ativos

Lista das instâncias que estão rodando agora, em todos os deals do tenant.

• Cada linha é uma execução viva (deal + sequence + step atual + próximo envio)
• Ações: filtrar por status (running/paused/completed/stopped_reply/failed), pausar, retomar, cancelar uma execução específica, abrir deal no Kanban
• Atualiza a cada 30s automaticamente

## Analogia

• Cadências = livros de receitas
• Follow-ups ativos = pratos no forno agora

Uma cadência "Reativação 7d" pode ter 50 follow-ups ativos simultaneamente — um por deal em que foi iniciada.

## Quando ir pra cada tela

• Quer criar ou editar um playbook → Cadências
• Quer saber o que está rodando agora ou pausar algo que está agindo → Follow-ups ativos

As duas telas criam regras automáticas no CRM e salvam na mesma tabela — mas diferem na complexidade suportada.

## V1 (/crm/automations) — Simples

1 trigger + 1 ação.

Triggers suportados:

• stage_enter — deal entrou no estágio X
• days_in_stage — parado N dias num estágio
• deal_created
• deal_won
• deal_lost

Ações suportadas:

• send_whatsapp — enviar mensagem
• assign_agent — atribuir agente
• move_stage — mover deal de estágio
• start_flow — iniciar um flow
• create_activity — criar atividade/lembrete

Use quando: a regra é binária ("se entrar no estágio X, faça Y"). Zero condição.

## V2 (/crm/automations/builder) — Avançado

1 trigger + N condições + N ações em sequência.

Wizard em 4 passos: Trigger → Condições → Ações → Revisão.

Triggers extras:

• lead_score_threshold — score cruza valor
• no_response_for_days
• inactivity
• tag_added / tag_removed
• message_received
• webhook

Operadores de condição:

eq · ne · gt · lt · gte · lte · contains · in

Ações extras:

• send_email, send_template
• assign_team, change_priority
• add_tag / remove_tag
• update_field
• start_followup_sequence *(conexão com Cadências)*
• ai_qualify *(aciona o AI Qualifier)*
• add_note, schedule_call, webhook

Use quando: regra tem "E"/"OU", ou precisa encadear várias ações, ou usa triggers avançados.

## Exemplo de V2

> Quando lead_score_threshold: >= 70

> E tag contém "premium"

> E horário comercial

> → Atribuir ao time Vendas

> → Adicionar tag "hot-lead"

> → Iniciar Cadência "Fechamento 5d"

Isso é impossível no V1.

Vamos seguir um deal real passando pelas 10 telas do CRM.

## 1. Configurações do CRM

Crio o pipeline "Vendas B2B" com estágios:

Prospecção → Contato → Qualificado → Proposta → Fechamento → (Ganho / Perdido)

## 2. Personas IA

Crio persona "Ricardo — Closer Consultivo" com tom consultivo, pt-BR, assinatura "Ricardo, Equipe Comercial", e guard rule "nunca prometer desconto sem autorização".

## 3. Cadências

Crio cadência "Reaquecer Proposta 5d" com 4 steps (IA humanizada, delays 24h/48h/72h/120h, persona Ricardo, stop_on_reply ativo).

## 4. Automação V2

Quando stage_enter: Proposta E lead_score >= 60:

1. 1Rodar action ai_qualify (atualiza score)
2. 2Se score ≥ 70, rodar start_followup_sequence: Reaquecer Proposta 5d

## 5. Kanban

Arrasto um deal para Proposta.

→ A automação V2 dispara sozinha.

## 6. Qualificações IA

Abro /crm/qualifications, vejo a rodada mais recente:

• Framework: BANT
• Budget: 22/25 ("mencionou R$ 10k orçado")
• Authority: 18/25 ("é diretor")
• Need: 23/25 ("quer em 60 dias")
• Timeline: 20/25
• Score: 83
• Tokens: 1.247 · Custo: $0.0003

## 7. Follow-ups ativos

/crm/sequences/followups: vejo a cadência "Reaquecer Proposta 5d" rodando no deal, step 2/4, próximo envio em 32h.

## 8. Dashboard

Verifico forecast: deal R$ 50k × estágio Proposta (50% win prob) = R$ 25k adicionado ao forecast do mês.

## 9. Smart Campaigns (caso o deal esfrie)

Se o lead não responder por 14 dias, cooling_status → cold. Incluo ele numa Smart Campaign "Recuperação Q2" junto de outros 500 leads frios, intensidade Moderada, persona Ricardo.

## 10. Monitor da Smart Campaign

/crm/smart-campaigns/:id: acompanho quantos receberam, quantos responderam, custo em tokens, quais foram pausados por opt-out.

---

Resumo do que cada tela fez no exemplo:

1. 1Configurações → desenhou o funil
2. 2Personas → definiu a voz do Ricardo
3. 3Cadências → criou o playbook reutilizável
4. 4Automações V2 → escolheu quando disparar tudo isso
5. 5Kanban → a ação do usuário que rolou o fluxo
6. 6Qualificações → auditou a decisão da IA
7. 7Follow-ups ativos → monitorou a cadência viva
8. 8Dashboard → traduziu tudo em KPI
9. 9Smart Campaigns → reativou se esfriou
10. 10Monitor → mediu o resultado da campanha

Nenhuma feature é redundante. Cada uma tem seu lugar no ciclo.

Guia de primeiros socorros no CRM — qual tela abrir para cada sintoma.

## Problemas comuns e soluções

"Cadência disparou imediatamente em vez de esperar 1h"

Era bug até recentemente. O primeiro step agora respeita delay_hours. Verifique em /crm/sequences.

"Cadência nunca começou"

Verifique se a cadência está ativa (badge verde). Só cadências ativas podem ser iniciadas em deals.

"Não existe botão para iniciar cadência num deal"

Na tela /crm/sequences cada card tem botão ▶ verde. Clica e escolhe pipeline + deal.

"Automação V2 com condições nunca roda"

Verifique os operadores e tipos de campo. lead_score é number — use gte/gt, não contains.

"Smart Campaign mostra 0 targets"

O target_filter é muito restritivo ou o filtro implícito (status='active' + contact_phone obrigatório) eliminou todos. Use "Estimar" antes de criar.