Agente Vini SDR — Documentação Operacional¶

Briefing técnico para o Theo configurar o agente Vini no Gita Agents.

Responsável de configuração: Théo (engenheiro) Prazo do sprint: D8-D12 (referência: data/products/junior-maia-claude-code/STRATEGY.md) Responsável operacional após deploy: Júnior Maia

Contexto¶

O Vini é o SDR do Júnior Maia. Ele recebe leads que clicam no botão WhatsApp da landing page do Kit Claude Code (https://junior-kit-claude.vercel.app) e qualifica para a Operação IA (R$15-25k) ou Diagnóstico (R$1.997).

O lead chega com intenção alta — acabou de consumir o kit completo na página. Vini não precisa educar; precisa qualificar e agendar a call com a Marina (closer).

Persona completa: ~/gita/agents/junior-squad/comercial/vini-sdr/AGENT.md

Arquitetura¶

Agente único, sem router. Lead entra direto no Vini.

WhatsApp Vini (número dedicado, Uazapi)
           │
           ▼
/webhook/whatsapp/vini-sdr
           │
           ▼
        vini-sdr
    (qualifica → agenda com Marina)

Agente	Persona	Papel
`vini-sdr`	Vinícius Costa	Qualifica inbound do Kit → agenda 30min com Marina

Não tem router — lead sempre cai no Vini. Se no futuro houver múltiplos fluxos (reativação, suporte), adiciona router.

Produto que o Vini vende (contexto do prompt)¶

Operação IA — Implementação Claude Code B2B - Posicionamento: "Agentes IA rodando na sua operação em 30 dias" - Investimento: R$15-25k (único) + R$2-3k/mês recorrente - Entrada: Diagnóstico 90min com o Júnior (R$1.997 — vira crédito se fechar Operação IA) - ICP: dono de negócio B2B com operação estruturada, faturamento a partir de R$500k/ano, WhatsApp ativo no atendimento

Não é para: solopreneur early stage, infoprodutores sem operação, quem quer "testar IA de graça"

Fluxo de conversa¶

Abertura (mensagem do lead): qualquer mensagem de quem chegou pela página do Kit
Vini identifica contexto (veio do Kit = intenção alta) e faz abertura curta + 1 pergunta
3-5 perguntas BANT (em WhatsApp, nunca de uma vez — 1 por turno):
Qual é o seu negócio e setor?
Qual processo você quer automatizar primeiro?
Você já tem WhatsApp ativo no atendimento / CRM?
Você decide isso sozinho ou alinha com sócio/financeiro?
Qual orçamento você já investiu em ferramentas/tecnologia hoje?
Decisão:
Qualificado → agenda 30min com Marina (agendar_reuniao)
Borderline → educa + retorna em 7 dias (follow-up)
Desqualificado → encerra respeitosamente
Handoff: salva qualified_data com fit + contexto pra Marina chegar preparada

Tools necessárias¶

Tool	Função
`qualificar_lead`	Salva progressivamente: nome, empresa, setor, processo-alvo, orçamento, decisor, fit
`consultar_disponibilidade`	Consulta agenda antes de oferecer horário (`[email protected]`)
`agendar_reuniao`	Cria evento Google Meet + salva no Calendar + notifica Marina
`reportar`	Escala pro ClickUp #Comercial. Prefixo sempre `[Vini SDR]`

Reutilizar tools existentes — as 4 já existem no sistema (ver tools table no Supabase). Verificar se agendar_reuniao está configurada com o calendar correto ([email protected]).

Variáveis dinâmicas¶

Chave	Descrição	Valor inicial
`nome_closer`	Nome da closer que recebe o lead	`Marina`
`produto_nome`	Nome do produto ofertado	`Operação IA`
`produto_descricao_curta`	Uma linha do produto	`Agentes IA rodando na sua operação em 30 dias`
`faixa_investimento`	Range de investimento para qualificação	`R$15k a R$25k`
`link_diagnostico`	Link de checkout do Diagnóstico (fallback se lead não quer call direto)	(preencher)
`janelas_reuniao`	Dias e horários disponíveis para a Marina	`ter-sex, 10-11h ou 14-17h`
`ativo`	Liga/desliga o agente	`true`

Tom de voz¶

Baseado no AGENT.md do Vini: - WhatsApp real: balões curtos, oral, sem markdown visível (*asterisco*, _negrito_) - Alta energia, organizados, perguntador — usa "tô certo?" e "faz sentido?" - Sem travessão (—) - Sem emojis excessivos (máx 1 por mensagem, só se natural) - Horário comercial: 08h-19h

Follow-up proativo¶

Estágio	Intervalo	Mensagem
`stage_1`	1h sem resposta	Lembrete suave — "Vi que você conferiu o kit..."
`stage_2`	1d sem resposta	Pergunta de qualificação direta
`stage_3`	3d sem resposta	Reengajamento com social proof (caso real anônimo)
`stage_4`	7d sem resposta	Encerramento respeitoso + abertura para retorno futuro

Checklist de configuração (Theo executa)¶

Pré-requisitos (confirmar com Júnior antes)¶

Instância Uazapi já criada. Token: 186ddd30-dd73-44bd-8bf3-2e2dbb44c476
Confirmar número WhatsApp vinculado à instância no painel https://grupogita.uazapi.com
agendar_reuniao tool: confirmar calendar_id correto ([email protected])

Configuração¶

Escrever prompt_text baseado em ~/gita/agents/junior-squad/comercial/vini-sdr/AGENT.md
Salvar em: ~/gita/agents/junior-squad/comercial/vini-sdr/whatsapp/captacao.prompt.md
Seções obrigatórias: identidade, estilo WhatsApp, fluxo BANT, quando escalar, tools, regras invioláveis
Criar migration SQL: supabase/migrations/0XX_insert_vini_sdr.sql
slug: 'vini-sdr'
client_name: 'Junior Maia'
channel: 'whatsapp', provider: 'uazapi'
model: 'gemini-2.5-flash' (SDR não precisa do Pro)
filter_own_messages: 'fromMe'
Aplicar migration no Supabase (SQL Editor)
Preencher via admin: provider_config.token = 186ddd30-dd73-44bd-8bf3-2e2dbb44c476 + gemini_api_key + webhook_secret (openssl rand -hex 16)
Preencher variáveis dinâmicas (tabela acima) via admin
Adicionar 'vini-sdr' em ROUTER_SLUGS no orchestrator.ts (agente sem router ainda precisa estar na lista se usar debounce específico)
NÃO adicionar regras no router-classifier.ts — Vini é tenant isolado sem router
npx tsc --noEmit — compilação limpa
Commit + push → Easypanel redeploya

Configurar webhook Uazapi na instância 186ddd30-dd73-44bd-8bf3-2e2dbb44c476:

URL: https://gita-engine-gita-agents.ewzc9p.easypanel.host/webhook/whatsapp/vini-sdr
Método: POST
Eventos: messages

Teste end-to-end: mandar mensagem pelo WhatsApp do número do Vini, confirmar resposta
Confirmar tenant isolation: SELECT client_name FROM messages WHERE ... LIMIT 5

Pós-deploy¶

Passar o número do Vini pro Júnior atualizar em src/lib/constants.ts da landing page
Júnior roda vercel --prod --yes na pasta ~/gita/lps/junior-kit-claude/

Escalações (`reportar`)¶

Motivos possíveis (sempre com prefixo [Vini SDR]):

Motivo	Quando usar
`nome_conhecido`	Lead menciona o Júnior pelo nome / já tiveram contato
`solicitou_humano`	Pedido explícito de falar com pessoa real
`urgencia_fechamento`	"Preciso contratar hoje / essa semana"
`fora_do_icp`	Lead claramente não é o perfil (MEI, estudante, etc.)
`orcamento_incompativel`	Deixa claro que não tem budget para a faixa
`concorrente`	Menciona concorrente direto (Alan Nicolas, Mentor[IA], AIOX)

Referências¶

Persona completa: ~/gita/agents/junior-squad/comercial/vini-sdr/AGENT.md
Template de prompt: ~/gita/docs/gita-agents/template.prompt.md
Runbook novo cliente: ~/gita/docs/gita-agents/runbook-novo-cliente.md
Editar variáveis: ~/gita/docs/gita-agents/edicao-prompts.md
Landing page do Kit: https://junior-kit-claude.vercel.app
Constants (atualizar número): ~/gita/lps/junior-kit-claude/src/lib/constants.ts linha 14