Documentação 12 min de leitura Essencial

Como configurar o agente de IA perfeito

O guia que toda empresa precisa para deixar a IA do WordChats atendendo no WhatsApp e Instagram com a mesma confiança de um vendedor experiente. Direto ao ponto, sem mistério.

A regra de ouro: 3 camadas

Um agente de IA bem configurado no WordChats fica organizado em três camadas. Cada uma tem uma função clara e cada informação fica em uma camada só — nunca repetida.

Quando você respeita essa divisão, a IA fica enxuta, rápida, gasta menos tokens e responde com muito mais precisão.

Identidade — quem a IA é
Base de Conhecimento — o que a IA sabe
Funil de Vendas — como a IA conduz
Por que dividir em 3?

Tudo junto num prompt gigante, a IA se confunde, alucina e gasta muitos tokens em toda conversa. Dividido em camadas, ela só consulta o que precisa na hora certa.

Antes de começar

Conta WordChats com plano ativo
Conexão de WhatsApp ou Instagram configurada
Conhecimento sobre seu negócio: produtos, preços, políticas, horários
Uma ideia clara de como sua equipe atende hoje (passo a passo)
Dica antes de mergulhar

Não tente ensinar tudo de uma vez. Comece com a Identidade, cadastre 5-10 artigos na Base de Conhecimento e só depois monte o Funil. Em 30 minutos você tem um agente publicável.

Camada 1 — Identidade do Agente

É o campo principal de texto do agente. Define quem a IA é e como ela se comunica. Conteúdo estável, curto e direto.

O que entra na Identidade

Nome, empresa e cargo da IA. Ex.: "Você é a Carla, consultora da Esmalteria Glamour."
Personalidade em 4 a 6 traços (ex.: acolhedora, prática, paciente).
Tom de voz: formal, semi-formal ou informal.
Emojis permitidos e quantos por mensagem (recomendado: máximo 2-3).
Tamanho das mensagens: curtas, estilo WhatsApp (2 a 4 linhas).
Tipos de cliente que ela atende (ex.: lead novo, cliente atual, suporte) — só os critérios para classificar.
Regras de OURO: o que ela NUNCA faz (ex.: nunca prometer prazo sem confirmar) e o que SEMPRE faz (ex.: sempre cumprimentar pelo nome).
Regra de supervisão: "Se não souber a resposta, diga que vai verificar com a equipe."

O que NÃO entra na Identidade

Lista de produtos com preços — vai para a Base de Conhecimento.
Horário de funcionamento, endereço, equipe — vai para a Base de Conhecimento.
Política de cancelamento, garantia, troca — vai para a Base de Conhecimento.
Roteiro de atendimento passo a passo ("primeiro pergunta nome, depois...") — vai para o Funil de Vendas.
Mensagens prontas tipo "Saudação:" "Apresentação de preço:" — vão para o Funil de Vendas.
Exemplo enxuto de Identidade (correto)

Você é a Carla, consultora da Esmalteria Glamour. Atende clientes via WhatsApp e Instagram. Personalidade: acolhedora, prática, paciente, atenciosa. Tom: semi-formal e amigável. Emojis: até 2 por mensagem (😊 ✨ 💅). Tamanho: 2 a 4 linhas por mensagem. NUNCA: prometer prazo sem confirmar com a equipe, falar mal de concorrentes, dar desconto sem autorização. SEMPRE: cumprimentar pelo nome, confirmar o que entendeu antes de avançar. Se não souber: "Deixa eu confirmar isso com a equipe e te respondo em instantes."

Exemplo ruim (não faça assim)

"Você é a Carla. Quando o cliente disser oi, responda: 'Olá! Tudo bem?'. Se ele perguntar preço, fale 'O esmalte gel custa R$ 80, o pé R$ 90...'. Política de cancelamento: até 24 horas antes... Endereço: Rua X, 123..."

Por quê é ruim? Você está misturando Identidade + Funil + Base de Conhecimento. A IA fica confusa, atualizar preço vira pesadelo e o prompt explode em tamanho.

Camada 2 — Base de Conhecimento

É onde mora tudo o que a IA precisa saber: produtos, preços, políticas, horários, endereços. A IA consulta sob demanda, só quando o cliente pergunta.

Por que separar em artigos?

A IA não precisa carregar a tabela inteira de preços toda hora. Ela busca o artigo certo quando o cliente pergunta. Isso economiza tokens, acelera respostas e facilita atualizações: se o preço mudar, você edita um artigo só, sem mexer no prompt.

O que vira artigo da Base

Lista de produtos / serviços com preços, descrição e condições
Política de cancelamento, garantia, devolução, troca
Formas de pagamento (PIX, cartão, parcelamento, links)
Horário de funcionamento (com exceções de feriados, almoço, etc)
Endereço, formas de chegar, estacionamento
Equipe / profissionais, especialidades, dias que atendem
Perguntas frequentes (FAQs) que sua equipe ouve toda semana
Detalhes técnicos de produtos (especificações, voltagens, tamanhos)

Como criar um bom artigo

