"Guia completo: construindo um agente do zero"
O passo a passo de quem monta um agente profissional no editor de cinco abas, do fluxo guiado à publicação.
Este é o mapa de como um agente do ScalaCRM funciona e a ordem certa de construí-lo. Não precisa ler tudo antes de começar: o fluxo guiado (Agentes IA → Criar agente guiado) faz as perguntas por você e monta a primeira versão. Este guia serve para entender cada peça e levar o agente de "funciona" para "profissional".
Como o agente funciona por dentro
Toda vez que um lead manda mensagem, o agente:
- Espera alguns segundos para o lead terminar de digitar mensagens picadas;
- Confere onde pode atuar: a caixa de entrada, a etapa do funil e o público (por exemplo, só leads de anúncio);
- Monta o contexto: quem ele é, o que sabe do seu negócio, o histórico da conversa e o que já descobriu daquele lead;
- Escreve a resposta e, quando a situação pede, age: move o lead no funil, avisa alguém, agenda;
- Passa pelas travas antes de enviar: termos que nunca podem sair e, se ligada, a conferência de valores.
Antes de construir: a Biblioteca
Confira Agentes IA → Biblioteca. Ela tem 11 agentes prontos (SDR da autoescola, recepção de clínica, triagem de escritório, vendedor de loja, orçamentista, recepcionista, pós-venda e outros), com as perguntas frequentes e os cuidados do setor já escritos. O agente instalado é um agente comum: tudo deste guia vale para ajustá-lo depois.
O caminho rápido: o fluxo guiado
O fluxo faz uma pergunta por tela, com exemplo ao lado. As telas que mais pesam:
- O que vocês vendem: o catálogo, com opções de preço (categoria, plano, duração) e custos pagos à parte. Dá para Importar uma tabela: cole o texto ou envie foto/PDF; o resultado é um rascunho para conferir. É daqui que o agente tira os preços.
- Aprender com conversas (opcional): o agente lê de 3 a 15 conversas reais da equipe e sugere perguntas, objeções e situações. Ver Aprender com conversas.
- As perguntas de sempre: no formato
Pergunta:/Resposta:o sistema lê sem cortar, até 60 perguntas. - As situações que se repetem: cada situação vira um procedimento (até 15), com gatilho e passos na ordem.
- O funil e O que acontece no CRM: quando o agente coloca o lead em cada etapa e quem é avisado.
- Como você fica sabendo: o WhatsApp do responsável (escolha o país e digite o número; o botão Enviar teste confirma que a mensagem chega) e o horário de atendimento, que entra em toda fala de repasse.
- Retomar a conversa: as mensagens de follow-up e em quais etapas valem.
Passos que não servem ao seu negócio têm Meu negócio não precisa disso; Ligar este passo traz de volta. O agente montado já nasce com leitura de imagens e PDFs, espera de 20 segundos, memória das últimas 30 mensagens e conferência de valores quando o catálogo tem preço.
Na Revisão aparece a conferência do que parece errado (etapa citada sem ação que mova o lead, situação de repasse sem horário). Ela só avisa. Refazer montagem monta de novo com as respostas atuais.
💡 Trocar um agente que já atende: o fluxo pergunta se o novo vai substituir o atual. O antigo continua atendendo enquanto você testa. Comparar com {agente antigo} mostra lado a lado o que cada um responderia a conversas reais, sem gastar seus créditos. No fim, Colocar {novo} no lugar de {antigo} faz a troca; Voltar para este agente, no antigo, desfaz.
Passo 1: Conhecimento (fatos)
A aba Conhecimento guarda o que o agente sabe. Ele é proibido de inventar.
- Quem é e como fala: nome que usa com o cliente, objetivo, tom de voz e Estilo e observações (só jeito de falar).
- Sobre a empresa e O que vocês vendem: o pano de fundo.
- Catálogo de produtos: o agente conhece nome, preço e condições do que está em Produtos.
- Perguntas frequentes: até 60 pares. Use as palavras que o CLIENTE usa.
- Textos oficiais: saem exatamente como você escreveu (tabela de preços, aviso legal).
- Fontes de conhecimento: site, arquivos e textos longos que ele consulta por busca.
Passo 2: Procedimentos (o que fazer)
Cada procedimento é uma situação: nome, Quando usar e passos (Falar, Perguntar e esperar, Fazer uma ação, Se…, Voltar ao passo, Encerrar por agora). Pode ter Critério de decisão (nunca dito ao cliente) e Exemplos de conversa. Ligue Usar em toda conversa só no roteiro principal.
Regra prática: se você se pega escrevendo "quando o cliente fizer X, faça Y", isso é um procedimento. Na mesma aba fica Informações que o agente precisa descobrir, para ele não perguntar duas vezes.
Passo 3: Ações (o que ele executa)
Ações são o que o agente faz no CRM: mover lead no funil, notificar via WhatsApp, notificar usuário no CRM, criar tarefa, consultar horários, agendar, coletar documentos. Três regras de ouro:
- A descrição decide o uso. Escreva no imperativo, com o critério do seu negócio: "Mova o lead para Qualificado quando ele confirmar interesse e orçamento".
- O destino é seu, não dele. A etapa, o número e o usuário saem da configuração; o agente só decide o momento.
- Encadeie o que sempre anda junto. Uma ação pode disparar outra em seguida (mover para Qualificado e avisar a equipe).
Passo 4: Políticas (onde, ritmo e travas)
Em Políticas: Onde atende (caixas de entrada, funis e etapas), Quem atende (todos ou só leads de anúncio), Ritmo, Quando uma pessoa responde, Retomar quem parou de responder e Travas.
- Instrução ("nunca prometa resultado") vira procedimento: o agente lê e segue.
- Termos que nunca podem sair é um trecho de texto conferido na resposta pronta. Se aparecer, o agente reescreve; se insistir, a resposta é segurada e a equipe avisada. Use o campo Testar para ver qual trava dispararia.
Passo 5: Testar, publicar e ativar
- Na aba Testes, Testar agente é uma conversa simulada (1 crédito por mensagem). O que ele faria aparece como aviso, nada acontece de verdade. Dá para simular personas, como lead apressado ou cético com preço.
- Salvar esta conversa como teste cria testes; marque Obrigatório para publicar nos que não podem falhar.
- Confira a caixa Antes de ativar: o marcador Impede ativar aponta configuração quebrada, como etapa apagada ou ação inexistente.
- Salvar guarda o rascunho, Publicar cria a versão que atende e Ativar coloca no ar (publicando o rascunho se ele mudou). Veja Publicar e testar o agente.
Para o programador
A integração n8n entrega cada mensagem num webhook seu, e a API v1 cobre contatos, cards, conversas e vendas. O editor dá de graça a infraestrutura em volta: janela de 24h, travas, medição por resposta e versões publicadas.
