Produto Gita Tráfego — Documentação Operacional¶

Tudo que foi implementado, decidido e como operar o produto Gita Tráfego (gestão de tráfego pago para lojistas vindos da base Janaina).

Produção desde: 2026-04-20 (validação) Responsáveis operacionais: Taynara Negrão (Tay) + Junior Maia

Arquitetura¶

Gita Tráfego é um produto dentro do cluster Gita Agents — NÃO é tenant separado. Compartilha router, tenant (client_name='Gita Agentes'), número WhatsApp, canal ClickUp e operadores.

WhatsApp Gita Agents (mesma instância do Gita Agents)
           │
           ▼
/webhook/whatsapp/gita-router
           │
           │ [regex na primeira mensagem — RULES em router-classifier.ts]
           │
           ├── regex "tráfego pago|meta ads|quero tráfego|..." → gita-trafego-captacao
           │                                                         │
           │                                     fit="trafego_qualificado"
           │                                                         ▼
           │                                             gita-trafego-proposta
           │                                             (agenda reunião c/ Tay)
           │
           └── (outros regex / default)                     → fluxo Gita Agents

Agente	Persona	Papel
`gita-router`	—	Fantoche COMPARTILHADO com Gita Agents. Classifica via regex
`gita-trafego-captacao`	Isis	4-5 perguntas (Instagram, já investe, quanto, faturamento, objetivo), decide fit
`gita-trafego-proposta`	Isis	Lead qualificado → agenda reunião de 30-45min com a Tay no Calendar primário

Produto¶

Gestão de tráfego pago para lojistas - Público: lojistas que chegam via indicação da Janaina Ortiga (CTA wa.me direciona pro número) - Pacotes: variáveis por perfil (Tay monta sob medida na call). Valores NÃO expostos no chat - Ticket típico (referência operação Tay 2026): setup R$ 5k + mensal R$ 4-5.5k dependendo da loja