1

Título curto e descritivo

3 a 8 palavras. Ex.: "Tabela de preços — esmalte em gel"

2

Categoria

Uma palavra. Ex.: Produtos, Políticas, Horários, Equipe.

3

Conteúdo autossuficiente

Quem ler só esse artigo entende a informação completa, sem precisar de outro.

Exemplo de artigo bem feito

Título: Tabela de preços — esmalte em gel

Categoria: Produtos

Conteúdo:

Esmalte em gel — preços e prazos: - Mãos: R$ 80 - Pés: R$ 90 - Combo (mãos + pés): R$ 160 (economia de R$ 10) Inclui retirada gratuita em até 15 dias após a aplicação. Marcas usadas: OPI e Vinity. Duração média: 21 a 28 dias. Necessário agendamento prévio (1 hora).

Quantos artigos no mínimo?

Para um agente bem configurado, recomendamos pelo menos 3 categorias com artigos: Produtos / Serviços, Políticas e Horários. Empresas com catálogo amplo costumam ter 15 a 30 artigos.

Camada 3 — Funil de Vendas

É o passo a passo que a IA segue numa conversa. Cada etapa tem um objetivo claro e uma mensagem-modelo. A IA só avança quando coletou o que era necessário na etapa anterior.

Quando vale a pena usar Funil?

Quando seu atendimento tem etapas claras: vendas consultivas, agendamentos, captação de leads, qualificação. Se sua operação é mais "tira-dúvidas livres" (suporte puro), pode pular o Funil sem perda.

Anatomia de uma etapa

Nome curto (2 a 4 palavras): Abertura, Sondagem, Apresentação, Fechamento
Objetivo: o que essa etapa precisa cumprir, em uma frase
Mensagem-modelo: a frase exata que a IA deve usar (ela pode adaptar levemente, mantendo o sentido)
Pré-requisitos: o que precisa estar coletado para avançar (ex.: nome, cidade, produto de interesse)

Quantas etapas?

Ideal: 4 a 12 etapas. Mais que isso, vira excesso de controle.
Menos de 3? Provavelmente o Funil não está ajudando — talvez nem precise.
Cada etapa deve ser distinta: se duas têm objetivo parecido, junte.
Exemplo de Funil para esmalteria
  1. Abertura — Cumprimentar e descobrir o canal preferido (texto / áudio).
    "Oi! Eu sou a Carla ✨ Você prefere que eu te explique por áudio curtinho ou por texto?"
  2. Sondagem — Descobrir o que a cliente quer (serviço, ocasião, prazo).
    "Posso te ajudar a escolher o serviço perfeito! Você está pensando em mãos, pés ou os dois?"
  3. Apresentação — Mostrar o serviço ideal com preço.
    "Para sua ocasião, indico o esmalte em gel mãos + pés (R$ 160). Posso te enviar mais detalhes?"
  4. Fechamento — Agendar dia e horário.
    "Que dia funciona melhor pra você? Tenho horário na quinta às 14h ou sábado às 10h."
  5. Confirmação — Confirmar agendamento e enviar lembretes.
    "Pronto! Agendei pra quinta às 14h. Vou te lembrar 1 dia antes 😊"
Erro comum: misturar Funil com Identidade

Se você escrever "primeiro pergunta o nome, depois o produto, depois apresenta o preço..." no campo da Identidade, está duplicando funções. Esse roteiro é trabalho do Funil.

Passo a passo: configurando do zero

O caminho mais rápido para um agente publicável em ~30 minutos.

1

Crie o agente

No painel WordChats, vá em Agentes IANovo Agente. Dê um nome interno (ex.: "Carla — Vendas").

2

Escreva a Identidade

Use o exemplo enxuto deste guia como ponto de partida. Foque em quem a IA é e como se comunica. Não passe de 30 linhas.

3

Cadastre a Base

Clique em Base de Conhecimento e crie 5 a 10 artigos: 1 para cada produto, 1 para cada política, 1 para horário, 1 para endereço.

4

Monte o Funil

Clique em Funil de Vendas e crie 4 a 6 etapas. Use o exemplo do guia como inspiração — adapte ao seu negócio.

5

Conecte ao WhatsApp / Instagram

Vincule o agente à sua conexão. A partir desse momento, ele já atende mensagens.

6

Teste e ajuste

Mande mensagens de teste pelo seu próprio celular. Anote o que ficou estranho e ajuste o ponto certo (Identidade, Base ou Funil).

O atalho: Reestruturar Agente

Se você já tem um agente com tudo num prompt gigante (do jeito antigo, sem dividir em camadas), o WordChats tem um botão que reorganiza tudo automaticamente.

Como funciona

No editor do agente, clique em Reestruturar Agente. A IA lê o seu prompt atual e devolve uma proposta com:

  • Uma Identidade enxuta (15 a 30% do tamanho original)
  • Uma lista de etapas sugeridas para o Funil
  • Uma lista de artigos sugeridos para a Base de Conhecimento

Você revisa, marca o que quer aplicar e clica em Aplicar tudo. Em segundos, o agente fica organizado nas 3 camadas.

