Como criar um agente de IA para WhatsApp passo a passo
Aprenda a desenhar e testar um agente conectado ao WhatsApp Business com contexto, limites, histórico e encaminhamento humano.
Um fluxo de teste que recebe uma mensagem autorizada, classifica a intenção, consulta uma base curta e encaminha o caso quando não pode responder.
Passo a passo aplicado
- 01
Defina uma única função
Escolha uma tarefa estreita, como identificar o assunto e preparar uma resposta para revisão. Escreva o que o agente pode fazer, o que deve recusar e quando uma pessoa assume.
- 02
Prepare um ambiente de teste
Use um número separado da operação principal e usuários autorizados. Configure o aplicativo e o número de teste seguindo a documentação oficial da WhatsApp Business Platform.
- 03
Receba o evento por webhook
Crie um webhook no orquestrador, registre a URL no aplicativo e valide o token. Armazene somente os campos necessários: identificador, texto, horário e status.
- 04
Normalize a mensagem
Remova espaços desnecessários, detecte mensagens vazias e separe texto de anexos. Não envie arquivos ou dados sensíveis ao modelo sem uma regra explícita.
- 05
Classifique antes de responder
Peça ao modelo uma saída estruturada com intenção, confiança e ação permitida. Valide o formato; se a confiança estiver abaixo do limite, encaminhe para revisão.
- 06
Consulte uma fonte aprovada
Busque a informação em uma base curta e versionada. Instrua o agente a usar apenas esse contexto e a declarar quando não encontrou a resposta.
- 07
Envie ou encaminhe
No piloto, envie a sugestão para uma fila interna. Só libere resposta automática para cenários repetíveis, depois de revisar amostras e criar um caminho humano.
- 08
Registre e monitore
Salve intenção, ação, tempo, erro e decisão humana. Use esses registros para corrigir regras; não use conversas reais como treinamento sem base legal e governança.
Erros comuns e correções
Webhook não valida
Confira URL pública HTTPS, token de verificação e método esperado pela plataforma.
Mensagem duplica
Use o identificador do evento como chave idempotente antes de executar o fluxo.
Agente inventa informação
Restrinja a fonte, exija citação interna e encaminhe quando o contexto não contiver a resposta.
Valide antes de colocar em produção.
Envie cinco mensagens de teste: uma conhecida, uma ambígua, uma fora do escopo, uma duplicada e uma com dado sensível. O fluxo deve registrar todas, não executar a duplicada e encaminhar as três situações de risco.
Perguntas frequentes
Preciso usar a API oficial?
Para uma operação empresarial estável e conforme as regras da plataforma, use a WhatsApp Business Platform ou um provedor autorizado.
Posso conectar meu número pessoal?
Não é recomendado. Separe desenvolvimento, homologação e produção.
O agente pode responder tudo sozinho?
Não. Defina limites e transferência humana para baixa confiança, temas sensíveis e exceções.
Documentação e fontes
Quer isso implementado
na sua empresa?
Veja como a IAX conecta essa tarefa ao restante da operação.