Você quer que sua empresa seja encontrada no Google?

Vamos conversar

Como criar um agente de IA para WhatsApp: passo a passo com a API oficial

Para criar um agente de IA para WhatsApp, você precisa de um número na Plataforma do WhatsApp Business (a API oficial da Meta), de uma base de conhecimento com produtos, preços e regras, e de uma ferramenta que ligue as mensagens a um modelo de IA, ao CRM e à agenda. Depois disso, o trabalho é desenhar o fluxo, definir quando a conversa passa para um humano e testar com conversas reais antes de abrir para os clientes.

Neste tutorial: o que a Meta exige antes, as seis etapas de montagem, as ferramentas, as regras da Meta para IA em 2026, a LGPD, os erros comuns e as métricas para saber se o assistente de IA no WhatsApp vende e atende bem.

Se ainda está decidindo se precisa de um agente, comece pelo guia de agentes de IA para negócios ou pelo guia de atendimento 24h com agente de IA no WhatsApp. Aqui o foco é a montagem.

O que você precisa antes de criar o agente?

Três frentes precisam estar resolvidas antes da primeira instrução para a IA: o produto certo da Meta, o número com a conta configurada e as regras de contato. Sem elas, o agente funciona no teste e trava em produção.

WhatsApp Business app ou Plataforma (API oficial)?

A Meta tem dois produtos para empresas. O app WhatsApp Business é o aplicativo gratuito do celular. A Plataforma do WhatsApp Business é a API, hoje oferecida principalmente como Cloud API, hospedada pela própria Meta. Um agente de IA de verdade precisa da Plataforma, que entrega cada mensagem ao seu sistema por webhook e aceita respostas enviadas por código.

Comparação entre o app WhatsApp Business e a Plataforma do WhatsApp Business
CritérioApp WhatsApp BusinessPlataforma (Cloud API)
Para quemPequeno negócio que atende pelo celularEmpresa que quer automação, IA e vários atendentes
IA própria ou de terceirosNão conecta por APISim, via webhook e chamadas de API
Integração com CRM e agendaManualAutomática
Custo de mensagensSem cobrança por mensagemCobrança por mensagem entregue, conforme a tabela da Meta
Iniciar conversaLivre, dentro das regras do appSó com modelo de mensagem aprovado

Quem já atende pelo app não precisa abandonar o número. A Meta oferece a coexistência: o mesmo número passa a funcionar no app e na Cloud API, com histórico sincronizado. Segundo a documentação da Meta sobre coexistência (abre em nova aba), as conversas individuais dos últimos seis meses podem ser importadas, grupos não sincronizam, listas de transmissão ficam só para leitura e as mensagens enviadas pelo app continuam sem cobrança. A ativação é feita por um parceiro da Meta.

Número, conta e verificação

  • Portfólio empresarial na Meta (o antigo Gerenciador de Negócios), com uma conta do WhatsApp Business ligada a ele.
  • Número de telefone que receba SMS ou ligação para o código de registro. Pode ser um número novo ou o atual, via coexistência.
  • App na Meta for Developers com o caso de uso de WhatsApp e um token permanente de usuário do sistema, quando a integração é própria. O guia de primeiros passos da Cloud API (abre em nova aba) lista essas etapas.
  • Verificação da empresa: não é obrigatória para começar, mas pesa no volume. Pela página de limites de mensagens da Meta (abre em nova aba), um portfólio novo pode iniciar conversas com 250 números únicos a cada 24 horas fora da janela de atendimento. Verificar a empresa é um dos caminhos para subir para 2.000. Esse limite não restringe respostas a quem escreveu primeiro.
  • Nome de exibição coerente com a marca.

Opt-in, modelos aprovados e janela de 24 horas

