- Onde configurar?
- Como funciona o ajuste de comportamento
- Ajustes finos
- O Conceito-Chave: Agente não nasce pronto, ele é treinado
- Etapa Extra (Obrigatória): Testes com o botão Testar Agente
- Conclusão
O Agente de IA do ZapiCRM pode ser configurado para atuar de acordo com as necessidades do seu negócio, adaptando sua forma de responder, conduzir conversas e interagir com os clientes.
Ajustar o comportamento do agente é essencial para garantir respostas mais naturais, coerentes e alinhadas com o seu atendimento.
Onde configurar? #
Vá em Recursos VIP → Agentes de IA → Selecione o agente de IA → clique nos 3 pontinhos → Editar.

Como funciona o ajuste de comportamento #
Dentro da edição do agente, você encontrará o campo chamado Prompts do Agente.
Nesse espaço, você pode inserir instruções personalizadas que orientam o agente sobre:
- Forma de comunicação. (mais formal ou informal)
- Objetivo do atendimento. (suporte, vendas, agendamento, etc.)
- Regras específicas do seu negócio.
- Maneira de conduzir a conversa com o cliente.
Essas instruções funcionam como um guia para a IA, influenciando diretamente na qualidade e no estilo das respostas.
Quando bem configuradas, elas fazem o agente:
- Soar humano. (não robótico)
- Conduzir a conversa de forma comercial.
- Responder somente com base em dados reais.
- Usar corretamente a base de conhecimento.
- Saber o momento certo de transferir para humano.

Sua estrutura principal é:
- Persona.
- Contexto.
- Objetivo.
- Diretrizes.
- Saudação.
- Script de Triagem.
- Instrução de Transferência.

Persona – Quem o agente é: #
Função #
Define a identidade, tom e postura emocional do agente.
Boas práticas: #
- Seja específico, mas simples.
- Evite adjetivos demais.
- Pense como uma pessoa real de WhatsApp.
Recomendações #
- Idade, local e perfil profissional ajudam.
- Defina como ele fala, não só quem ele é.
Exemplo eficaz #
Você é André, consultor de vendas virtual da ZapiCRM.
Idade: 35 anos
Perfil: experiente em vendas, direto, educado e confiável.
Estilo: conversa natural de WhatsApp, sem formalidade excessiva.
Tom: comercial, seguro e prestativo.
Evite #
- “Muito animado”
- “Extremamente formal”
- “Sempre feliz”
Esses termos geram respostas artificiais.
Contexto — Onde e com quem ele está falando #
Função #
Diz ao agente em que cenário ele está atuando.
Boas práticas #
- Explique o tipo de cliente.
- Explique o canal. (WhatsApp, leads de anúncio, inbound etc.)
- Explique o momento da conversa.
Exemplo #
Você atende clientes que entram pelo WhatsApp após clicar em anúncios ou links do site.
Normalmente eles pedem preço, informações rápidas ou querem entender se a solução serve para o negócio deles.
💡Contexto ruim = respostas genéricas.
💡Contexto bom = respostas precisas.
Objetivo — O que ele precisa alcançar #
Função #
Evita que o agente “converse bonito” sem gerar resultado.
Boas práticas #
- Liste objetivos claros.
- Priorize ações, não conceitos.
Exemplo #
- Entender a necessidade do cliente.
- Qualificar o lead.
- Direcionar para vendedor humano no momento certo.
- Nunca inventar informações.
Diretrizes — As regras de comportamento #
Função #
Controla o que o agente pode ou não fazer.
Diretrizes essenciais #
- Linguagem simples.
- Uma pergunta por mensagem.
- Nunca inventar respostas.
- Sempre usar a base de conhecimento quando existir.
- Se não souber, admitir e transferir.
Exemplo #
- Use frases curtas e naturais.
- Faça apenas uma pergunta por mensagem.
- Nunca presuma informações.
- Se algo não estiver na base de conhecimento, informe que irá encaminhar para um atendente.
⚠️Diretrizes mal definidas = agente criativo demais.
Saudação — Primeira impressão #
Função #
Abrir a conversa de forma humana e contextual.
Boas práticas #
- Adaptar ao horário.
- Ser curta.
- Não vender na primeira frase.
Exemplo #
Olá! Bom dia
Posso te ajudar em alguma informação sobre a ZapiCRM?
❌Evite:
- Textos longos.
- Emojis em excesso.
- Pitch de venda na saudação.
Script de Triagem — O coração da conversão #
Função #
Guiar a conversa passo a passo até o momento certo de venda humana.
Boas práticas #
- Linguagem simples
- Perguntas diretas
- Fluxo lógico
Estrutura recomendada #
- Interesse inicial
- Cenário do cliente
- Intenção (avaliar, contratar, comparar)
- Forma de decisão (sozinho / equipe)
- Encaminhamento para humano
Exemplo #
Hoje você usa algum sistema para atendimento ou vendas pelo WhatsApp?
💡Script bom parece conversa, não formulário.
Instrução de Transferência — Quando chamar um humano #
Função #
Evita atrito e frustração.
Boas práticas #
- Definir gatilhos claros
- Linguagem natural
- Sem parecer “erro do sistema”
Gatilhos comuns #
- Pedido de preço final
- Pedido de proposta
- Perguntas fora da base
- Pedido explícito por humano
Exemplo #
Vou te colocar agora com um especialista para te ajudar melhor, só um minuto por favor.
Ajustes finos #
Base de Conhecimento — Fonte da verdade #
A Base de Conhecimento permite que o agente acesse informações específicas de sua empresa para responder às perguntas dos clientes.

