Guia técnico
Meta Business Agent (MBA): guia técnico completo para builders
Senha incorreta.
Tem a senha deste guia ou da comunidade? A da comunidade vale para todos os materiais.
Quero fazer parte e receber esse tipo de conteúdoMeta Business Agent (MBA): guia técnico completo para builders
A Meta lançou uma IA nativa, hospedada por ela, que responde direto no número e se anuncia como IA na conversa. Este guia cobre a arquitetura completa: os 3 produtos, o Handover Protocol com Thread Control e standby, a disclosure de IA, o pricing real e o que isso muda para quem constrói CRM, BSP ou plataforma de atendimento.
Última atualização: 18 de julho de 2026
TL;DR para quem tem pouco tempo
- O Meta Business Agent (MBA) é uma IA hospedada pela Meta que responde direto no número do WhatsApp. Lançamento global em 3 de junho de 2026, após quase dois anos de teste em Índia e México.
- São 3 produtos, não um: dois Self-Serve (WhatsApp app e Messenger, no celular, sem API) e a MBA Platform, enterprise sobre a WhatsApp Business Platform API, liberada a parceiros em 1 de julho de 2026.
- Toda conversa carrega uma disclosure de IA que a Meta estampa na thread. Não é opcional: é política de plataforma desde 15 de janeiro de 2026.
- O handoff para humano usa o Handover Protocol (Thread Control + canal standby). Quem ignora o standby fica cego enquanto a IA conversa.
- Grátis hoje. A Meta migra para tiers pagos (WhatsApp Business Premium) e cobra por token no enterprise. A "cobrança por token em agosto" é boato: não bate com a política oficial.
- Para CRM/BSP: "robô no WhatsApp" virou commodity. Sobrevive quem vira o painel de controle em volta do agente.
Mapa mental do Meta Business Agent
Antes do detalhe, a visão de cima: os cinco eixos que você precisa dominar para conversar de igual com a plataforma.
Produtos
Capacidades
Conhecimento
Handover
Governança
Os 3 produtos (e por que a distinção importa)
Quase todo mundo chama tudo de "Meta Business Agent". São três coisas com capacidades bem diferentes: a que te ameaça não é a que você integra.
Agente no WhatsApp Business app
- Grátis, configurado 100% no celular
- Aprende de chats, perfil e catálogo
- Responde inbound 24/7
- Sem API, inbox de time ou atribuição
- Sem broadcast, CRM ou automação custom
Mesmo agente no Messenger
- Configurado no Meta Business Suite
- Mesma lógica do Self-Serve do WhatsApp
- Também disponível no Instagram Pro
- Sem API nem inbox de time
Enterprise sobre a Cloud API
- Roda na WhatsApp Business Platform API
- Workflows custom e system prompt próprio
- Conectores para centenas de sistemas (Shopify, Zendesk, Shopee)
- Renderiza WhatsApp Flows JSON nativo
- Handover programável (Thread Control)
- Cobrança por token no enterprise
| Capacidade técnica | Self-Serve | MBA Platform |
|---|---|---|
| Acesso via API / webhook | Não | Sim |
| Inbox de time / atribuição de agente | Não | Depende da sua stack |
| Broadcast / campanha (outbound) | Não (só inbound) | Via templates |
| Conectores para sistemas externos | Limitado | Centenas |
| Automação / workflow custom | Não | Sim |
| Handover programável (Thread Control) | Automático, opaco | Programável |
| Onde vive a configuração | Celular / Business Suite | Meta Business Agent Platform |
Leitura para builder: o Self-Serve é o que rouba o pitch "coloco IA no seu WhatsApp" do pequeno negócio (grátis, sem você). A MBA Platform é a que você integra: ela expõe as peças (Thread Control, standby, Flows) para o seu produto orquestrar em cima. Ameaça e oportunidade moram em camadas diferentes.
Diagrama de uso: como uma mensagem flui
O ciclo de vida de uma conversa com o agente da Meta, do "oi" do cliente até o humano assumir. Repare em dois pontos: a disclosure de IA logo no início e o ponto de escalonamento por predicado.
pass_thread_control com o histórico completo; seu app recebe messaging_handovers e o humano assume no inbox.A IA que a Meta estampa na mensagem
Este é o ponto que muda a UX e a estratégia: quando o Meta Business Agent responde, o usuário sabe que está falando com uma IA. A Meta trata isso como obrigação de plataforma, não como escolha do negócio.
Duas camadas se somam:
- Disclosure do próprio MBA (feita pela Meta). Como o agente é hospedado pela Meta, é ela quem sinaliza ao usuário, na conversa, que ele fala com uma IA da Meta. Referência: a central de ajuda "Sobre conversar com empresas que usam IA da Meta".
- Regras de disclosure para qualquer IA (AI-Assisted Business Messaging Guidelines). Em vigor desde 15 de janeiro de 2026, valem para todo chatbot no WhatsApp, inclusive o seu.
Como o usuário vê em uma conversa 1:1: o selo IA da Meta fica sempre no topo e cada balão da IA, do primeiro ao último, traz o selo IA ao lado do horário. Texto ilustrativo da disclosure exigida na 1ª mensagem.
O que a política exige de qualquer bot (inclusive o seu):
- Declarar que é IA na primeira mensagem ("Oi! Sou o assistente de IA da [Empresa]...").
- Nome do perfil do bot deve conter rótulo como "IA", "Bot" ou "Assistente". Não existe selo automático que a Meta aplique no seu bot: a responsabilidade é sua.
- Caminho claro para humano em toda conversa. O bot deve reconhecer "humano", "atendente", "pessoa" e escalar de fato.
- Opt-out visível. "STOP" precisa encerrar mensagens proativas imediatamente.
Por que comemorar: a disclosure derruba o medo de "vão achar que é robô e fugir" e reforça que o humano com contexto é o diferencial premium. Sua UX de "assumir conversa" fica mais valiosa, não menos.
Handover Protocol: Thread Control e standby (o coração técnico)
O handoff entre a IA da Meta e o humano não é mágica: é o Handover Protocol da Meta, o mesmo do Messenger. Dois papéis, três chamadas e um canal de observação.
- Primary Receiver: controla a thread por padrão (aqui, o agente da Meta).
- Secondary Receiver: observa e pode assumir (aqui, o seu app / inbox humano).
pass_thread_control: entrega o controle a outro app.take_thread_control: o primário retoma o controle.request_thread_control: o secundário pede o controle.
Quando o agente da Meta controla a thread, o seu app não é o dono ativo, mas continua enxergando tudo pelo canal standby. O gatilho de handoff é uma escalation predicate (ex.: "menciona cancelamento OU sentimento negativo por dois turnos OU pedido acima de X"). Ao disparar, a conversa vai para a fila humana com o histórico completo anexado, sem fricção para o usuário: o agente para e a pessoa assume.
// Enquanto o agente da Meta controla a thread, o seu app (Secondary
// Receiver) recebe as mensagens no ramo "standby", nao no ramo ativo.
function routeWebhook(entry) {
if (entry.messaging) {
// Voce tem o controle: trate normalmente (responder, atribuir, etc.)
return handleActiveMessage(entry.messaging);
}
if (entry.standby) {
// Agente da Meta no controle: NAO responda. Apenas espelhe.
// Isto mantem o inbox como sistema de registro, mesmo sem responder.
return mirrorToInbox(entry.standby);
}
}
// Handoff: o app perde/ganha controle e recebe messaging_handovers
function handleHandover(event) {
// event.pass_thread_control -> alguem passou o controle (metadata incluso)
// event.take_thread_control -> o primario retomou
// event.request_thread_control-> o secundario pediu o controle
const meta = event.pass_thread_control?.metadata; // string opaca de contexto
updateThreadOwner(event);
}
pass_thread_controlcontrole passa para o seu app, com o histórico completoNota de precisão (leia antes de codar): os nomes pass_thread_control, take_thread_control, request_thread_control, o par Primary/Secondary Receiver e o canal standby vêm do Handover Protocol da Meta (documentado no Messenger). A implementação da MBA Platform sobre a WhatsApp Business Platform API pode diferir em nome de campo e payload: valide contra a doc vigente antes de produção. O conceito (dono ativo + observador em standby + handoff explícito) é estável; a assinatura pode mudar.
Coexistência com o seu produto: a arquitetura
A pergunta de todo builder: "se o cliente ligar o agente da Meta, meu CRM morre?". Não, se você desenhar a coexistência certa. O número é um só; quem responde por ele é orquestrável.
este turno?"} Q --> MBA["Meta Business Agent
IA nativa"] Q --> BOT["Seu bot / automação
sua IA e regras"] Q --> HUM["Inbox do time
humano"] MBA -->|"standby + handover
espelham tudo"| CRM["Seu CRM
sistema de registro e orquestração"] BOT --> CRM HUM --> CRM CRM --> FUN["Funil, tags, SLA"] CRM --> ANA["Analytics e auditoria"] CRM --> INT["Integrações do vertical"]
O CRM deixa de ser "quem responde" e passa a ser onde tudo é registrado e orquestrado. O agente da Meta responde? Ótimo. Sua função é espelhar, dar o botão de assumir e manter funil, time, histórico e integrações que a Meta nunca fará para o seu nicho.
Prós e contras do Meta Business Agent
Sem torcida: o que o MBA entrega de verdade e onde ele te deixa na mão.
A metáfora do builder A resposta honesta pra pergunta do cartoon é: os dois. O Meta Business Agent comoditiza seu robô e, no mesmo golpe, tira de você o custo e a manutenção de rodar IA própria. Negar isso é perder. O jogo certo é embrace and extend: hospedar o robô da Meta dentro do seu produto e cobrar pela camada humana por cima, como mostram as duas colunas abaixo.
Para o negócio final seu cliente
Prós
- Grátis hoje e ligado em minutos, do celular.
- Responde 24/7 já treinado com catálogo, perfil e chats passados.
- Nativo: nenhuma integração para o pequeno negócio manter.
- Recomenda produto, agenda, qualifica lead e até fecha venda.
- Disclosure e handoff para humano vêm prontos.
Contras
- Self-Serve não tem inbox de time nem atribuição.
- Só responde inbound: nada de campanha ou broadcast.
- Sem CRM, sem funil, sem automação custom.
- Preso ao ecossistema Meta; migrar depois dá trabalho.
- Pricing vira pago (subscription e per-token) e ainda é névoa.
Para você builder de CRM / BSP
A favor
- A MBA Platform expõe peças (Thread Control, standby, Flows) para você orquestrar.
- Terceiriza a camada de IA cara e comoditizada para a Meta.
- Disclosure obrigatória valoriza seu diferencial humano.
- Handoff com full context é um recurso premium que você vende por cima.
Risco
- Comoditiza o pitch "robô no WhatsApp" do plano de entrada.
- Cliente pode ligar o nativo e questionar o seu preço.
- Sem tratar standby, seu time opera cego.
- Dependência de roadmap e pricing que a Meta controla.
Pricing: o que é verdade em julho de 2026
Aqui mora a confusão. Vamos separar o que a Meta comunicou do que virou boato de grupo.
| Camada | Como cobra hoje | Para onde vai |
|---|---|---|
| Self-Serve (WhatsApp / Messenger) | Grátis | Entra em tiers do WhatsApp Business Premium "nos próximos meses" |
| MBA Platform (enterprise) | Grátis para começar | Cobrança por token, valores exatos ainda por anunciar |
| Janela de atendimento (service window) | Grátis | Continua grátis, não é afetada pela cobrança de IA |
Correção importante: circula que "o MBA passa a ser cobrado por token a partir de 1 de agosto de 2026". A comunicação oficial não confirma a data. O que a Meta publicou: começar é grátis, os planos pagos chegam "nos próximos meses" via subscription, e o enterprise é por token com valores ainda não divulgados. Não prometa data fechada ao cliente.
O outro pricing que confunde: a política de "AI Providers"
Separado do MBA, a Meta tem uma política de cobrança para "AI Providers" (IA de propósito geral operando no WhatsApp). É por mensagem não-template entregue, não por token, e teve um rollout próprio:
| Data | O que mudou (política AI Providers) |
|---|---|
| 15/jan/2026 | Termos atualizados definindo "AI Providers" |
| 16/fev/2026 | Cobrança começa (inicialmente só Itália) |
| 11/mar/2026 | Expande para Brasil e países da UE |
| 13/mai/2026 | Cobrança descontinuada nos mercados antes afetados |
| Maio/2026 em diante | Apenas Brasil (+55) segue sujeito à cobrança |
| 01/jul/2026 | Atualizações de tarifa programadas |
Sinais no seu webhook: uso classificado como IA vem com "pricing_category": "AI_BOT" e categoria general_purpose_ai: mapeie esses valores para não contabilizar errado. E lembre: AI Providers é sobre IA de propósito geral, um recorte diferente do MBA. Não conflate as duas ao precificar.
Antes de recomendar IA nativa vs. IA própria a um cliente, rode os números na calculadora de custo da API e compare os cenários lado a lado.
O que a Meta absorve vs. o que sobra pro seu produto
| Meta Business Agent entrega | Seu CRM / plataforma continua dono |
|---|---|
| Robô que responde no número | Funil, etapas, tags, responsáveis |
| IA hospedada e mantida pela Meta | Múltiplos números / WABAs num painel |
| Disclosure de IA nativa | Handoff humano com contexto e SLA |
| Thread Control e canal standby | Histórico unificado, busca, exportação |
| Conectores genéricos (Shopify, Zendesk) | Integrações profundas do seu vertical |
| Flows JSON de checkout e agendamento | Automações além do robô |
| Cobrança por token no enterprise | Analytics, dashboards, auditoria do time |
| Não faz | O lugar onde o time trabalha o dia inteiro |
A Meta não vai manter funil comercial, regras de escritório, múltiplos departamentos ou integrações de nicho. Esse é o seu território, e é onde a retenção mora.
Playbook do builder: embrace and extend
Regra de plataforma: quando a dona da API faz a feature nativa, quem vendia só ela vira commodity. A saída não é brigar com o robô nativo, é hospedar a experiência dele dentro do seu produto e subir uma camada.
- Deixe o cliente ligar o agente da Meta, se quiser. Sem briga, sem bloqueio. Quem prefere IA nativa não precisa sentir que está "traindo" a plataforma.
- Espelhe pelo standby tudo que o agente responde. O CRM vira o sistema de registro mesmo sem ser a sua IA. Nada some do histórico do time.
- Handoff por Thread Control com um clique. O humano assume a conversa da Meta e devolve quando quiser. Pessoa no meio, quando importa.
Reação errada: "nossa IA é melhor que a da Meta", baixar preço até a corrida pro fundo, esconder que dá para ligar o nativo, ou ignorar standby e perder visibilidade. Reação certa: abraçar o agente e vender o painel de controle em volta.
Checklist para builders (esta semana)
- ☐ Mapear quantos clientes têm pitch centrado só em "IA no WhatsApp".
- ☐ Listar o que quebra se o cliente ligar o agente da Meta amanhã (inbox, histórico, automações).
- ☐ Validar suporte a webhooks de
standbye a estados de Thread Control. - ☐ Implementar o roteamento
messagingvsstandbyno parser de webhook. - ☐ Desenhar a UX de "assumir / devolver" conversa no inbox.
- ☐ Garantir disclosure de IA no seu próprio bot (nome com "IA/Bot/Assistente", 1ª mensagem, caminho para humano, STOP).
- ☐ Atualizar landing e sales deck: CRM como painel de controle, não como robô.
- ☐ Comunicar clientes ativos: "você pode usar o agente da Meta e continuar conosco".
Tese de retenção
Vira commodity quem insiste em ser o robô.
Sobrevive quem vira o painel de controle.
A plataforma absorve a feature. Você retém sendo o lugar onde o time trabalha, onde o funil vive, onde o humano entra no meio e onde o histórico fica registrado.
Referências
- Introducing Meta Business Agent (blog oficial WhatsApp for Business): produtos, conectores e "getting started is free".
- Meta's AI agent for WhatsApp Business is now available globally (TechCrunch, 03/jun/2026): lançamento, subscription e cobrança por token no enterprise.
- New pricing policy for AI Providers (Meta for Developers): cobrança por mensagem não-template, datas e
pricing_category. - messaging_handovers (Meta for Developers): Handover Protocol, Thread Control e standby.
- Sobre conversar com empresas que usam IA da Meta (Central de Ajuda do WhatsApp): a disclosure de IA vista pelo usuário.
- Meta Business Agent: Features, Limitations, and How to Get Started (Wati): limites do Self-Serve e passo a passo.
Leituras relacionadas na comunidade
- API Cloud × Coexistência (modelo de conexão do número)
- BSUIDs e Usernames (identidade além do telefone)
- Preço da API oficial em 2026 (custos e categorias)
Fontes: blog WhatsApp for Business, TechCrunch, Meta for Developers (AI Providers pricing e messaging_handovers) e Central de Ajuda do WhatsApp. Feature em rollout: nomes de campo, disponibilidade e pricing descritos pela Meta estão sujeitos a alteração. Última consolidação: 18 de julho de 2026.