Para criar um agente de IA no WhatsApp você precisa de quatro coisas: um número conectado à API oficial da Meta, uma plataforma de agentes, uma base de conhecimento com os dados da sua empresa e regras claras de quando passar a conversa para um humano. Neste guia, você monta isso na prática, passo a passo — na ordem certa e sem os erros que custam caro.

Se você ainda não sabe o que é um agente de IA ou está avaliando se vale a pena, comece pelo nosso guia completo de agentes de IA no WhatsApp. Este artigo aqui é mão na massa.

Antes de começar: o checklist

Separe isto antes do passo 1, senão você trava no meio:

  • Um número de telefone dedicado ao agente (pode ser novo — recomendado — ou um número migrado, que deixará de funcionar no app comum).
  • Conta comercial da Meta (Meta Business) verificada ou em processo de verificação.
  • O histórico do seu WhatsApp atual — de onde vamos extrair as perguntas reais dos seus clientes.
  • Acesso à sua agenda/CRM, se quiser que o agente marque horários de verdade.

Passo 1 — Defina um escopo pequeno (é sério)

O erro número um é querer que o agente faça tudo no primeiro dia. Comece com o par que dá mais resultado com menos risco:

  • FAQ: preço, horário, endereço, formas de pagamento, políticas.
  • Agendamento: consultar horários, marcar, remarcar, lembrar.

Negociação, casos delicados e exceções ficam com humanos — por enquanto. Escopo pequeno significa menos chance de o agente responder errado e mais rápido para você medir se funciona.

Passo 2 — Monte a base de conhecimento com perguntas reais

Abra o histórico do seu WhatsApp e liste as 20 perguntas mais frequentes dos últimos 90 dias, com as respostas que a sua melhor atendente daria. Esse documento é o coração do agente — mais importante que a plataforma, mais importante que o modelo de IA.

Formato que funciona bem:

Pergunta do cliente (como ele escreve) Resposta ideal Quando escalar para humano
“qnt custa a consulta?” Valor, o que inclui, formas de pagamento Se pedir desconto
“tem horário sábado?” Horários reais da agenda Nunca — agente resolve
“quero cancelar” Política de cancelamento + confirmação Se demonstrar insatisfação

Repare na terceira coluna: cada item da base já nasce com a regra de escalonamento. Isso vai economizar muita dor de cabeça no passo 6.

Passo 3 — Escolha a plataforma

O filtro completo está no guia principal, mas o resumo inegociável:

  1. API oficial da Meta — se a plataforma se conecta “lendo o WhatsApp Web”, descarte: é risco de banimento do seu número.
  2. Base de conhecimento própria — você precisa conseguir subir o documento do passo 2.
  3. Transferência para humano — com histórico da conversa, sem o cliente repetir tudo.
  4. Integração com sua agenda/CRM — sem isso, o “agendamento” vira só promessa.

Passo 4 — Conecte o número à API oficial

O processo geral (a plataforma escolhida guia os detalhes):

  1. Crie ou acesse sua conta no Meta Business.
  2. Registre o número na WhatsApp Business Platform (a plataforma costuma fazer isso por você via “embedded signup”).
  3. Confirme o código de verificação enviado ao número.
  4. Preencha o perfil comercial: nome, logo, descrição, site, horário.

Atenção: um número conectado à API deixa de funcionar no aplicativo comum do celular. Por isso a recomendação de usar um número novo e manter o antigo durante a transição.

Passo 5 — Escreva as instruções do agente

Toda plataforma tem um campo de “instruções” (o prompt do sistema). É ali que você define personalidade, limites e comportamento. Um esqueleto que funciona:

Você é o assistente virtual da [EMPRESA], especializada em [O QUE FAZ]. Seja cordial, direto e use linguagem simples. Sempre se apresente como assistente virtual na primeira mensagem.

Você PODE: responder sobre preços, serviços, horários e endereço; consultar a agenda e marcar/remarcar horários; explicar políticas.

Você NÃO PODE: dar descontos, fazer diagnósticos, discutir assuntos fora da empresa, inventar informações que não estão na base de conhecimento.

Se o cliente pedir algo fora da sua alçada, ficar insatisfeito ou pedir para falar com uma pessoa, transfira imediatamente para o atendimento humano com um resumo da conversa.

Duas regras de ouro ao escrever instruções:

  • Proíba a invenção. A instrução “se não souber, diga que vai verificar e transfira” evita o pior cenário: o agente inventando preço ou prazo.
  • Exija a identificação como assistente virtual. Além de ser a prática correta frente à LGPD, evita a sensação de “fui enganado” que destrói a confiança do cliente.

Passo 6 — Configure o escalonamento para humano

Defina os gatilhos que transferem a conversa imediatamente:

  • Cliente pede para falar com uma pessoa (qualquer variação: “atendente”, “humano”, “alguém aí?”).
  • Cliente demonstra irritação ou insatisfação.
  • Assunto envolve negociação, reclamação formal ou caso sensível.
  • O agente não encontra a resposta na base de conhecimento.

E defina o que acontece depois: quem recebe, em quanto tempo responde, e o que o cliente ouve enquanto espera (“Vou te transferir para a equipe, respondemos em até X minutos”).

Passo 7 — Rode em paralelo por duas semanas

Não vire a chave de uma vez. Nas duas primeiras semanas:

  1. Deixe o agente respondendo, mas com uma pessoa acompanhando as conversas em tempo real, pronta para intervir.
  2. Anote toda resposta errada, estranha ou incompleta.
  3. No fim de cada dia, corrija a base de conhecimento e as instruções com base no que anotou.

É nesse período que o agente sai de “genérico” para “parece que conhece a empresa há anos”. A diferença está nos ajustes, não na tecnologia.

Passo 8 — Meça e só então expanda

Três métricas bastam no início:

Métrica O que diz Sinal de saúde
% resolvido sem humano Quanto o agente segura sozinho Crescendo semana a semana
Tempo até a primeira resposta Velocidade percebida pelo cliente Segundos, a qualquer hora
Transferências para humano Onde o agente ainda não dá conta Caindo — e pelos motivos certos

Quando essas três estiverem estáveis, aí sim expanda o escopo: qualificação de leads, recuperação de conversas paradas, integrações mais profundas com o CRM.

Os 3 erros que mais derrubam projetos

  • Base de conhecimento rasa. Dez linhas genéricas não sustentam conversa real. As 20 perguntas do passo 2 são o mínimo, não o ideal.
  • Sem saída para humano. Cliente preso num robô que não resolve é cliente perdido — e reclamação pública.
  • Ligar e esquecer. Agente é planta: precisa de rega semanal (revisar conversas, corrigir base). Quem abandona, colhe respostas erradas.

Perguntas frequentes

Quanto tempo leva do zero ao agente funcionando?

Com o checklist pronto, um agente de FAQ + agendamento costuma sair em poucos dias. As duas semanas de rodagem em paralelo é que transformam ele em um bom agente.

Preciso saber programar?

Não para o escopo deste guia. Plataformas modernas resolvem tudo por interface. Programação só entra em integrações fora do padrão.

Posso usar meu número atual?

Pode, mas ele deixa de funcionar no app do celular ao migrar para a API. Na prática, a maioria começa com um número novo e faz a transição aos poucos.

O agente funciona fora do horário comercial?

Sim — e é justamente onde ele mais se paga. Boa parte das mensagens de clientes chega à noite e no fim de semana, quando ninguém responderia.

E se o agente responder errado?

Com a instrução de “não inventar” e o escalonamento configurado, o erro vira transferência para humano, não informação falsa. E cada erro anotado na rodagem em paralelo é uma correção na base de conhecimento.