Tranquilo: nada é perdido

O prompt antigo fica salvo no Histórico de Versões. Se não gostar do resultado, é um clique para voltar.

Diagnóstico do agente

Toda vez que você abre o Reestruturar Agente, o sistema roda um diagnóstico automático antes. Ele aponta problemas que estão prejudicando a performance da IA — e dá o botão para resolver.

O que ele detecta

Artigos duplicados ou muito parecidos na Base de Conhecimento
Artigos vazios ou curtos demais (menos de 50 caracteres)
Artigos sem categoria
Etapas duplicadas no Funil
Numeração com gaps (etapas 1, 2, 4, 5 sem o 3)
Conteúdo duplicado entre o Prompt e a Base de Conhecimento
Conteúdo duplicado entre o Prompt e o Funil de Vendas
Resolução com 1 clique

Cada problema vem com um botão que aplica a correção automaticamente: mesclar artigos, deletar duplicados, renumerar etapas, limpar trechos repetidos. Você não precisa entender o que está errado — só clicar em Resolver.

Quando o diagnóstico não acusa nada

Se o agente já foi reestruturado e nada mudou desde então, o sistema mostra "Agente saudável" e bloqueia uma nova reestruturação. Para liberar, basta editar o prompt, o funil ou a base.

Checklist do agente perfeito

Antes de soltar o agente para os clientes, confira:

Identidade tem entre 15 e 30% do tamanho de um prompt antigo gigante (se você tinha um)
Identidade não tem preços, listas, fluxos nem mensagens prontas
Base de Conhecimento com pelo menos 3 categorias preenchidas (Produtos, Políticas, Horários)
Cada artigo da Base é autossuficiente (entendível sozinho)
Funil com 4 a 12 etapas, cada uma com objetivo, mensagem-modelo e pré-requisitos
Diagnóstico rodado e zero problemas pendentes
Score de qualidade do agente: pelo menos 80 (nota A)
Testou no próprio celular com cenários reais (pergunta de preço, agendamento, dúvida fora do script)
Equipe sabe quando a IA transfere para humano e tem instruções claras de como continuar
Quando todos os itens estão checados

Você tem um agente que atende seu cliente com a mesma confiança de um vendedor experiente da sua equipe — só que 24 horas por dia, sem cansar e sem esquecer informação.

Boas práticas finais

Pense pequeno e cresça. Comece com 5 artigos e 4 etapas. Adicione conforme percebe falhas reais.
Atualize a Base, não o Prompt. Mudou o preço? Edite o artigo, não a Identidade.
Releia o prompt em voz alta. Se parecer um manual de 100 páginas, está pesado demais.
Cada artigo tem que valer por si só. Imagine que alguém vai ler só aquele artigo isolado.
Mensagens-modelo do Funil são guia, não camisa de força. A IA adapta o estilo, mas mantém o sentido.
Rode o Diagnóstico todo mês. Pequenas duplicações vão se acumulando — limpe antes que vire bagunça.

Perguntas frequentes

Sim. As 3 camadas (Identidade, Base de Conhecimento e Funil) funcionam exatamente igual nos dois canais. A diferença está só nas particularidades de cada plataforma (botões, áudios, mídia), tratadas pelo WordChats automaticamente.

Não obrigatoriamente. Se sua operação é mais de "tirar dúvidas livres" (suporte, FAQ), pode usar só Identidade + Base de Conhecimento. Para vendas, agendamento e qualificação, o Funil faz muita diferença.

Entre 100 e 1.500 palavras. Acima disso, provavelmente tem conteúdo que deveria estar no Funil ou na Base. O botão Reestruturar Agente te ajuda a chegar nesse tamanho automaticamente.

Comece com o essencial: 1 artigo de Produtos / Serviços (com tudo que você vende), 1 artigo de Políticas e 1 artigo de Horários e Endereço. São 3 artigos que cobrem 80% das perguntas. Depois você refina.

Você pode escolher 3 comportamentos no painel: a IA responde naturalmente que vai verificar, transfere para um atendente humano em geral, ou para um departamento específico (ex.: financeiro, suporte técnico).

Sim. Você pode ter um agente principal (vendedor) e agentes especialistas (suporte técnico, financeiro). O principal consulta os especialistas automaticamente quando a pergunta foge da área dele.

Cerca de 30 minutos para a primeira versão funcional, seguindo este guia. Para um agente realmente afiado, conte com mais 1 a 2 semanas de ajustes finos com base nas conversas reais.

Próximos passos

Quer ensinar a IA a identificar clientes específicos? Veja Automação de IA com tags.
Quer que a IA agende compromissos? Veja Integração com Google Agenda.
Quer conectar seu sistema externo à IA? Veja Integração via API.
Vai usar a API oficial da Meta? Veja WhatsApp Cloud API.

Precisa de ajuda?

Se quiser, nossa equipe pode configurar o agente com você: entender seu negócio, ajudar a desenhar o Funil e cadastrar os primeiros artigos da Base.

Falar com a equipe