Três regras da Política de Mensagens do WhatsApp Business (abre em nova aba) (versão atualizada em 23 de setembro de 2026) moldam o desenho de qualquer agente:

  1. Opt-in: a empresa só pode contatar quem forneceu o número e aceitou receber mensagens dela. A forma de coletar esse aceite é responsabilidade da empresa.
  2. Janela de 24 horas: quando o cliente escreve, abre-se uma janela de atendimento de 24 horas, renovada a cada nova mensagem dele. Dentro dela o agente responde com texto livre.
  3. Modelos de mensagem: para iniciar conversa ou falar com o cliente fora da janela, só com modelo (template) aprovado pela Meta e usado para a finalidade declarada: marketing, utilidade ou autenticação.

Na prática, o agente responde livremente a quem chega, mas o follow-up do dia seguinte precisa de modelo aprovado. Planeje os modelos junto com o fluxo.

Passo a passo: como criar um agente de IA para WhatsApp

O roteiro abaixo vale para qualquer ferramenta. Ele segue a mesma lógica do tutorial como criar um agente de IA, aplicada às particularidades do WhatsApp.

1. Defina um objetivo e um limite

Escolha uma missão para a primeira versão e escreva o que o agente não faz. Exemplos de missões bem recortadas:

  • IA para vendas no WhatsApp: qualificar o lead que chega pelo anúncio (o que procura, prazo, orçamento, cidade), responder dúvidas de produto e entregar ao vendedor só quem está pronto, com o resumo da conversa.
  • IA para atendimento no WhatsApp: responder status de pedido, segunda via, horário e política de troca, e abrir chamado quando não resolver.
  • Agendamento: oferecer horários livres, marcar, confirmar na véspera e remarcar.

Para cada missão, defina a meta de negócio e o que conta como conversa resolvida.

2. Monte a base de conhecimento

O agente só é tão bom quanto o material que consulta. Reúna, em documentos curtos:

  • catálogo com descrição, preço e variações;
  • as perguntas que a equipe mais responde, com a resposta escrita por quem atende hoje;
  • políticas de frete, prazo, troca, garantia e pagamento;
  • regras comerciais: até onde negociar e o que nunca prometer.

Escreva também as instruções do agente: tom de voz, tamanho das respostas, o que fazer quando não souber (chamar a equipe, nunca inventar) e quais dados pode pedir. Estoque e agenda devem vir de consulta em tempo real, não do texto da base.

3. Desenhe o fluxo da conversa

Mesmo com IA generativa, existe um fluxo. Desenhe em papel ou num quadro:

  1. saudação e identificação da intenção (comprar, tirar dúvida, pós-venda, falar com alguém);
  2. perguntas de qualificação, uma por vez;
  3. ações possíveis (consultar pedido, mostrar horários, gerar link de pagamento);
  4. encerramento, com resumo do que foi combinado;
  5. o que fazer se o cliente sumir: lembrete com modelo aprovado ou registro no CRM.

Use botões de resposta e listas: reduzem erro de digitação e encurtam a conversa. Desde outubro de 2026 isso também pesa no custo, porque as respostas enviadas pela API passaram a ser cobradas acima de uma franquia mensal. A matéria sobre a nova cobrança do WhatsApp Business e da IA da Meta explica o que mudou, e os valores atualizados ficam na página oficial de preços da Plataforma (abre em nova aba).

4. Integre com CRM e agenda

É a integração que transforma um chatbot em agente. As ligações mais comuns são:

  • CRM: criar o contato, registrar origem, etapa do funil e resumo, e ler o histórico para não repetir perguntas.
  • Agenda: consultar horários livres e gravar o compromisso, com confirmação automática.
  • Loja, ERP ou sistema de pedidos: status de entrega, segunda via, estoque.
  • Pagamento: gerar link ou Pix e confirmar o recebimento por webhook.

Cada integração vira uma “ferramenta” que a IA pode chamar, com permissão limitada: consultar é diferente de alterar ou cancelar. É o tipo de trabalho que a Atom faz em automação com IA, ligando WhatsApp, CRM e sistemas internos.

5. Configure o transbordo para humano

Não é só boa prática: a política da Meta exige que experiências automatizadas ofereçam caminhos de escalonamento “rápidos, claros e diretos”, como transferir para um atendente no próprio chat, telefone, e-mail ou formulário. Defina os gatilhos:

  • o cliente pede uma pessoa (“quero falar com atendente”);
  • reclamação, cancelamento, cobrança contestada ou tom de irritação;
  • negociação fora da regra ou pedido de alto valor;
  • o agente não encontrou a resposta duas vezes seguidas.