Função #
Garantir respostas corretas e consistentes.
Boas práticas para os documentos #
- Textos objetivos.
- Frases curtas.
- Um tema por parágrafo.
- Evitar marketing excessivo.
- Evitar PDFs longos e genéricos.
Recomendações praticas #
- Prefira PDFs estruturados.
- Use títulos claros.
- Evite ambiguidade.
💡Quanto mais clara a base, menos o agente “inventa”.
Ferramentas do Agente — Quando usar dados externos #
As ferramentas permitem que o agente se conecte com sistemas externos através de APIs REST.
Função #
Buscar dados reais via API (estoque, status, agenda, valores).
Boas práticas #
- Explique claramente quando usar cada ferramenta.
- Defina o formato da resposta esperada.
- Nunca misture ferramenta + criatividade.
Exemplo #
Utilize a ferramenta #lista_veiculos# apenas quando o cliente informar o modelo do veículo.
O Conceito-Chave: Agente não nasce pronto, ele é treinado #
Na ZapiCRM, o agente de IA não deve ser configurado uma única vez.
O comportamento ideal surge de um processo iterativo:
Configurar → Testar → Ajustar → Testar novamente.
É exatamente por isso que o botão Testar Agente existe.
Etapa Extra (Obrigatória): Testes com o botão Testar Agente #
Para que serve o Testar Agente? #
O botão Testar Agente permite simular uma conversa como se você fosse o cliente, sem risco de erro em produção.
Durante o teste, você consegue validar:
- Tom de voz.
- Naturalidade da conversa.
- Clareza das perguntas.
- Uso correto da base de conhecimento.
- Momento de transferência para humano.
Como executar um teste eficiente (passo a passo) #
Entre no agente e clique em Testar Agente #
Vá em Recursos VIP → Agentes de IA → Selecione o agente de IA → clique nos 3 pontinhos → Testar Agente.
- Pense como um cliente real
- Não “ajude” o agente
- Faça perguntas curtas, confusas ou incompletas (como no WhatsApp real)
Exemplos:
- “quanto custa?”
- “funciona pra mim?”
- “tem integração?”
- “me manda mais info.”

Simule cenários reais #
Durante o teste, varie o comportamento:
- Cliente apressado
- Cliente curioso
- Cliente direto
- Cliente indeciso
- Cliente técnico
Isso revela falhas que não aparecem em testes “educados”.
Avaliação do teste: Tudo ok ou Sugerir Melhoria #
Após algumas mensagens, o próprio agente exibirá dois botões:
- Tudo ok.
- Sugerir Melhoria.
Quando clicar em Tudo ok #
Use quando:
- Linguagem está natural.
- Perguntas fazem sentido.
- Agente respeitou a base de conhecimento.
- Transferência ocorreu no momento certo.
⚠️Não clique em Tudo ok se algo incomodou, mesmo que pouco.
Quando clicar em Sugerir Melhoria #
Essa é a parte mais poderosa do processo.
Ao clicar em Sugerir Melhoria:
- Abre-se um campo de texto.
- Você descreve sua experiência como cliente.
- Não precisa escrever prompt técnico.
- Escreva como feedback humano.
Exemplo de boa sugestão:
- O agente ficou muito formal nas respostas iniciais.
- Poderia usar frases mais curtas e linguagem mais natural de WhatsApp.
- Também demorou para encaminhar para um atendente quando pedi preço.
O que acontece após enviar a sugestão? #
A ZapiCRM faz algo único:
✅O sistema analisa sua recomendação
✅Gera automaticamente um PDF de ajustes
✅O PDF vem separado por blocos do agente, como:
- Persona
- Contexto
- Objetivo
- Diretrizes
- Script de Triagem
- Transferência
Ou seja:
Você não recebe teoria — recebe ajustes prontos.
Como aplicar as melhorias (processo ideal) #
Abra o PDF gerado #
- Leia com calma.
- Entenda a lógica das mudanças.
Copie e cole os ajustes #
- Substitua os textos de cada bloco.
- Não misture versões antigas com novas.
Salve o agente #
- Evite testar sem salvar.
- Garanta que o prompt atualizado está ativo.
Teste novamente #
Clique outra vez em Testar Agente e repita o processo.
⚠️Normalmente, em 2 a 4 ciclos, o agente atinge um comportamento muito próximo do ideal.
Dicas avançadas para testar melhor #
Teste sempre com mensagens curtas
Clientes reais raramente escrevem textos longos.
Teste perguntas fora do fluxo
Isso valida se o agente respeita a base de conhecimento ou inventa respostas.
Observe o tempo de transferência
Agente que demora demais perde conversão.
Agente que transfere cedo demais perde qualificação.
Teste após qualquer ajuste
Nunca presuma que uma mudança melhorou sem testar.
Ciclo recomendado de melhoria contínua #
- Ajustar prompts
- Testar agente
- Sugerir melhoria
- Aplicar PDF
- Testar novamente
Repita até o agente:
- Soar humano
- Ser comercial
- Responder com precisão
- Transferir no momento certo
Conclusão #
Na ZapiCRM, testar não é opcional — é parte do método.
O botão Testar Agente transforma o usuário em:
- Avaliador.
- Treinador.
- Ajustador do comportamento da IA.
Isso garante que o agente:
- Evolua rápido.
- Aprenda com a experiência real.
- Atue exatamente como você espera.