Perfis de lead (6 conversas reais estudadas — Chatwoot #1560, 1561, 1668, 1672, 1681, 1694)¶

Qualificado: tem loja operante, Instagram ativo, faturamento ≥ R$ 15k, intenção real de investir
Muito inicial: loja em planejamento, faturamento < R$ 10k, sem presença digital estruturada → encaminha pra conversa com time (Tay decide se indica Empresa no Digital)

Tools ativas¶

Tool	Agente	Função
`qualificar_lead`	gita-trafego-captacao	Salva dados progressivamente (nome, instagram, ja_investe_trafego, tipo_trafego, valor_investido, faturamento, tipo_operacao, objetivo, fit)
`agendar_reuniao`	gita-trafego-proposta	Cria evento no `[email protected]` + link Meet
`reportar`	Ambos	Escala pro ClickUp `#Comercial`. Contexto sempre começa com `[Gita Tráfego]`

Fluxo de conversa padrão¶

1. Entrada (CTA Janaina)¶

Mensagem padrão (100% dos casos via CTA):

"Olá, estou entrando em contato através da Janaina Ortiga e tenho interesse nos serviços de tráfego pago para o meu negócio."

Regex em router-classifier.ts captura "tráfego pago", "gestão de tráfego", "quero tráfego", "meta ads", "vim pela Janaina ... tráfego" — redireciona pra gita-trafego-captacao.

2. Qualificação (5 perguntas, tom acolhedor)¶

"Qual é o @ do Instagram?" + "Já investe em tráfego pago?" (em 2 balões separados)
Se investe: "Quanto por mês? Direto no gerenciador ou impulsiona posts?"
Faturamento médio mensal
Tipo de operação (física / online / híbrida)
Objetivo principal

3. Handoff → Proposta¶

Se qualificada: fit="trafego_qualificado" → router redireciona pra gita-trafego-proposta.

4. Agendamento¶

Isis Proposta apresenta janelas ter-sex manhã (10-11h) ou tarde (14-17h)
Lead sugere dia/turno → Isis confirma horário específico (ex: "quinta às 15h?")
Converte data relativa ("semana que vem terça") pra ISO 8601 (2026-04-28T10:00:00-03:00)
Chama agendar_reuniao → evento em [email protected] + Meet link

5. Escalações (reportar)¶

Lead pede horário fora das janelas → motivo: horario_indisponivel
Lead negocia antes da reunião → negociacao_antecipada
Lead quer falar com Tay/Junior antes → solicitou_humano ou nome_conhecido
Lead pede material antes da call → material_pre_call
Dúvida técnica profunda (Conversions API, etc) → duvida_tecnica
Lead muito inicial → avaliacao_perfil (Tay decide indicar Empresa no Digital)

Tom de voz (diferente do Gita Agents)¶

Aspecto	Gita Agents	Gita Tráfego
Tom	Formal, profissional	Acolhedor, empático, celebrativo
Emojis	Zero (exceto `;)` em conversao)	🤗 🙌 💃 🤌🏼 ✨ (máx 1-2 por mensagem)
Saudação	"Olá! Sou a Isis."	"Oi! Tudo bem? 🤗 Que alegria receber sua mensagem!"
Celebração	Ausente	"Que ótimo!" / "Parabéns pela decisão!" (moderado, não em toda msg)

Ver prompts: ~/gita/agents/gita-trafego/whatsapp/captacao.prompt.md + proposta.prompt.md Few-shots com 10+5 diálogos reais da base Janaina: few-shots-captacao.md + few-shots-proposta.md

Google Calendar¶

Mesma config do Gita Agents (compartilha OAuth2): - Calendar: [email protected] (primary) - OAuth2: herdado do agente moleiro (owner validado) - Fuso: America/Sao_Paulo - Summary do evento: "Reunião Gita — [Nome]"

CRM e block IA¶

Iguais ao Gita Agents: - Chatwoot https://atendimento.gita.work (account 1) - Label pausar-ia pausa IA por 6h quando humano assume a conversa - Block IA ativo em captacao e proposta

Follow-up proativo¶

Agente	Intervalos	Etapas
gita-trafego-captacao	1h, 1d, 3d, 7d	4 mensagens progressivas
gita-trafego-proposta	1h, 1d	2 mensagens (lembrete agendamento)

Histórico de construção (resumo)¶

Data	Marco
2026-04-20	Análise de 6 conversas reais do Chatwoot (Letícia, Bárbara, Nayara, Leide, Carmy, Milca)
2026-04-20	Decisão arquitetural: produto dentro do cluster Gita Agents (não tenant novo)
2026-04-20	Migration 020 — 2 agentes + 4 tools. Regex + FIT_ROUTING expandidos
2026-04-20	Bateria v10 (8 cenários) → issues #1 (regex fraco) e #2 (prompt não trata horário) descobertos e corrigidos
2026-04-21	Bateria v11 (7 cenários novos) → 7/7 passaram. Issue #3 descoberto (perfil muito_inicial não detectado). Pendente.
2026-04-21	Fix Calendar — eventos agora caem em `[email protected]`

Ver CHANGELOG detalhado: ~/gita/agents/gita-trafego/CHANGELOG.md

Pendências conhecidas¶

Issue #3: Captação não detecta fit="muito_inicial" mesmo com sinais claros (sem IG + loja presencial + faturamento baixo). Fix: regra prescritiva no prompt sobre critérios inelegíveis
Validação com tráfego real (até 2026-04-21 só rodaram 15 cenários dry-run)
Atualizar CTA da Janaina pro número oficial quando sair de testes

Troubleshooting específico¶

Ver runbook-troubleshoot.md pra diagnóstico geral. Problemas específicos do Gita Tráfego:

Lead fala "tráfego" mas cai em gita-captacao → regex não bateu. Verificar RULES[0] em router-classifier.ts e adicionar variação
Captacao não transita pra proposta → timing do Gemini salvando fit tarde. É esperado em alguns casos (fix futuro: instruir Gemini a chamar qualificar_lead com fit ANTES de responder)
Isis menciona valores → BUG. Nunca deve acontecer. Reforçar no prompt e reportar
Calendar não recebe evento → checar provider_config.google_calendar_id do gita-trafego-proposta (deve ser [email protected])