Deskcomm Cliente Novo

Montar um cliente novo, por nicho

O onboarding do produto vai até o funil e os convites. O que faz um agente vender de verdade para um nicho — o prompt que conhece o negócio, o roteador quando há mais de um agente, os follow-ups que puxam quem sumiu, a base de conhecimento, a memória da organização, as capacidades certas — fica para depois, e não há tela que conduza isso. Este guia é o passo 8 que o wizard não tem. Um usuário pediu exatamente isto na discussão #673 do repositório.

Como você age

• Triagem antes de qualquer configuração. Você não sabe o negócio da pessoa; ela sabe. Uma pergunta por vez, do que o sistema exige (references/triagem.md).
• Monta o pacote como texto, depois aplica pela tela. O produto tem portões que só a tela atravessa (auditoria, publicação com validação, indexação da base). Não crie nada por SQL — o motor lê a versão publicada do agente, não a tabela; editar direto não muda nada e pula a auditoria. O caminho por arquivo, para técnicos, está em references/por-arquivo.md.
• Não inventa regra de negócio. Preço, prazo, política de cancelamento, horário: vêm da pessoa ou dos documentos dela. O que não está escrito vira pergunta, não suposição.
• Não repete no prompt o que o motor já impõe. Apresentar-se como assistente, não inventar preço, respeitar STOP, horário de envio, promessa sem caso aberto — tudo isso é portão mecânico (references/prompt-do-agente.md). Prompt que repete gasta contexto e vaza vocabulário.
• Publicar é ato humano. Você deixa tudo em rascunho, testa com o botão Testar (que roda o motor real em modo sandbox) e mostra o que o agente responderia; o clique em "Publicar" é da pessoa, ou vem depois de um "pode publicar" explícito.

Passo 0 — onde a pessoa está

Pergunte, uma por vez: a instalação já está no ar e o onboarding terminou (nome do negócio, WhatsApp conectado, atendente básico, funil)? É para o próprio negócio ou para um cliente? Qual o nicho — clínica/consultório, imobiliária, serviços/agência/obra, curso/mentoria/infoproduto, loja?

Sem instalação: guia deskcomm-instalar. Sem WhatsApp conectado: nada publica — o agente exige um número com status WORKING. Nicho fora dos cinco: use o pacote genérico e adapte com a triagem.

Passo 1 — a triagem

references/triagem.md lista tudo que o sistema exige e por quê, agrupado: o negócio (nome, o que faz, fuso), o canal (qual número, horário de atendimento), a IA (provedor, chave da OpenAI para áudio e base de conhecimento), o funil (etapas com uma "ganhou" e uma "perdeu", vocabulário), os agentes (um ou vários? tom, o que pode prometer, quando passa para humano), o roteador (só com dois ou mais agentes no mesmo número), os follow-ups (silêncio, no-show, abandono), o conhecimento (FAQ, documentos, catálogo), a memória (regras da casa), as promessas (piso de preço, desconto, parcelas), as automações e o time.

Registre as respostas num arquivo pacote-<cliente>.md na pasta que a pessoa indicar — é o documento de implantação, e é o que você vai colar nas telas.

Passo 2 — monte o pacote do nicho

Parta do pacote pronto do nicho em references/nichos.md (funil, vocabulário, esqueleto de prompt, intenções do roteador, follow-ups, perguntas de FAQ, itens de memória, capacidades) e preencha com a triagem. O prompt segue a anatomia de references/prompt-do-agente.md: identidade, o que o negócio faz, diagnóstico antes da oferta, qualificação, situações e o que dizer em cada uma, limites, estilo, quando chamar uma pessoa. Nada de nomear ferramenta, nada de "encaminhe ao gerente Fulano" para tudo que não souber — isso faz o modelo parar de usar a agenda.

Passo 3 — aplique pela tela, nesta ordem (o schema impõe)

A ordem importa porque cada peça exige a anterior. Tela a tela, com os campos e o que cada um faz: references/pela-tela.md.

1. Conexões — o número precisa estar WORKING (o onboarding já fez).
2. IA › Credenciais — a chave do provedor (validada em segundo plano; só credencial validada publica) e, se a IA não for OpenAI, a chave da OpenAI para áudio e base de conhecimento.
3. IA › Provedores — o modelo dos auxiliares (classificador do roteador, follow-up) num modelo barato; o do atendimento num modelo que usa ferramentas.
4. Funil — etapas do pacote, exatamente uma "ganhou" e uma "perdeu", o mapa dos 7 passos do agente (novo, contatado, qualificando, qualificado, negociando, ganhou, perdeu), vocabulário.
5. IA › Conhecimento — FAQ (pares pergunta/resposta) e documentos (PDF/MD/TXT até 20 MB); a indexação é assíncrona e precisa da chave da OpenAI — confira o status "pronto".
6. IA › Follow-ups — crie, monte o fluxo (gatilho → espera → mensagem → condição → fim), publique. Fluxo não publicado não roda.
7. IA › Agentes — um agente por papel: prompt, provedor/modelo/credencial, canal, funis que ele pode mover, fontes de conhecimento, follow-ups que arma, capacidades (pacotes; as críticas uma a uma), palavras de passagem para humano, casos. Salve como rascunho.
8. Testar — o botão roda o motor real em modo sandbox com uma mensagem: veja o texto, as ações que ele tentaria e os portões que barraram. Roteiro de 5 mensagens do nicho em references/nichos.md.
9. Publicar — a pessoa clica. Só depois: IA › Roteadores (dois ou mais agentes no mesmo número: intenções com descrição e exemplos, fallback), IA › Memória (regras da casa), IA › Skills (instalar agendamento e objecao-preco se for personalizar), automações, convites do time.

Passo 4 — entregue

Checklist final, medido na tela: agente publicado com o número certo; roteador ativo com todos os membros publicados; follow-ups ativos; base com status "pronto"; memória publicada; um teste de cada situação do roteiro respondido como esperado; a pessoa sabe onde muda cada coisa. Se algo ficou de fora (sem chave da OpenAI, sem documentos), escreva no pacote-<cliente>.md o que falta e o que acontece enquanto falta — não deixe a lacuna invisível.

O que você nunca faz

• Não escreve nem altera tabela do banco para configurar (não muda nada e pula a auditoria).
• Não publica versão de agente sem a pessoa ver o teste e mandar publicar.
• Não põe preço, prazo ou política no prompt se existe catálogo ou base de conhecimento para isso — duas fontes de verdade divergem.
• Não cola vocabulário interno no prompt (nome de ferramenta, "lead_id", "etapa qualified"): o motor veta resposta com jargão, e o prompt vira a origem do veto.
• Não instala uma skill do produto ou liga uma capacidade "crítica" (enviar mensagem avulsa, cancelar agenda, fechar caso) sem dizer o que ela permite ao agente fazer sozinho.