Produto Gita Agents — Documentação Operacional¶

Tudo que foi implementado, decidido e como operar o produto Gita Agents (venda de implementação de agentes IA para negócios digitais).

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

Arquitetura¶

WhatsApp Gita Agents (instância Uazapi "Lojista Assistant" · 556191502969 · token 13ef1f63-...)
           │
           ▼
/webhook/whatsapp/gita-router
           │
           ├── regex "tráfego pago|meta ads|..."    → gita-trafego-captacao (produto Gita Tráfego)
           │
           └── default / regex "agente de IA"        → gita-captacao
                                                           │
                               ┌───────────────────────────┤
                               │                           │
                   fit="gita_agents"               fit="empresa_digital"
                               │                           │
                               ▼                           ▼
                       gita-conversao                gita-downsell
                       (agenda reunião)       (apresenta Empresa no Digital)

Agente	Persona	Papel
`gita-router`	—	Fantoche compartilhado com Gita Tráfego. Classifica via regex + FIT_ROUTING
`gita-captacao`	Isis	4 perguntas SPIN (produto, ticket, anúncios, base, tempo resposta), decide fit
`gita-conversao`	Isis	Lead qualificado → agenda reunião de 30min com Tay/Junior no Calendar primário da Gita
`gita-downsell`	Isis	Lead sem fit → apresenta Empresa no Digital, encaminha pra conversa com time (sem checkout direto)

Tenant: client_name = 'Gita Agentes' (mesmo cluster do Gita Tráfego).

Produto¶

Gita Agents — implementação de agentes IA em WhatsApp - Público: donos de negócio digital maduros (infoprodutores, e-commerce, agências) - Formato: setup customizado + mensalidade (valores não expostos no chat — sempre na reunião) - Filtro Wardrope (método ROYA): ticket ≥ R$ 1k, investe em anúncios, base ≥ 1k contatos, resposta rápida. Critérios relaxados pra casos borderline (ticket R$ 300-999 com anúncio ativo + base ≥ 3k + resposta rápida qualifica)

Empresa no Digital (downsell) - Público: lojistas sem operação digital estruturada - Apresentado como caminho de evolução, não "consolação" - Venda acontece em conversa com time (não checkout direto)

Tools ativas¶

Tool	Agente	Função
`qualificar_lead`	gita-captacao	Salva dados progressivamente (nome, produto, ticket, anuncia, base, resposta, fit)
`agendar_reuniao`	gita-conversao	Cria evento no `[email protected]` + link Meet
`oferecer_empresa_no_digital`	gita-downsell	Retorna info pra apresentar como próximo passo
`reportar`	Todos os 3	Escala pro canal ClickUp `#Comercial` (`8cgqa6x-12233`). Contexto sempre começa com `[Gita Agents]`

Google Calendar (configurado 2026-04-21)¶

Calendar destino: [email protected] (primary)
OAuth2: herdado do agente moleiro (permissão owner validada)
Fuso: America/Sao_Paulo
Campos no evento criado: summary "Reunião Gita — [Nome]", descrição com contexto da qualificação, duração 30min, Meet link automático

Ver detalhes técnicos: packages/engine/src/services/tools.ts:handleAgendarReuniao — usa extractCalendarConfig que busca google_oauth2 + google_calendar_id no provider_config do agente.

CRM Chatwoot¶

URL: https://atendimento.gita.work
Account ID: 1
Label de pausa manual: pausar-ia — Tay/Junior aplicam no Chatwoot pra parar a Isis por 6h (block_ia_ttl_minutes=360)
Block IA ativo: gita-captacao e gita-conversao (downsell terminal, não precisa)

Follow-up proativo¶

Agente	Intervalos	Quantas etapas
gita-captacao	1h, 1d, 3d, 7d	4 follow-ups (suave → encerramento)
gita-conversao	1h, 1d	2 follow-ups (leve pressão por horário)
gita-downsell	—	Desabilitado

Notificação e escalação¶

WhatsApp de notificação: desativado (notification_number: NULL) — decisão consciente (2026-04-20)
ClickUp #Comercial (8cgqa6x-12233): recebe toda chamada reportar. Contexto sempre prefixado com [Gita Agents] pra identificar o projeto

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

Data	Marco
2026-04-20	Migration 016 — 4 agentes + 3 tools. Webhook Uazapi conectado
2026-04-20	Migration 017 — Block IA + ClickUp #Comercial + CRM Chatwoot + tool `reportar`
2026-04-20	Migration 018 — Janelas flexíveis no conversao (substituiu horários fixos)
2026-04-20	Bateria dry-run identificou 6 bugs (#1 merge qualified_data, #2 leads duplicados, #3 escalação, #4 transição truncada, #5 critérios draconianos, #6 nome em conversao)
2026-04-20	Todos os 6 bugs corrigidos (código + prompts)
2026-04-20	v9 — estilo padronizado (zero travessões, zero markdown, few-shots)
2026-04-21	Fix Calendar — OAuth2 + `google_calendar_id = [email protected]`

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

Pendências / próximos passos¶

Definir pricing oficial do Gita Agents antes da primeira reunião real (Tay + Junior)
Monitorar primeiras 5-10 conversas reais em produção + ajustar prompts
Tay fazer primeiros posts orgânicos direcionando tráfego pro número
Eventualmente: dashboard admin com segmentação por qualified_data.fit (hoje mostra leads misturados)

Troubleshooting específico¶

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

Lead caiu em gita-captacao mas era tráfego → verificar se mensagem bateria regex de gita-trafego-captacao. Se não bateu, adicionar variação ao regex em router-classifier.ts:RULES
Tool agendar_reuniao falha → checar provider_config.google_oauth2 do gita-conversao e se OAuth2 tem acesso ao calendar
Histórico contaminado com Gita Tráfego → esperado, é mesmo cluster. Histórico intra-tenant é compartilhado por design