Na passagem, o atendente recebe o resumo e o histórico, e o agente para de responder naquela conversa. Fora do horário, informe quando alguém vai retomar.

6. Teste antes de abrir para o público

  1. Roteiro de testes: 50 a 100 mensagens reais tiradas do histórico, incluindo as difíceis (áudio, foto, erro de digitação, cliente irritado, pergunta fora do assunto).
  2. Testes de segurança: tente fazer o agente dar desconto não autorizado ou revelar dados de outro cliente.
  3. Piloto controlado: ligue o agente para uma fatia do tráfego (um anúncio, um horário) com a equipe revisando as conversas todo dia.
  4. Ajuste semanal: leia as conversas, corrija a base e só então amplie.

Quais ferramentas usar para criar o agente?

Há três caminhos principais. Os recursos abaixo foram descritos pelo que as páginas oficiais dizem em outubro de 2026.

Meta Business Agent

É o agente de IA da própria Meta, anunciado para todas as empresas em 3 de junho de 2026 (abre em nova aba). Segundo a Meta, ele responde dúvidas, recomenda produtos do catálogo, agenda horários, qualifica leads e fecha vendas, e a empresa decide quando um humano assume. A documentação para desenvolvedores (abre em nova aba) descreve a configuração em quatro partes: conhecimento (informações da empresa, perguntas frequentes, sites e arquivos), instruções de tom e prioridade, ações ligadas às suas APIs e transbordo para o seu sistema.

Pela mesma documentação, o número precisa estar na Plataforma, em boa situação, num país autorizado e sem outro agente de IA rodando. Finanças, governo, saúde, bebidas alcoólicas, apostas e medicamentos sem receita ficam de fora. A cobrança é diferente da do agente próprio (veja a matéria sobre a nova cobrança).

Plataformas de parceiros (BSP)

Os provedores de soluções de negócios (BSP) são parceiros da Meta que cadastram o número e entregam um painel pronto, em geral com caixa de entrada compartilhada, construtor de fluxos, módulo de IA e disparo de modelos. É o caminho mais rápido para quem não tem equipe técnica. Antes de escolher, confira se a empresa é parceira oficial da Meta, se cobra taxa além das mensagens, se suporta coexistência, se integra com o seu CRM e se permite exportar os dados caso você troque de fornecedor.

n8n (ou código próprio) com a API

Para quem quer controle total, o caminho é ligar a Cloud API direto a um orquestrador. O n8n tem um gatilho de WhatsApp (abre em nova aba) que recebe eventos como mensagens e mudanças de status de modelos, e um nó de WhatsApp Business Cloud (abre em nova aba) que envia mensagens, modelos e mídias, segundo a documentação do n8n. O fluxo típico fica assim: gatilho recebe a mensagem, um nó de agente de IA consulta o modelo (OpenAI, Claude, Gemini ou outro) com memória da conversa e ferramentas para CRM e agenda, e o nó de WhatsApp devolve a resposta.

Comparação entre Meta Business Agent, plataformas BSP e n8n com API
CritérioMeta Business AgentPlataforma BSPn8n com API
Tempo para começarCurtoCurto a médioMédio
Escolha do modelo de IAIA da MetaDepende da plataformaLivre
Integração com sistemasPor ações e APIsConectores prontosQualquer sistema com API
Equipe técnicaPoucaPoucaNecessária
RestriçõesSetores e países elegíveisRegras e taxas do fornecedorHospedagem, segurança e manutenção por sua conta

Regra prática: operação simples combina com o agente da Meta ou com uma BSP; vendas consultivas e vários sistemas pedem um agente sob medida.

O que a Meta permite fazer com IA no WhatsApp?

