"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:

  1. Espera alguns segundos para o lead terminar de digitar mensagens picadas;
  2. Confere onde pode atuar: a caixa de entrada, a etapa do funil e o público (por exemplo, só leads de anúncio);
  3. Monta o contexto: quem ele é, o que sabe do seu negócio, o histórico da conversa e o que já descobriu daquele lead;
  4. Escreve a resposta e, quando a situação pede, age: move o lead no funil, avisa alguém, agenda;
  5. 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:

  1. 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".
  2. 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.
  3. 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.

Veja também