Como configurar o Meta Business Agent: passo a passo

Introdução

Este é o passo a passo para configurar o Meta Business Agent na API oficial do WhatsApp, a Meta Business Agent Platform. Se você procura o agente do app WhatsApp Business, o caminho é outro: menu Ferramentas, "IA para empresas", sem código.

Aqui o público é quem já tem número na API oficial e alguém técnico do lado. Montei a ordem seguindo o guia oficial da Meta, consultado em 29 de outubro de 2026, e marquei os erros que mais travam quem está começando.

Antes de configurar o Meta Business Agent

Para configurar o Meta Business Agent, separe quatro coisas: o ID da conta do WhatsApp Business (WABA), o ID do portfólio da empresa, o ID do app na Meta e um número elegível.

O app precisa das permissões whatsapp_business_messaging e whatsapp_business_management. A segunda é a que deixa você ler os dados do agente depois.

E confira o setor. A Meta não libera o agente para finanças, governo, saúde, álcool, jogos de azar, medicamentos sem receita e serviços matrimoniais. Quem decide é a categoria da conta no WhatsApp Manager. Para saber se um número específico está liberado, existe um endpoint de elegibilidade. Ele responde só sim ou não. Um erro 401, 404 ou 429 nessa chamada não quer dizer que o número é inelegível; é erro de acesso ou de limite.

Passo 1: termos, pagamento e acesso

Aceite os termos. No WhatsApp Manager, na aba Meta Business Agent, configure o agente no número e aceite os termos de serviço. Se você usa um parceiro (Tech Provider), ele também precisa aceitar os termos de Tech Provider. Sem os dois, as chamadas de API não funcionam.
Cadastre o pagamento. No Billing Hub, coloque uma forma de pagamento. Dá para testar sem ela, mas abrir o agente para todos os clientes falha com erro 400. Cartão Visa e Mastercard é aceito desde 8 de setembro de 2026; empresas elegíveis também podem ter linha de crédito.
Crie um usuário de sistema. No Meta Business Suite, com papel Admin. É ele que autentica as chamadas.
Atribua os ativos. Dê ao usuário de sistema o app e a WABA, com permissão de gerenciar números.
Gere o token. Token de usuário de sistema, ou token BISU se a configuração for por um parceiro, com as duas permissões.

Passo 2: webhooks

Inscreva o app na WABA com um POST em /WABA_ID/subscribed_apps e confirme com um GET.
Assine três campos de webhook: messages, standby e messaging_handovers.

Esse passo é o que mais gente pula. Enquanto o agente está respondendo, as mensagens do cliente chegam ao seu sistema pelo standby, não pelo messages. Se você não assinar o standby, o seu sistema fica cego enquanto a IA conversa. E o messaging_handovers avisa quando a conversa troca de mãos entre o agente e o seu app.

Passo 3: montar o agente

Onboarding. Chame o endpoint de onboarding. Ele cria a configuração e o conhecimento do agente no número. Sem isso, nada liga.
Instruções. Defina como o agente responde: tom, prioridades, o que ele pode e não pode dizer.
Conhecimento. Cadastre dados do negócio, perguntas frequentes, sites e arquivos. Documento enviado pelo cliente na conversa não entra no conhecimento; para usar um PDF como base, ele tem que ser cadastrado como arquivo.
Conectores. Se o agente vai consultar estoque, status de pedido ou agenda, cadastre a API externa (endereço e autenticação) e as operações que ele pode chamar.

Passo 4: testar o Meta Business Agent antes de abrir

Teste e avalie. A Platform tem endpoints para mandar mensagens de teste e medir o desempenho do agente.
Allowlist. Cadastre os números que podem falar com o agente, no formato internacional (+55…), e mude o público do agente (ai_audience) para ALLOWLISTED_ONLY. Confirme com um GET.

Atenção à ordem: a allowlist vem antes de ativar. Se o público continuar em EVERYONE, o agente responde todo mundo, com ou sem lista. E é com ALLOWLISTED_ONLY que dá para testar sem forma de pagamento.

Aproveite o teste para criar um limite de gasto. Dá para limitar por tokens ou por turnos de IA, em janelas de 1, 7, 14 ou 30 dias. Quando o limite estoura, o agente termina a resposta em andamento e passa a conversa para uma pessoa. Sem limite nenhum, o uso é ilimitado, e a cobrança é de US$ 2,00 por 1 milhão de tokens (cerca de US$ 0,04 a US$ 0,05 por mensagem, pela estimativa da Meta).

Passo 5: ativar para todos

Abra o público. Nas configurações do agente, mude ai_audience para EVERYONE.
Ligue o agente. Ative o rollout. A partir daí ele responde as novas conversas.

Erros comuns na configuração

Erro 400 ao abrir para todos: falta forma de pagamento no Billing Hub.
Agente respondendo quem não está na lista: o público ficou em EVERYONE.
Sistema da empresa sem receber mensagens: faltou assinar o webhook standby.
Chamadas de API negadas usando parceiro: um dos dois termos (o da empresa ou o de Tech Provider) não foi aceito.

Quando não vale montar tudo isso

São 15 passos, token, webhook e conector. Para uma empresa grande com time técnico, é trabalho normal. Para uma PME, costuma ser demais só para ter IA respondendo no WhatsApp.

Nesse caso, um agente de IA dentro de uma plataforma de WhatsApp resolve com menos trabalho: você conecta o número oficial, cria o agente a partir de um modelo e a equipe atende no mesmo lugar. Comparei os dois caminhos, com preços e fontes, aqui: Meta Business Agent: o que é e quanto custa.