Os Termos da Meta para a Plataforma do WhatsApp Business (abre em nova aba), na versão atualizada em 23 de setembro de 2026, têm uma seção específica para provedores de IA (item 4.7). Ela proíbe que fornecedores de modelos de linguagem e de plataformas de IA generativa usem a Plataforma para distribuir essas tecnologias quando a IA é a funcionalidade principal oferecida, como um assistente de uso geral no estilo ChatGPT dentro do WhatsApp. Essa regra passou a valer em 15 de janeiro de 2026, como registrou o TechCrunch (abre em nova aba).

Para a empresa que usa IA para atender e vender aos próprios clientes, o texto é claro: a proibição não se aplica quando a IA é “incidental ou auxiliar” ao negócio. Uma loja, clínica ou indústria que responde dúvidas, agenda e qualifica leads com IA está dentro da regra. Também é permitido contratar um provedor de IA como seu fornecedor de solução.

Dois pontos dos termos pesam na hora de contratar:

  • Treinamento de modelos: os dados da Plataforma, mesmo anonimizados ou agregados, não podem ser usados para criar, treinar ou melhorar modelos de IA. A exceção é o ajuste fino de um modelo para uso exclusivo da sua empresa. Pergunte ao fornecedor o que ele faz com as conversas.
  • Compartilhamento: os dados não podem ser repassados a terceiros, salvo ao seu provedor de solução, nem usados para traçar perfil de usuários do WhatsApp.

Como ficar em dia com a LGPD?

Conversas de WhatsApp têm nome, telefone e, muitas vezes, CPF e endereço. A Lei Geral de Proteção de Dados (Lei 13.709/2018) (abre em nova aba) se aplica integralmente. O checklist mínimo:

  • Transparência: avise que o atendimento é feito por um assistente virtual e aponte a política de privacidade.
  • Mínimo necessário: o agente pede só os dados que a tarefa exige.
  • Dados sensíveis: em saúde, por exemplo, limite o que a IA coleta (art. 11).
  • Decisões automatizadas: o titular pode pedir revisão de decisões tomadas só por tratamento automatizado (art. 20).
  • Direitos do titular: tenha um caminho para acesso, correção e exclusão (art. 18) e respeite quem pede para parar de receber mensagens.
  • Fornecedores e segurança: contrato com os fornecedores definindo papel de operador, retenção e medidas de segurança (art. 46).

Erros comuns ao criar um agente de IA no WhatsApp

  1. Usar soluções não oficiais. Ferramentas que “espelham” o WhatsApp Web sem a API não são autorizadas pela Meta e põem o número em risco de bloqueio.
  2. Base de conhecimento desatualizada. Preço velho na base vira promessa errada para o cliente.
  3. Esconder o humano. Agente que não deixa falar com uma pessoa irrita o cliente e descumpre a política da Meta.
  4. Mensagens picadas. Vários balões curtos confundem e, desde outubro de 2026, custam mais.
  5. Disparar sem opt-in. Lista comprada ou contatos que nunca autorizaram derrubam a qualidade do número e o limite de envio.
  6. Não ler as conversas. O ajuste das primeiras semanas separa um agente útil de uma fonte de reclamação.

Quais métricas acompanhar?

Métricas para acompanhar um agente de IA no WhatsApp
MétricaO que mostraOnde medir
Tempo da primeira respostaSe o cliente é atendido na hora, inclusive à noitePlataforma ou logs
Taxa de resolução sem humanoQuanto o agente resolve sozinhoMarcação de conversa resolvida
Taxa de transbordoQuando e por que a IA chama a equipeMotivo registrado na passagem
Leads qualificados e agendamentosResultado comercial do agenteCRM e agenda
Conversão e receita por conversaSe o agente vendeCRM cruzado com pedidos
Mensagens por conversa e custo por vendaEficiência e custo na Meta e no modelo de IAWebhooks de status e fatura
Respostas erradasRisco para a marcaAmostra semanal revisada por pessoa

Revise semanalmente no primeiro mês. O indicador que decide o projeto é custo por venda ou por atendimento resolvido, não volume de mensagens.

Quanto tempo leva e quando contratar?

