Pular para o conteúdo
Abrir o Leadz

Boas práticas de prompt

Como escrever instruções que funcionam no Leadz, com exemplos de certo e errado.

No Leadz:AutomaçãoAgentes IA Abrir esta tela
Nesta página

O prompt é o texto de instruções do agente: é ele que decide se o agente atende bem e se as ações no CRM acontecem. Esta página reúne as regras que deram certo em teste no Leadz. Várias são diferentes do que se costuma escrever para outras ferramentas de IA.

Se você usa o ChatGPT, o Claude ou o Gemini para escrever o prompt, entregue a eles o manual do prompt. Ele ensina essas mesmas regras à outra IA.

#A regra que explica todas as outras

O agente do Leadz responde em uma passada só. Ele lê a conversa, escreve a resposta e, dentro dela, decide as ações. O Leadz envia o texto ao contato e executa as ações em seguida.

O agente não chama ferramenta, não recebe retorno e não espera confirmação. Então:

  • instrução que manda «esperar a confirmação» deixa o agente parado;
  • instrução que divide as ações em etapas faz o agente executar só a primeira;
  • instrução sem dizer quando agir faz o agente agir na hora errada.

#1. Diga quando cada ação acontece

Toda regra de ação deve ter o formato «Quando X, faça A, B e C na mesma resposta».

Errado Certo
«Mova os contatos interessados para a etapa de negociação.» «Quando o contato disser que quer comprar, mova o card para a etapa «Negociação» na mesma resposta.»
«Use as tags para organizar os contatos.» «Quando o contato disser que já é aluno, ponha a tag «aluno».»

#2. Peça todas as ações na mesma resposta

Se uma situação pede mais de uma ação, escreva todas na mesma regra.

Errado Certo
«Grave o ID no campo. Após a confirmação da gravação, mova o card.» «Quando o contato mandar o ID, grave no campo «ID da conta» e mova o card para a etapa «Conta enviada» na mesma resposta.»
«Só depois de executar a ação, responda ao contato.» «Na mesma resposta, faça a ação e responda ao contato.»
«Use a ferramenta de etiquetas para marcar o lead.» «Ponha a tag «quente».»

#3. Dado informado é dado gravado

Mande gravar o dado na mesma resposta em que o contato informou, mesmo que a conversa continue.

Errado Certo
«Colete o e-mail e, no fim do atendimento, registre.» «Quando o contato informar o e-mail, grave no campo «E-mail de compra» nessa mesma resposta.»

#4. Use os nomes exatos

O nome da etapa, da tag, do campo e do material nas instruções deve ser igual ao que está no Leadz. E o item precisa estar liberado no agente. Veja Ações no CRM.

Errado Certo
«Mande para a próxima fase.» «Mova para a etapa «Proposta enviada».»
«Marque como lead bom.» «Ponha a tag «qualificado».»

#5. Material é agora, nunca depois

O agente responde quando o contato escreve. Ele não volta sozinho mais tarde para enviar algo.

Errado Certo
«Diga que vai enviar o catálogo em seguida.» «Quando o contato pedir os preços, mande o material «Catálogo 2026» junto com a resposta.»

#6. Diga quando não agir

Sem essa regra, o agente pode pôr tag ou mover o card em qualquer pergunta.

  • «Em pergunta simples, sem dado novo nem pedido, só responda. Não mexa em tag, campo ou etapa.»
  • «Ao pôr a tag «quente», tire a tag «frio».»

#7. Uma instrução por linha

Escreva em lista, uma regra por linha. Um parágrafo longo esconde regras, e o agente pula a que está no meio.

Errado Certo
Um parágrafo de dez linhas que mistura tom, preço e regras de ação. Seções curtas, com título, e uma regra por linha.

#8. Prompt enxuto

Modelos menores esquecem ações quando as instruções são longas. Cada caractere também é enviado ao provedor em toda resposta e conta no seu consumo.

  • Corte repetição, história da empresa e frases de efeito.
  • Deixe as regras de ação juntas, numa seção própria.
  • Passe a lista de produtos para Descrições de Produtos / Serviços.
  • Se o agente esquece ações mesmo com o prompt enxuto, teste um modelo maior.

