Pular para conteúdo

Caramelo

Relatório de inteligência comercial gerado por IA a partir do LIR (Lead Intelligence Report) do Pipedrive da Bepex. Fareja o que não está óbvio no pipeline — empresa top num deal pequeno, investimento pesado, contrato público recente, expansão, SPEs — e avisa cada vendedor individualmente por WhatsApp. O que o vendedor já vê nos filtros do Pipedrive (fase, valor, próxima atividade) não é Caramelo; o valor está na inteligência oculta do LIR.

Status atual

Fases 1 + 2 + 3 ATIVAS desde 2026-06-19.

  • Diário (Fase 1+2): workflow SaR2gOEMNRAFjDOL — 15 nodes, cron seg-sex 8h, WhatsApp individual via Chatwoot inbox 61 (pré-vendas frio, chat.bepex.com.br account 2). Modelo Gemini Flash via OpenRouter. Máximo 3 destaques por vendedor.
  • Semanal (Fase 3): workflow yOPIrBxtOoRwgZTO — 6 nodes, cron segunda 7h, email consolidado via Amazon SES para os 4 gestores (caramelo@bepex.com.br como remetente).
  • Fase 4 (loop de feedback): CANCELADA por decisão do Rafael (2026-06-19).

Detalhes de IDs, nós, credenciais e destinatários em referencia-tecnica.md.

Como operar

  1. Diário roda sozinho (cron 8h seg-sex). Cada vendedor mapeado recebe até 3 destaques no WhatsApp; se não houver inteligência nova, o vendedor não recebe nada naquele dia.
  2. Semanal roda sozinho (segunda 7h). Se não houve insight na semana, o email não é enviado.
  3. Após editar via API (PATCH): F5 obrigatório no editor antes de Ctrl+Enter, e deactivate → reactivate do Schedule Trigger — senão o cron roda a versão antiga em cache (ver historico.md e a lição em referencia-tecnica.md).

Como funciona (visão)

Puxa todos os deals abertos do Pipedrive → extrai os org_id únicos → busca o enriquecimento de cada organização (LIR, faixa de faturamento, CNAE, RFM, segmento) via API → faz merge nos deals → agrupa por vendedor (owner) → a IA analisa e escolhe até 3 destaques de inteligência oculta por vendedor → formata a mensagem de WhatsApp → filtro de novidade (não repete empresa dos últimos 14 dias) → envia via Chatwoot. O consolidado semanal lê os insights persistidos e manda um resumo por email aos gestores.

Fluxo nó-por-nó e o filtro de novidade dual-layer em referencia-tecnica.md.

Diagnóstico que motivou o redesenho (jun/2026)

Análise de 15 relatórios do Caramelo legado (5OjAbflpRHfEMrJu, email às 4h) apontou 8 problemas:

  1. Canal errado — email às 4h que ninguém abre.
  2. Texto inflado — ~800 palavras com metáforas caninas ("Au! Au! Matilha!") que escondem a informação.
  3. Mistura inteligência com pipeline — repete fase/valor que o vendedor já vê, diluindo o que é novo.
  4. Igual para todos — mesmo relatório para toda a equipe, não individual.
  5. Sem ação clara — "mordidas" genéricas ("ligar pro contato").
  6. Sem acompanhamento — manda e esquece.
  7. Formato monolítico — texto corrido, difícil de escanear.
  8. Frequência vs. substância — roda diário mesmo sem novidade real.

O que já funcionava e foi preservado: o conceito de farejar inteligência oculta; a capacidade da IA de cruzar LIR × pipeline; a marca "Caramelo", que a equipe reconhece.

Novo formato (implementado)

  • WhatsApp diário individual (seg-sex 8h): até 3 destaques por vendedor, com tags visuais (EMPRESA TOP, R$ XXM INVEST., CONTRATO +R$XXXM). Cada destaque = empresa + insight em 1–2 frases + ação sugerida específica + decisor. Sem metáfora, sem pipeline. Só manda se houver novidade.
  • Email semanal consolidado (segunda 7h): para gestores — quais inteligências foram sinalizadas na semana, quais foram aproveitadas, quais ficaram paradas.

Índice da subpasta

Documento Conteúdo
README.md (este) Visão executiva, status, diagnóstico, novo formato, como operar
referencia-tecnica.md Workflows, nós, IDs, credenciais (nomes), destinatários, filtro de novidade, lições
historico.md Changelog datado (jun/2026): diagnóstico, Fases 1–3, LIR, bugs e fixes
ARQUIVOS.md Manifesto dos anexos (proposta HTML, mockup PNG, diagnóstico, backup JSON) → Drive