O cadastro do número e uma ferramenta pronta saem em poucos dias. O que toma tempo é a base de conhecimento, os modelos, as integrações e o piloto. Montar sozinho faz sentido quando a operação é simples e alguém da equipe cuida do agente toda semana.

Vale contratar quando o agente precisa conversar com vários sistemas, quando vender pelo WhatsApp é parte central da receita ou quando ninguém da equipe tem tempo para ajustar o assistente. É o que a Atom entrega no serviço de agente de IA para WhatsApp, que inclui API oficial, integração com CRM, transbordo e acompanhamento. Para qualificação de leads com repasse ao comercial, há também o SDR com IA, e para agentes fora do WhatsApp, os agentes de IA sob medida.

Perguntas frequentes

Dá para colocar IA no app WhatsApp Business comum?

Uma IA própria ou de terceiros, não: ela precisa da Plataforma do WhatsApp Business (API). O que dá para fazer é manter o número no app e ligá-lo também à Cloud API pela coexistência, recurso da Meta ativado por um parceiro. A Meta também vem liberando o próprio agente de IA, o Meta Business Agent, de forma gradual.

Preciso de um número novo para criar o agente?

Não necessariamente. Um número que já está no app WhatsApp Business pode ser conectado à Cloud API por coexistência, mantendo o histórico. Números do WhatsApp pessoal não entram nesse caminho e exigem migração ou um número novo.

A Meta proibiu chatbots de IA no WhatsApp?

Proibiu que fornecedores de IA usem a Plataforma para distribuir assistentes de uso geral, quando a IA é o produto principal. Empresas que usam IA de forma auxiliar para atender e vender aos próprios clientes continuam permitidas, segundo os termos da Plataforma atualizados em 23 de setembro de 2026.

Quanto custa manter um agente de IA no WhatsApp?

O custo tem três partes: as mensagens cobradas pela Meta, o uso do modelo de IA e a ferramenta ou a equipe que mantém o agente. Os valores das mensagens estão na página oficial de preços da Plataforma, e a matéria da Atom sobre a nova cobrança de outubro de 2026 explica as mudanças.

O agente pode mandar mensagem para quem não falou comigo?

Só se a pessoa tiver dado opt-in para receber mensagens da sua empresa, e sempre com um modelo de mensagem aprovado pela Meta. Texto livre só é permitido dentro da janela de 24 horas aberta pela mensagem do cliente.

Preciso avisar que o cliente está falando com uma IA?

É a prática recomendada pela transparência que a LGPD exige no tratamento de dados, e evita frustração. A política do WhatsApp exige, além disso, que a automação ofereça um caminho rápido e claro para falar com uma pessoa.

Dá para criar o agente sem programar?

Sim. O Meta Business Agent e as plataformas de parceiros (BSP) oferecem configuração por painel. O limite aparece nas integrações: quando o agente precisa consultar e gravar em vários sistemas, entra o n8n ou código próprio.

Como evitar que o agente invente respostas?

Restrinja as respostas à base de conhecimento, puxe preço, estoque e agenda direto dos sistemas, instrua o agente a dizer que não sabe e chamar a equipe, e revise uma amostra de conversas toda semana.

Tags

  • Agentes de ia
  • Inteligencia artificial marketing
  • Ia generativa
  • Pme
  • Marketing digital

Sobre Thiago Q. Mota:

Thiago Q. MotaFundador e CEO da Atom Digital

Lidera a Atom Digital, agência de marketing digital e IA fundada em 2011 em Goiânia. Escreve sobre SEO, GEO, inteligência artificial aplicada a vendas e crescimento digital para empresas.

Newsletter

Fique à frente das tendências de marketing

Receba os artigos mais recentes da Atom sobre SEO, GEO, mídia e IA direto no seu e-mail.

Diagnóstico gratuito

Peça seu diagnóstico.

Analisamos seu site e sua presença no Google e nas IAs, e mostramos por onde começar.

Ao enviar, abrimos uma conversa no WhatsApp com estes dados. Eles são usados apenas para este contato, de acordo com a LGPD e a Política de Privacidade.