#9. Não repita o que o agente já sabe

A cada resposta, o agente já recebe:

  • o nome do contato, quando há nome salvo;
  • o canal da conversa;
  • a ficha do contato: status, origem, tags, campos preenchidos e negociações;
  • a etapa atual do card no CRM;
  • as tags da conversa;
  • as últimas 40 mensagens.

Aproveite isso nas regras:

Errado Certo
«Sempre comece perguntando o nome.» «Se ainda não souber o nome, pergunte uma vez.»
«Pergunte se ele já é cliente.» «Se a ficha mostrar a tag «aluno», trate como aluno e não ofereça o curso.»

O agente não recebe o telefone nem o e-mail do contato, e não sabe que horas são. Para usar o telefone num link, escreva a variável: https://exemplo.com/cadastro?tel={{phone}}.

O agente só envia um link que esteja escrito, por inteiro, nas instruções ou num material. Link inventado é descartado.

Errado Certo
«Envie o link de pagamento.» «O link de pagamento é https://exemplo.com/checkout. Quando o contato quiser comprar, mande um botão de link com o texto «Comprar agora».»

#11. Não prometa o que o agente não faz

O agente não consulta pagamento, estoque, agenda nem área de membros. Ele não cria card e não escolhe quem da equipe assume.

Errado Certo
«Verifique se o pagamento foi aprovado.» «Se o contato disser que pagou, peça o comprovante e transfira para um humano.»
«Agende a reunião na agenda.» «Mande o botão de link da agenda: https://exemplo.com/agenda.»

#12. Defina quando transferir

Diga em quais situações o agente chama a equipe. Sem isso, ele tenta resolver tudo.

  • «Quando o contato pedir reembolso ou reclamar, avise que a equipe vai continuar e transfira para um humano.»
  • «Quando você não tiver certeza da resposta, não invente. Transfira para um humano.»

#13. Não escreva códigos

Escreva em português normal. Não invente marcações, colchetes ou comandos para as ações: o Leadz ensina o formato ao agente por conta própria. Uma marcação inventada confunde o agente e pode chegar escrita para o contato.

#Estrutura recomendada

Um prompt que funciona costuma ter estas seções, nesta ordem:

  1. Quem você é: nome, empresa e papel, em 2 ou 3 linhas.
  2. Tom: como fala e o tamanho das mensagens.
  3. O que vende: produto, preço, garantia e links.
  4. Perguntas frequentes: uma por linha, com a resposta curta.
  5. Regras de ação: uma por linha, sempre «Quando… faça… na mesma resposta».
  6. Quando transferir para um humano.
  7. O que nunca fazer.

Um exemplo completo, pronto para adaptar, está no manual do prompt.

#Limites para ter em mente

Item Limite
Instruções base 16.000 caracteres
Descrições de Produtos / Serviços 12.000 caracteres
Botões de resposta 3 por mensagem, 20 caracteres cada
Botão de link 1 por mensagem, texto de até 20 caracteres
Mensagens por resposta até 10
Histórico que o agente lê últimas 40 mensagens

#Depois de escrever

Teste cada regra no botão Testar e confira se as ações aparecem nas notas. O roteiro está em Testar o agente.

#Problemas comuns

O agente responde bem, mas esquece de mover o card

É o sintoma de instrução em etapas. Procure no prompt por «após», «depois de» e «confirmação» e reescreva como uma regra só: «Quando…, faça A e B na mesma resposta». Se continuar, encurte o prompt ou use um modelo maior.

O agente responde «vou verificar» e não volta

Alguma regra pede que ele consulte ou confirme algo. Ele não consegue. Troque por uma ação que ele faz (gravar, pôr tag, mover) ou pela transferência para um humano.

O agente põe tags em toda mensagem

Falta a regra de quando não agir. Veja o item 6.

O agente pergunta de novo o que o contato já disse

A informação saiu das últimas 40 mensagens, ou nunca foi gravada. Mande gravar os dados importantes em campos: eles ficam na ficha e o agente lê a ficha em toda resposta.

#Veja também

Este artigo ajudou?

Mais em Agentes IA

Ver os 9 artigos