Tag: Meta Business Agent

Ative o Meta Business Agent em um número WhatsApp gerenciado por BSP completando sete etapas nas ferramentas de desenvolvedor da Meta: aceitar os Termos de Serviço do MBA no WhatsApp Manager, configurar o faturamento, criar um system user com a função Admin, atribuir o app e a WABA a esse usuário, gerar um token BISU com as permissões necessárias, inscrever o app na WABA e inscrever nos campos de Webhook que direcionam as conversas entre o agente e a sua aplicação. Para uma visão mais ampla do produto, veja o guia completo sobre o Meta Business Agent.

Pontos-chave

• A configuração do Meta Business Agent em um número gerenciado por BSP requer sete etapas distintas, cada uma dependente da conclusão bem-sucedida da anterior.
• O BSP ou Tech Provider deve aceitar os Termos de Serviço do Tech Provider no Facebook Developer Portal antes que as chamadas de API do MBA funcionem.
• O MBA requer um token BISU com escopo para as permissões whatsapp_business_messaging e whatsapp_business_management; um token sem qualquer uma dessas permissões retorna um erro 401 Unauthorized.[1]
• A chamada da API de Onboarding (POST /{entity_id}/agent_onboarding) é uma etapa obrigatória antes de configurar o agente pelo Endpoint de configurações.[2]
• Teste com ai_audience definido como ALLOWLISTED_ONLY antes de ir para produção. Nenhum método de pagamento é necessário durante os testes.[3]

Quais são os pré-requisitos para ativar o Meta Business Agent em um número gerenciado por BSP?

Antes de iniciar a configuração, reúna três IDs e confirme que seu número de telefone é elegível. Você precisa de um WhatsApp Business Account (WABA) ID do WhatsApp Manager, um Business Portfolio ID do Meta Business Suite e um App ID do Facebook Developer Portal.[1] O app deve ter a permissão whatsapp_business_messaging concedida.

O número de telefone deve atender a todas as seis condições de elegibilidade.[4] Ele deve estar em um segmento suportado com uma categoria de negócio válida. Todos os segmentos são suportados, exceto Finanças, Governo, Saúde, Álcool, Jogos de Azar, medicamentos de venda livre e serviços matrimoniais. O número deve ser gerenciado pela Cloud API, inclusive por meio de um Solution Partner ou Embedded Signup. Nem a WABA nem o negócio proprietário podem estar restritos ou banidos. O negócio deve estar em um país autorizado para MBA e deve cumprir os requisitos de confiança e verificação.

Confirme a elegibilidade programaticamente com GET /{phone_number_id}/agent_eligibility usando o header X-API-Version: 2.0.0.[4] Para a lista completa de condições, veja o checklist de elegibilidade.

Aceitar os Termos de Serviço do MBA

Aceite os Termos de Serviço do MBA no WhatsApp Manager navegando até a WABA correta e abrindo a aba Meta Business Agent. Essa aba aparece somente se pelo menos um número de telefone na WABA for elegível.[1] Selecione os números elegíveis e conclua a aceitação. O agente não é ativado após essa etapa.

Para números gerenciados por BSP, duas aceitações são necessárias. O cliente aceita os Termos de Serviço do MBA no WhatsApp Manager. O BSP ou Tech Provider deve aceitar separadamente os Termos de Serviço do Tech Provider, registrando-se como Tech Provider no Facebook Developer Portal.[1] O Meta Business Agent rejeita chamadas de API até que ambos estejam registrados.

Configurar o faturamento para o Meta Business Agent

Configure um método de pagamento no Billing Hub da Meta antes de ativar o agente para tráfego de produção. As mensagens não são entregues a menos que a conta tenha um método de pagamento vinculado.[1] Navegue até business.facebook.com/latest/billing_hub/ e adicione um método de pagamento para o Business Portfolio associado à WABA.

Ativar o agente com ai_audience definido como ALLOWLISTED_ONLY não requer método de pagamento.[3] Um método de pagamento é necessário somente ao expandir para EVERYONE.

Criar e configurar um system user

Crie um system user com a função Admin no Meta Business Suite e, em seguida, atribua tanto o app quanto a WABA a esse usuário. As requisições de API do MBA se autenticam como system user.[1] Se um system user adequado já existir, pule para a atribuição de ativos.

Acesse o Meta Business Suite (business.facebook.com/settings/), abra Configurações, selecione System users em Usuários, clique em + Add, insira um nome, selecione a função Admin e clique em Create system user.

Para atribuir ativos, selecione o system user, clique no menu de três pontos e clique em Assign Assets. Selecione Apps, encontre o app e ative a caixa de seleção. Em seguida, encontre a WABA, ative a caixa de seleção e clique no controle deslizante ao lado de View and manage phone numbers. Clique em Assign Assets para salvar.

Se você gerencia múltiplas WABAs e precisa de ajuda para configurar system users entre elas, fale conosco sobre como simplificar o processo por meio de uma única integração de parceiro.

Gerar um token BISU com as permissões necessárias

Gere um token Business Integration System User (BISU) para o system user. Um token BISU permite que sua plataforma atue em nome de múltiplas WABAs de clientes sob uma única credencial.[1] A Meta documenta duas opções de token: um token de system user padrão para integradores diretos e um token BISU para Solution Partners e Tech Providers.

O MBA requer um token BISU com escopo para as permissões whatsapp_business_messaging e whatsapp_business_management; um token sem qualquer uma dessas permissões retorna um erro 401 Unauthorized.[5] Este é o ponto de falha mais comum durante a configuração. Verifique se ambas as permissões estão selecionadas antes de gerar o token.

Inclua o header X-API-Version: 2.0.0 em toda requisição de API do MBA.[1] Requisições sem esse header usam a versão 1.0.0 por padrão, onde o Endpoint de Skills não está disponível.

A equipe de suporte de parceiros da 360Dialog pode verificar a configuração do seu token antes que você encontre um erro 401.

Inscrever nos campos de Webhook necessários

Inscreva seu app na WABA e configure os três campos de Webhook necessários que conectam seu app ao pipeline de conversas.[1]

Primeiro, inscreva o app na WABA. No Graph API Explorer, selecione o app, escolha Get App Token, selecione o Business Portfolio e a WABA e envie POST /{WABA_ID}/subscribed_apps. Verifique com GET /{WABA_ID}/subscribed_apps.

Segundo, inscreva nos campos de Webhook no Facebook Developer Portal. Abra o app, navegue até a aba WhatsApp e abra Configuration. Inscreva-se em três campos: messages, standby e messaging_handovers.[1]

Esses campos estabelecem o roteamento de conversas entre o MBA e a sua aplicação. O MBA atua como o respondente principal. Seu app de parceiro recebe mensagens dos consumidores no Webhook standby enquanto o agente detém o controle, e no Webhook messages quando seu app detém o controle. O Webhook messaging_handovers é disparado a cada mudança de controle. Seu app de parceiro assume o controle enviando uma mensagem para a conversa ou chamando Thread Control com a ação take (restrita ao parceiro de escalação configurado). Para devolver o controle, chame Thread Control com a ação release. Parar de enviar mensagens não libera o controle; o Endpoint release deve ser chamado explicitamente.

Para uma análise mais detalhada das mudanças no roteamento de conversas, veja o que muda na sua integração BSP. Como BSP gerenciando a infraestrutura da WhatsApp Business API para contas de clientes, a 360Dialog, um Official Meta Solution Partner, oferece suporte ao caminho completo de ativação do MBA para números gerenciados pela sua plataforma.

Se a sua plataforma está pronta para a configuração do MBA, começar a usar a API para construir sobre a infraestrutura de WhatsApp Business API da 360Dialog.

Configurar conhecimento, skills e connectors do agente

Configure o agente em três estágios de API: Onboard, Configure e Operate. O mínimo para ativar o agente é chamar o Endpoint de Onboarding e depois o Endpoint de configurações.[1]

Comece com a API de Onboarding: envie POST /{entity_id}/agent_onboarding com um corpo vazio para WhatsApp.[2] Isso retorna um agent_id e cria a configuração do agente. Até que essa chamada seja bem-sucedida, todos os outros Endpoints do MBA reportam que nenhum agente existe para a entidade.

Após o Onboarding, configure o conhecimento pelos Endpoints dedicados: Skills (instruções do sistema), informações de negócio (horários, localizações, políticas), FAQs, websites (URLs para o agente rastrear), arquivos (fontes de conhecimento carregadas), Connectors (definições de API externas) e ferramentas de Connector.[1] O catálogo de produtos é gerenciado separadamente no Meta Commerce Manager.

Configure o comportamento de transferência pelo Endpoint de configurações. O booleano handoff.enabled controla se o agente libera o controle da Thread após uma mensagem de transferência. O campo message_selection suporta três modos: CUSTOM (o negócio fornece a mensagem), AGENT (a IA compõe conforme a conversa) e DEFAULT (mensagem padrão fixa).[3]

Testar o Meta Business Agent antes de ir para produção

Teste com uma audiência restrita antes de expor o agente a clientes reais. A sequência correta é: adicionar consumidores de teste à lista de permissões, definir ai_audience como ALLOWLISTED_ONLY e então ativar o agente.[1] Ativar o agente antes de restringir a audiência o expõe a conversas ao vivo.

Adicione números de telefone de teste chamando POST /{entity_id}/agent_config/allowlist com consumer_phone_number no formato E.164.[1] Liste as entradas com GET e remova com DELETE no mesmo Endpoint.

Ative o agente chamando PUT /{entity_id}/agent_config/settings com rollout.enabled definido como true.[3] A Meta também fornece uma Agent Test API em /{entity_id}/agent_test que envia mensagens de teste por todo o pipeline de forma síncrona, sem necessidade de ativar o agente e sem cobrar os tokens consumidos.[5]

Antes de mudar ai_audience para EVERYONE, confirme as inscrições de Webhook com GET /{WABA_ID}/subscribed_apps, verifique as configurações com GET /{entity_id}/agent_config/settings, vincule um método de pagamento no Billing Hub e valide a lógica de transferência disparando uma escalação pela Agent Test API.[1] Monitore o Endpoint de Agent Insights para revisar quais fontes de conhecimento e skills o agente usa durante as conversas de teste. Desativar o agente interrompe as respostas em todas as threads ativas; reativar faz com que ele responda apenas a novas threads.[3]

Clientes 360Dialog contam com suporte dedicado de parceiro em cada etapa da configuração do MBA, da configuração do token ao go-live. Começar a usar a API para começar a construir.

Perguntas frequentes

Posso usar o Meta Business Agent com um número gerenciado por BSP?

Sim. O Meta Business Agent funciona com números gerenciados por um BSP ou Tech Provider, desde que o número use Cloud API. O BSP ou Tech Provider deve aceitar os Termos de Serviço do Tech Provider no Facebook Developer Portal, e o token BISU deve incluir as permissões whatsapp_business_messaging e whatsapp_business_management.

O Meta Business Agent funciona em todos os segmentos?

O MBA suporta todos os segmentos, exceto Finanças, Governo, Saúde, Álcool, Jogos de Azar, medicamentos de venda livre e serviços matrimoniais. O número de telefone também deve ter uma categoria de negócio válida configurada no WhatsApp Manager. Confirme a elegibilidade chamando GET /{phone_number_id}/agent_eligibility com o header X-API-Version: 2.0.0 antes de iniciar o processo de configuração.

O que acontece se o token BISU estiver sem uma permissão?

Um token BISU que não tenha a permissão whatsapp_business_messaging ou whatsapp_business_management retorna um erro 401 Unauthorized nas chamadas de API do MBA. Gere novamente o token com ambas as permissões selecionadas. Este é o ponto de falha mais comum durante a configuração do MBA, portanto verifique ambos os escopos antes de fazer qualquer requisição de API.

Preciso configurar o faturamento antes de testar?

Ativar o agente com ai_audience definido como ALLOWLISTED_ONLY não requer método de pagamento. Um método de pagamento é necessário somente ao mudar ai_audience para EVERYONE para tráfego de produção. A Agent Test API em /{entity_id}/agent_test também envia mensagens de teste sem cobrar os tokens consumidos.

Qual é a diferença entre as ações release, pass e take do Thread Control?

A ação release devolve o controle do app de parceiro para o MBA. A ação pass transfere o controle para o parceiro de escalação, ou para o MBA quando control_pass.target_role está definido como ai_agent. A ação take é restrita ao parceiro de escalação configurado e assume o controle da conversa diretamente.

Sources

[1] “Get started,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/get-started.

[2] “Agent Onboarding,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-onboarding.

[3] “Agent Settings,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings.

[4] “Overview,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/overview.

[5] “Quickstart,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/quickstart.

Ative o Meta Business Agent em um número WhatsApp gerenciado por BSP completando sete etapas nas ferramentas de desenvolvedor da Meta: aceitar os Termos de Serviço do MBA no WhatsApp Manager, configurar o faturamento, criar um system user com a função Admin, atribuir o app e a WABA a esse usuário, gerar um token BISU com as permissões necessárias, inscrever o app na WABA e inscrever nos campos de Webhook que direcionam as conversas entre o agente e a sua aplicação. Para uma visão mais ampla do produto, veja o guia completo sobre o Meta Business Agent.

Pontos-chave

• A configuração do Meta Business Agent em um número gerenciado por BSP requer sete etapas distintas, cada uma dependente da conclusão bem-sucedida da anterior.
• O BSP ou Tech Provider deve aceitar os Termos de Serviço do Tech Provider no Facebook Developer Portal antes que as chamadas de API do MBA funcionem.
• O MBA requer um token BISU com escopo para as permissões whatsapp_business_messaging e whatsapp_business_management. Um token sem whatsapp_business_messaging retorna 401 Unauthorized; um token com messaging mas sem whatsapp_business_management se autentica e retorna resultados vazios nas chamadas de leitura.[6]
• A chamada da API de Onboarding (POST /{entity_id}/agent_onboarding) é uma etapa obrigatória antes de configurar o agente pelo Endpoint de configurações.[2]
• Teste com ai_audience definido como ALLOWLISTED_ONLY antes de ir para produção. Nenhum método de pagamento é necessário durante os testes.[3]

Quais são os pré-requisitos para ativar o Meta Business Agent em um número gerenciado por BSP?

Antes de iniciar a configuração, reúna três IDs e confirme que seu número de telefone é elegível. Você precisa de um WhatsApp Business Account (WABA) ID do WhatsApp Manager, um Business Portfolio ID do Meta Business Suite e um App ID do Facebook Developer Portal.[1] O app deve ter a permissão whatsapp_business_messaging concedida.

O número de telefone deve atender a todas as seis condições de elegibilidade.[4] Ele deve estar em um segmento suportado com uma categoria de negócio válida. Todos os segmentos são suportados, exceto Finanças, Governo, Saúde, Álcool, Jogos de Azar, medicamentos de venda livre e serviços matrimoniais. O número deve ser gerenciado pela Cloud API, inclusive por meio de um Solution Partner ou Embedded Signup. Nem a WABA nem o negócio proprietário podem estar restritos ou banidos. O negócio deve estar em um país autorizado para MBA e deve cumprir os requisitos de confiança e verificação.

Confirme a elegibilidade programaticamente com GET /{phone_number_id}/agent_eligibility usando o header X-API-Version: 2.0.0.[4] Para a lista completa de condições, veja o checklist de elegibilidade.

Aceitar os Termos de Serviço do MBA

Aceite os Termos de Serviço do MBA no WhatsApp Manager navegando até a WABA correta e abrindo a aba Meta Business Agent. Essa aba aparece somente se pelo menos um número de telefone na WABA for elegível.[1] Selecione os números elegíveis e conclua a aceitação. O agente não é ativado após essa etapa.

Para números gerenciados por BSP, duas aceitações são necessárias. O cliente aceita os Termos de Serviço do MBA no WhatsApp Manager. O BSP ou Tech Provider deve aceitar separadamente os Termos de Serviço do Tech Provider, registrando-se como Tech Provider no Facebook Developer Portal.[1] O Meta Business Agent rejeita chamadas de API até que ambos estejam registrados.

Configurar o faturamento para o Meta Business Agent

Configure um método de pagamento no Billing Hub da Meta antes de ativar o agente para tráfego de produção. As mensagens não são entregues a menos que a conta tenha um método de pagamento vinculado.[1] Navegue até business.facebook.com/latest/billing_hub/ e adicione um método de pagamento para o Business Portfolio associado à WABA. A fatura vem da Meta e não do seu provedor, o que está detalhado em quem cobra você pelas mensagens do Meta Business Agent.

Ativar o agente com ai_audience definido como ALLOWLISTED_ONLY não requer método de pagamento.[3] Um método de pagamento é necessário somente ao expandir para EVERYONE.

Criar e configurar um system user

Crie um system user com a função Admin no Meta Business Suite e, em seguida, atribua tanto o app quanto a WABA a esse usuário. As requisições de API do MBA se autenticam como system user.[1] Se um system user adequado já existir, pule para a atribuição de ativos.

Acesse o Meta Business Suite (business.facebook.com/settings/), abra Configurações, selecione System users em Usuários, clique em + Add, insira um nome, selecione a função Admin e clique em Create system user.

Para atribuir ativos, selecione o system user, clique no menu de três pontos e clique em Assign Assets. Selecione Apps, encontre o app e ative a caixa de seleção. Em seguida, encontre a WABA, ative a caixa de seleção e clique no controle deslizante ao lado de View and manage phone numbers. Clique em Assign Assets para salvar.

Se você gerencia múltiplas WABAs e precisa de ajuda para configurar system users entre elas, fale conosco sobre como simplificar o processo por meio de uma única integração de parceiro.

Gerar um token BISU com as permissões necessárias

Gere um token Business Integration System User (BISU) para o system user. Um token BISU permite que sua plataforma atue em nome de múltiplas WABAs de clientes sob uma única credencial.[1] A Meta documenta duas opções de token: um token de system user padrão para integradores diretos e um token BISU para Solution Partners e Tech Providers.

O MBA requer um token BISU com escopo para as permissões whatsapp_business_messaging e whatsapp_business_management, e as duas falham de formas diferentes. Um token sem whatsapp_business_messaging retorna 401 Unauthorized. Um token com messaging mas sem whatsapp_business_management se autentica e retorna resultados vazios em toda chamada de leitura, o que é mais difícil de perceber do que uma recusa direta.[6] Este é o ponto de falha mais comum durante a configuração. Selecione as duas permissões antes de gerar o token.

Inclua o header X-API-Version: 2.0.0 em toda requisição à Meta Business Agent Platform API.[6] Sem o header, a requisição resolve para a versão mais antiga que aquele endpoint suporta, 1.0.0 para endpoints anteriores a esses nomes de campo, onde o Endpoint de Skills não está disponível. Os endpoints da Cloud API são diferentes: o Thread Control espera X-API-Version: 1.0.0, então use o valor indicado na página de referência de cada endpoint em vez de um header compartilhado.[6]

A equipe de suporte de parceiros da 360Dialog pode verificar a configuração do seu token antes que uma permissão faltando custe uma sessão de depuração.

Inscrever nos campos de Webhook necessários

Inscreva seu app na WABA e configure os três campos de Webhook necessários que conectam seu app ao pipeline de conversas.[1]

Primeiro, inscreva o app na WABA. No Graph API Explorer, selecione o app, escolha Get App Token, selecione o Business Portfolio e a WABA e envie POST /{WABA_ID}/subscribed_apps. Verifique com GET /{WABA_ID}/subscribed_apps.

Segundo, inscreva nos campos de Webhook no Facebook Developer Portal. Abra o app, navegue até a aba WhatsApp e abra Configuration. Inscreva-se em três campos: messages, standby e messaging_handovers.[1]

Esses campos estabelecem o roteamento de conversas entre o MBA e a sua aplicação. O MBA atua como o respondente principal. Seu app de parceiro recebe mensagens dos consumidores no Webhook standby enquanto o agente detém o controle, e no Webhook messages quando seu app detém o controle. O Webhook messaging_handovers é disparado a cada mudança de controle. Seu app de parceiro assume o controle enviando uma mensagem para a conversa ou chamando Thread Control com a ação take (restrita ao parceiro de escalação configurado). Para devolver o controle, chame Thread Control com a ação release. Parar de enviar mensagens não libera o controle; o Endpoint release deve ser chamado explicitamente.

Para uma análise mais detalhada das mudanças no roteamento de conversas, veja o que muda na sua integração BSP. Como BSP gerenciando a infraestrutura da WhatsApp Business API para contas de clientes, a 360Dialog, um Official Meta Solution Partner, oferece suporte ao caminho completo de ativação do MBA para números gerenciados pela sua plataforma.

Se a sua plataforma está pronta para a configuração do MBA, começar a usar a API para construir sobre a infraestrutura de WhatsApp Business API da 360Dialog.

Configurar conhecimento, skills e connectors do agente

Configure o agente em três estágios de API: Onboard, Configure e Operate. O mínimo para ativar o agente é chamar o Endpoint de Onboarding e depois o Endpoint de configurações.[1]

Comece com a API de Onboarding: envie POST /{entity_id}/agent_onboarding com um corpo vazio para WhatsApp.[2] Isso retorna um agent_id e cria a configuração do agente. Até que essa chamada seja bem-sucedida, todos os outros Endpoints do MBA reportam que nenhum agente existe para a entidade.

Após o Onboarding, configure o conhecimento pelos Endpoints dedicados: Skills (instruções do sistema), informações de negócio (horários, localizações, políticas), FAQs, websites (URLs para o agente rastrear), arquivos (fontes de conhecimento carregadas), Connectors (definições de API externas) e ferramentas de Connector.[1] O catálogo de produtos é gerenciado separadamente no Meta Commerce Manager.

Configure o comportamento de transferência pelo Endpoint de configurações. O booleano handoff.enabled controla se o agente libera o controle da Thread após uma mensagem de transferência. O campo message_selection suporta três modos: CUSTOM (o negócio fornece a mensagem), AGENT (a IA compõe conforme a conversa) e DEFAULT (mensagem padrão fixa).[3]

Testar o Meta Business Agent antes de ir para produção

Teste com uma audiência restrita antes de expor o agente a clientes reais. A sequência correta é: adicionar consumidores de teste à lista de permissões, definir ai_audience como ALLOWLISTED_ONLY e então ativar o agente.[1] Ativar o agente antes de restringir a audiência o expõe a conversas ao vivo.

Adicione números de telefone de teste chamando POST /{entity_id}/agent_config/allowlist com consumer_phone_number no formato E.164.[1] Liste as entradas com GET e remova com DELETE no mesmo Endpoint.

Ative o agente chamando PUT /{entity_id}/agent_config/settings com rollout.enabled definido como true.[3] A Meta também fornece uma Agent Test API em /{entity_id}/agent_test que envia mensagens de teste por todo o pipeline de forma síncrona, sem necessidade de ativar o agente e sem cobrar os tokens consumidos.[5]

Antes de mudar ai_audience para EVERYONE, confirme as inscrições de Webhook com GET /{WABA_ID}/subscribed_apps, verifique as configurações com GET /{entity_id}/agent_config/settings, vincule um método de pagamento no Billing Hub e valide a lógica de transferência disparando uma escalação pela Agent Test API.[1] Monitore o Endpoint de Agent Insights para revisar quais fontes de conhecimento e skills o agente usa durante as conversas de teste. Desativar o agente interrompe as respostas em todas as threads ativas; reativar faz com que ele responda apenas a novas threads.[3]

Clientes 360Dialog contam com suporte dedicado de parceiro em cada etapa da configuração do MBA, da configuração do token ao go-live. Começar a usar a API para começar a construir.

Perguntas frequentes

Posso usar o Meta Business Agent com um número gerenciado por BSP?

Sim. O Meta Business Agent funciona com números gerenciados por um BSP ou Tech Provider, desde que o número use Cloud API. O BSP ou Tech Provider deve aceitar os Termos de Serviço do Tech Provider no Facebook Developer Portal, e o token BISU deve incluir as permissões whatsapp_business_messaging e whatsapp_business_management.

O Meta Business Agent funciona em todos os segmentos?

O MBA suporta todos os segmentos, exceto Finanças, Governo, Saúde, Álcool, Jogos de Azar, medicamentos de venda livre e serviços matrimoniais. O número de telefone também deve ter uma categoria de negócio válida configurada no WhatsApp Manager. Confirme a elegibilidade chamando GET /{phone_number_id}/agent_eligibility com o header X-API-Version: 2.0.0 antes de iniciar o processo de configuração.

O que acontece se o token BISU estiver sem uma permissão?

Um token BISU que não tenha a permissão whatsapp_business_messaging ou whatsapp_business_management retorna um erro 401 Unauthorized nas chamadas de API do MBA. Gere novamente o token com ambas as permissões selecionadas. Este é o ponto de falha mais comum durante a configuração do MBA, portanto verifique ambos os escopos antes de fazer qualquer requisição de API.

Preciso configurar o faturamento antes de testar?

Ativar o agente com ai_audience definido como ALLOWLISTED_ONLY não requer método de pagamento. Um método de pagamento é necessário somente ao mudar ai_audience para EVERYONE para tráfego de produção. A Agent Test API em /{entity_id}/agent_test também envia mensagens de teste sem cobrar os tokens consumidos.

Qual é a diferença entre as ações release, pass e take do Thread Control?

A ação release devolve o controle do app de parceiro para o MBA. A ação pass transfere o controle para o parceiro de escalação, ou para o MBA quando control_pass.target_role está definido como ai_agent. A ação take é restrita ao parceiro de escalação configurado e assume o controle da conversa diretamente.

Fontes

[1] “Get started,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/get-started.

[2] “Agent Onboarding,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-onboarding.

[3] “Agent Settings,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings.

[4] “Overview,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/overview.

[5] “Quickstart,” Meta for Developers, accessed September 14, 2026, https://developers.facebook.com/documentation/meta-business-agent/quickstart.

[6] “Get API key,” Meta for Developers, acessado em 21 de setembro de 2026, https://developers.facebook.com/documentation/meta-business-agent/get-api-key.

A Meta cobra diretamente de todas as empresas pelas mensagens do Meta Business Agent, incluindo as empresas cujo número do WhatsApp é gerenciado por um Business Solution Provider (BSP), a $2,00 por 1 milhão de tokens.[1] A cobrança entrou em vigor em 1º de agosto de 2026, às 12h PT, e a fatura vem da Meta, debitada de uma linha de crédito mantida no Billing Hub da própria empresa. Uma única resposta do agente costuma consumir de 20.000 a 25.000 tokens, cerca de 4 a 5 centavos de dólar. A tarifa tem uma condição: o tráfego do Meta Business Agent não é entregue enquanto não houver uma forma de pagamento anexada à conta do Business Agent.

Principais conclusões

1. A Meta cobra diretamente de todas as empresas pelo uso do Meta Business Agent a $2,00 por 1 milhão de tokens, e essa cobrança não passa pelo BSP.
2. As mensagens do Meta Business Agent não são entregues enquanto não houver uma forma de pagamento anexada à conta do Business Agent, seja uma linha de crédito da Meta ou, desde 8 de setembro de 2026, um cartão Visa ou Mastercard.[3]
3. A Meta tinha 16 moedas habilitadas em 1º de julho de 2026 e fatura as contas em moeda diferente do dólar pela taxa de câmbio do dia.
4. As taxas do BSP por acesso à API, suporte e recursos de plataforma continuam em uma fatura separada.

Quem cobra pelo uso do Meta Business Agent?

A Meta cobra da empresa dona da WhatsApp Account (antiga WhatsApp Business Account, ou WABA), e a relação com um BSP não muda isso. A documentação de preços da Meta afirma que ela “vai cobrar de todas as empresas pelo Meta Business Agent, incluindo aquelas […] apoiadas por um ou mais Solution Providers” e que a cobrança funciona como faturamento mensal debitado de uma linha de crédito da Meta, com cartões de crédito e débito Visa e Mastercard disponíveis para todas as empresas desde 8 de setembro de 2026.[1] O preço é uma tarifa global única de $2,00 por 1 milhão de tokens cobrindo tokens de entrada e de saída (tokens de cache são gratuitos), cobrada uma vez por mensagem, entre processamento e entrega do agente. A mesma página compara 1.000 respostas geradas por IA para usuários no Brasil: cerca de $27 ou cerca de $97 para tráfego de serviço, conforme a complexidade, contra cerca de $40 a $50 para o agente. A mecânica das conversas está detalhada em como o Meta Business Agent funciona dentro das conversas da WhatsApp Business API.

Por que as mensagens não são entregues sem uma forma de pagamento?

A Meta condiciona a entrega à forma de pagamento anexada à conta do Business Agent, e a linha de crédito é uma das maneiras de atender a isso, não o requisito em si. A referência de Agent Settings afirma que as mensagens do Meta Business Agent não são entregues a menos que a conta do Business Agent tenha uma forma de pagamento anexada, e que ativar o agente com ai_audience em ALLOWLISTED_ONLY não exige nenhuma, então dá para testar um número de ponta a ponta com os consumidores da allowlist antes de resolver a cobrança.[3] Uma integração da WhatsApp Business API funcionando, um número ativo e um contrato assinado com o BSP não atendem a nenhum desses requisitos. Uma empresa pode passar por todas as verificações técnicas e ainda assim não ver nenhuma resposta do agente. Se o número é elegível ou não é uma condição à parte, detalhada em as seis condições de elegibilidade que a Meta aplica.

Um segundo prazo da Meta cobre as mensagens de serviço e funciona de forma independente da linha de crédito do Business Agent. Qualquer empresa apoiada por um Solution Provider ou integrada diretamente que não tiver um meio de pagamento cadastrado até 30 de setembro de 2026 perde a entrega de mensagens de serviço assim que elas passarem a ser cobradas, em 1º de outubro de 2026. Cada número de telefone recebe 1.000 mensagens de serviço gratuitas por mês a partir de 1º de outubro de 2026. As mensagens de serviço também podem ser incluídas em contratos de preço fixo (FPCs). O Billing Hub cuida desse meio de pagamento, e ele fica separado da conta do Business Agent. O cronograma completo está em a cobrança de mensagens de serviço que volta em 1º de outubro de 2026.

Como anexar uma linha de crédito para o Meta Business Agent?

Os dois caminhos passam pelo Billing Hub, e qual deles se aplica depende de a empresa já ter ou não uma linha de crédito da Meta vinda de anúncios ou de outro produto de mensagens. A empresa que já tem uma adiciona a conta do Business Agent a ela em três etapas:

1. Acesse “Credit lines” no painel lateral.
2. Clique em “Set up now” no modal “Use monthly invoicing for Business Agent”.
3. Aceite os termos de pagamento e faturamento.

A empresa que não tem nenhum acordo em vigor pode solicitar um pelo Billing Hub, sujeito a análise e aprovação da Meta. Esse caminho começa em “Get started”, no banner “Switch to monthly invoicing”; na tela “Select accounts”, a conta do Business Agent permanece selecionada. As empresas sem elegibilidade para uma linha de crédito pagam com cartão de crédito ou débito Visa ou Mastercard, disponível para todas as empresas desde 8 de setembro de 2026.[1]

Em quais moedas a Meta emite as faturas?

A Meta tinha 16 moedas habilitadas na WhatsApp Business Platform em 1º de julho de 2026, e uma delas é escolhida quando a conta do Business Agent é criada. Uma conta em moeda diferente do dólar é faturada na própria moeda, pela tarifa global em USD convertida diariamente.

Moeda	País de cobrança	Faturamento
USD mais AED, ARS, AUD, CLP, COP, EUR, GBP, IDR, MXN, MYR, PEN, SAR, SGD	Qualquer um, exceto Índia ou Brasil	Tarifa em USD; conversão diária para moedas diferentes do dólar
INR	Somente Índia	Conversão diária a partir do USD
BRL (ainda não disponível)	Somente Brasil	Conversão diária a partir do USD

A tabela lista o BRL como “ainda não disponível”, então uma empresa brasileira deve primeiro confirmar o status atual no Billing Hub.[1]

O seu BSP cuida da cobrança do Meta Business Agent?

Não. A cobrança do Meta Business Agent não chega ao BSP, o que não deixa nada para um provedor aplicar sobretaxa ou empacotar. A página de preços da Meta cita as empresas apoiadas por um Solution Provider entre aquelas de quem ela vai cobrar, e a linha de crédito fica na conta do Business Agent, dentro do Billing Hub da empresa. Descrições que atribuem essa cobrança ao BSP, ou que deixam em aberto se ela vem do BSP ou da Meta, não correspondem à documentação.

A 360Dialog, Official Meta Solution Partner, fornece acesso à WhatsApp Business API com suporte 24/7 em sete idiomas, e a cobrança de tokens pelas respostas do agente continua chegando na própria fatura Meta do cliente. O anúncio do suporte ao Meta Business Agent descreve o caminho de ativação.

Pelo que o seu BSP ainda cobra de você?

O seu BSP cobra pelo acesso à API, pelo suporte e pelos recursos de plataforma, em uma fatura separada da fatura da Meta. A Meta cobra o uso de tokens pelas respostas do agente e tarifas por mensagem para o tráfego de template e de serviço, e o BSP fatura a infraestrutura ao redor disso. A 360Dialog não aplica nenhuma sobretaxa às tarifas de mensagem da Meta e cobra uma assinatura pelo acesso à API e pelo suporte. Os modelos de sobretaxa e seu efeito no custo estão detalhados em por que uma sobretaxa por mensagem costuma custar mais.

Uma implantação do Meta Business Agent traz um pré-requisito do lado da Meta que nenhum contrato de provedor cobre: uma forma de pagamento, em uma moeda suportada, no Billing Hub da própria empresa. As equipes que orçam o volume do agente devem projetar o custo em tokens contra a fatura da Meta. Depois que a cobrança estiver resolvida, os sete passos de ativação cobrem o resto da configuração de um número gerenciado por BSP.

Ter a base da WhatsApp Business API pronta é o primeiro passo para qualquer implantação de agente. Começar a usar a API.

Perguntas frequentes

Quanto custa o Meta Business Agent por mensagem?

O Meta Business Agent custa $2,00 por 1 milhão de tokens, uma tarifa global única. Uma resposta típica do agente consome de 20.000 a 25.000 tokens, o que coloca o custo efetivo em cerca de 4 a 5 centavos de dólar por mensagem. A cobrança por token cobre o processamento por IA e a entrega.

É possível usar o Meta Business Agent com um número gerenciado por um BSP?

Sim. A documentação da Meta cita as empresas apoiadas por um Solution Provider entre aquelas de quem ela vai cobrar pelo Meta Business Agent, o que coloca essa configuração no escopo. O requisito é uma forma de pagamento anexada à conta do Business Agent no Billing Hub, e as respostas do agente não são entregues enquanto ela não estiver lá.

A cobrança do Meta Business Agent pode vir do seu provedor, da Meta ou de ambos?

Somente da Meta. A documentação de preços da Meta afirma que ela vai cobrar de todas as empresas pelo Meta Business Agent, incluindo aquelas apoiadas por um Solution Provider, com faturamento mensal debitado de uma linha de crédito da Meta, ou pagamento com cartão. Uma fatura do BSP pode existir em paralelo, pelo acesso à API e pelo suporte, e ela nunca carrega a cobrança de tokens.

Fontes

[1] Meta for Developers, non-template messages pricing documentation (page updated August 25, 2026). https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages (accessed September 21, 2026)

[2] Meta for Developers, Get started with Meta Business Agent Platform APIs (page updated August 19, 2026). https://developers.facebook.com/documentation/meta-business-agent/get-started (accessed September 21, 2026)

[3] Meta for Developers, Agent Settings reference. https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings (accessed September 21, 2026). https://developers.facebook.com/documentation/meta-business-agent/get-started (accessed August 24, 2026)

O Meta Business Agent é um agente de IA corporativo que responde aos clientes no WhatsApp na própria voz da empresa, usando o conhecimento e os sistemas conectados dela, em números gerenciados pela Cloud API.[1] Isso inclui números gerenciados por um Business Solution Provider (BSP) ou por Embedded Signup. A Meta lançou a plataforma em 1º de julho de 2026 e começou a cobrar todas as empresas pelo uso em 1º de agosto de 2026, a uma tarifa global de $2,00 por 1 milhão de tokens.[2] Para quem usa a Cloud Meta Business Agent: o guia completo para usuários da API do WhatsApp

O Meta Business Agent é um agente de IA corporativo que responde aos clientes no WhatsApp na própria voz da empresa, usando o conhecimento e os sistemas conectados dela, em números gerenciados pela Cloud API.[1] Isso inclui números gerenciados por um Business Solution Provider (BSP) ou por Embedded Signup. A Meta lançou a plataforma em 1º de julho de 2026 e começou a cobrar todas as empresas pelo uso em 1º de agosto de 2026, a uma tarifa global de $2,00 por 1 milhão de tokens.[2] Para quem usa a Cloud API, isso cria uma nova camada de integração a avaliar: elegibilidade, configuração, roteamento de conversas, cobrança por token e uma relação de faturamento direta com a Meta que contorna completamente o BSP.

Principais conclusões

1. O Meta Business Agent é um agente de IA feito para números na WhatsApp Cloud API, incluindo números gerenciados por BSP, que responde aos clientes na voz da empresa com acesso ao seu conhecimento e aos seus sistemas conectados.
2. Dois produtos dividem o mesmo nome: o caminho Platform API (Cloud API, exige código) e o caminho Business App (sem código, para pequenas empresas), cada um com elegibilidade, configuração e cobrança diferentes.
3. A Meta cobra uma tarifa global fixa de $2,00 por 1 milhão de tokens, que combina IA e entrega em uma única cobrança, o equivalente a aproximadamente 4 a 5 centavos de dólar por mensagem.[2]
4. A Meta fatura todas as empresas diretamente pelo uso do Meta Business Agent, contornando a relação de faturamento com o BSP, e não entrega as mensagens do agente até que haja uma forma de pagamento vinculada à conta Business Agent.[2][7]
5. O app do parceiro passa a ser um participante em standby quando o agente está ativo e recebe as mensagens pelo webhook standby enquanto o agente mantém o controle.[3]

O que é o Meta Business Agent

O Meta Business Agent é um agente de IA corporativo que conversa com os clientes no WhatsApp na voz da marca. Uma vez ativado, ele atua como o respondente principal: responde a partir do conhecimento da empresa, executa ações nos próprios sistemas da empresa, como consultar um pedido ou fazer um agendamento, e transfere para o app da empresa quando necessário.[1]

O agente pode recomendar produtos e serviços, informar detalhes de preço, responder dúvidas sobre descontos, pagamento e envio, e fazer perguntas de acompanhamento para entender melhor o que o cliente precisa.[5] No caminho Platform API, as empresas configuram o conhecimento do agente por meio de conteúdo enviado, crawling do site, documentos de FAQ e catálogos de produtos conectados. Skills definem o tom e as prioridades do agente, enquanto Connectors definem as APIs externas que ele pode chamar.[3]

A Meta anunciou o produto em 3 de junho de 2026, informando que mais de um milhão de empresas já usam um Meta Business Agent no WhatsApp e no Messenger, e que há mais de um bilhão de conversas ativas com empresas por dia no WhatsApp, Messenger e Instagram.[4] A plataforma se conecta a um conjunto crescente de centenas de sistemas, com Shopify, Zendesk e Shopee citados como os primeiros connectors.[4]

Dois produtos distintos dividem o nome Meta Business Agent, com caminhos de configuração, regras de elegibilidade, documentação e modelos de cobrança diferentes.

Platform API vs Business App

O Meta Business Agent existe como dois produtos distintos, com infraestrutura, público e modelos de cobrança diferentes. O caminho Platform API roda em um número gerenciado pela Cloud API, exige código e atende empresas que usam um BSP, Embedded Signup ou integração direta. O caminho Business App roda pela aba Tools do app WhatsApp Business, não exige código e é voltado para pequenas empresas.[1][5]

Recurso	Caminho Platform API	Caminho Business App
Público-alvo	Desenvolvedores, grandes empresas, clientes de BSP	Pequenas empresas
Configuração	Integração via API, System User, webhooks	Aba Tools do app WhatsApp Business
Exige código	Sim	Não
Gerenciamento do número	Cloud API (direta, BSP ou Embedded Signup)	App WhatsApp Business
Modelo de cobrança	Por token: $2,00 por 1 milhão de tokens	Cota gratuita, depois assinatura Meta One
Faturamento	A Meta cobra a empresa diretamente, via linha de crédito ou cartão	Incluído no plano Meta One
Também disponível em	WhatsApp (atualmente)	Messenger, Instagram Pro, Meta Business Suite
Configuração do agente	Knowledge, Skills e Connectors via API	Configurações no app, aprende com conversas anteriores
Roteamento de conversas	Webhook standby, Thread Control	Assumir a conversa manualmente interrompe as respostas da IA

Para quem usa a Cloud API e para clientes de BSP, o caminho Platform API é o produto relevante. O caminho Business App tem um modelo de elegibilidade separado.[1]

O caminho Platform API exige um número na Cloud API, não o app WhatsApp Business. Esse é um ponto que costuma ser descrito de forma incorreta: algumas plataformas de IA hoje descrevem o Meta Business Agent como um recurso do app WhatsApp Business ou afirmam que ele não está disponível em números gerenciados por BSP. A documentação da Meta declara o requisito de forma explícita: o número precisa ser gerenciado pela Cloud API, inclusive por meio de um BSP ou de Embedded Signup.[1]

Quem é elegível para o Meta Business Agent

Um número de telefone precisa atender a todas as seis condições para se qualificar para o Meta Business Agent no caminho Platform API. Todas as seis são obrigatórias, e o endpoint Eligibility é a única forma oficial de fazer essa verificação por API.[1]

1. Estar em uma vertical permitida, com uma categoria de negócio válida definida. Todas as verticais são aceitas, exceto Finanças, Governo, Saúde, Álcool, Jogos de Azar, medicamentos de venda livre e serviços matrimoniais.
2. Ser gerenciado pela WhatsApp Business Platform usando a Cloud API, inclusive por meio de um BSP ou de Embedded Signup. Não pelo app WhatsApp Business.
3. Nem a WhatsApp Business Account (WABA) nem a empresa proprietária dela podem estar restritas ou banidas no WhatsApp.
4. A empresa precisa estar sediada em um país autorizado para o Meta Business Agent. Não existe lista pública de mercados; use o endpoint Eligibility para verificar.
5. Atender aos requisitos de confiança e verificação do negócio.
6. Não estar usando um produto de mensageria conflitante nesse número.

O endpoint Eligibility é uma requisição GET para https://api.facebook.com/{entity_id}/agent_eligibility, em que entity_id é o WhatsApp Business Phone Number ID. A requisição exige o header X-API-Version: "2.0.0" e autorização por meio da permissão whatsapp_business_messaging. A resposta retorna um booleano is_eligible.[6]

Como configurar o Meta Business Agent em um número na Cloud API

Configurar o Meta Business Agent no caminho Platform API exige sete etapas, tanto na integração direta quanto por meio de um BSP. O cliente aceita os Termos de Serviço e configura o faturamento primeiro; depois o desenvolvedor configura a autenticação e os webhooks.[3]

1. No WhatsApp Manager, uma aba Meta Business Agent aparece se algum número de telefone for elegível. Aceite os Termos de Serviço do Meta Business Agent. O agente ainda não responde aos clientes.
2. Configure o faturamento anexando uma forma de pagamento à conta Business Agent no Meta Billing Hub. As mensagens não são entregues sem faturamento configurado.[2]
3. Crie um System User com a função Admin no Meta Business Suite.
4. Atribua o app e a WABA ao System User com a opção “Visualizar e gerenciar números de telefone” selecionada.
5. Gere um access token: System User token para quem faz a integração direta, token BISU (Business Integration System User) para BSPs e Tech Providers. Ambos exigem as permissões whatsapp_business_messaging e whatsapp_business_management.
6. Faça um POST para /{WABA_ID}/subscribed_apps para inscrever o app na WABA.
7. Inscreva-se nos campos de webhook: messages, standby e messaging_handovers.

Em números gerenciados por BSP, dois Termos de Serviço precisam ser aceitos antes de qualquer chamada de API funcionar. O cliente aceita os Termos de Serviço do Meta Business Agent no WhatsApp Manager. O BSP ou Tech Provider precisa, além disso, aceitar os Termos de Serviço de Tech Provider, tornando-se Tech Provider no Facebook Developer Portal.[3]

Como funciona o roteamento de conversas: standby, handoff e Thread Control

Quando o Meta Business Agent é ativado em um número, ele passa a ser o respondente principal e responde diretamente ao consumidor. O app do parceiro passa a ser um participante em standby, que continua recebendo todo o tráfego de mensagens, mas não responde, a menos que assuma o controle explicitamente.[3]

O modelo de roteamento usa três campos de webhook:

• As mensagens do consumidor chegam ao campo de webhook standby enquanto o agente mantém o controle, e ao campo messages enquanto o app do parceiro mantém o controle.
• Um webhook messaging_handovers é disparado sempre que o controle muda entre o agente e o app do parceiro.
• O app do parceiro continua recebendo cópias das mensagens que o agente envia em nome da empresa, junto com as confirmações de entrega e de leitura, mantendo o sistema do parceiro sincronizado.

O app do parceiro assume o controle enviando uma mensagem para a conversa. Para devolver o controle ao agente, o app do parceiro chama o endpoint Thread Control usando a ação release, e o Meta Business Agent volta a responder como o respondente automático. A ação pass está reservada para uso futuro e não é aceita atualmente.[3][9][10]

O agente também dispara o handoff automaticamente quando detecta baixa confiança, uma violação de integridade ou um pedido do usuário para falar com um atendente humano. A configuração de handoff controla apenas se uma mensagem personalizada ou uma mensagem traduzida padrão é enviada ao consumidor, não se o handoff acontece.[7]

A 360Dialog, como Official Meta Solution Partner, apoia os clientes nas verificações de elegibilidade, no onboarding e nas mudanças operacionais que o Meta Business Agent traz para o modelo de integração via BSP.

Precisa de ajuda para implementar webhooks standby e Thread Control? Fale conosco.

Quanto custa o Meta Business Agent: a cobrança por token explicada

A Meta cobra uma tarifa global única de $2,00 por 1 milhão de tokens para todas as mensagens do Meta Business Agent entregues via API. A tarifa cobre tokens de entrada e de saída; tokens de cache são gratuitos. Normalmente, uma mensagem consome de 20.000 a 25.000 tokens, o que equivale a aproximadamente 4 a 5 centavos de dólar por mensagem.[2]

Os exemplos calculados pela Meta ilustram a faixa:

• Consulta simples (“A que horas vocês abrem?”), 4 mensagens para o usuário, cerca de 80.000 tokens, algo entre 16 e 20 centavos de dólar por conversa.
• Interação complexa, 10 mensagens para o usuário, cerca de 250.000 tokens, algo entre 40 e 50 centavos de dólar por conversa.[2]

Cada mensagem do Meta Business Agent carrega uma cobrança única que cobre tanto o uso de tokens de IA quanto a entrega da mensagem. Com IA de terceiros no WhatsApp, uma empresa normalmente paga o provedor de IA pela geração e o provedor de mensageria pela entrega, em cobranças separadas. A regra de cobrança única também vale para mensagens fora de template com conteúdo promocional, sem cobrança adicional de template de marketing.[2]

As janelas gratuitas não se aplicam às mensagens do Meta Business Agent. O uso de tokens é cobrado tanto durante a janela de 72 horas de ponto de entrada gratuito quanto durante a janela de 24 horas de atendimento ao cliente. A janela de 72 horas continua gratuita para a entrega da mensagem, mas o uso de tokens é cobrado de qualquer forma.[2]

A própria comparação de custos da Meta para 1.000 mensagens com IA no Brasil: mensagens de serviço de menor complexidade custam aproximadamente 2 a 3 centavos de dólar por mensagem (cerca de $27 no total), enquanto mensagens de serviço de maior complexidade custam aproximadamente 9 a 10 centavos de dólar por mensagem (cerca de $97). O Meta Business Agent em maior complexidade custa aproximadamente 4 a 5 centavos de dólar por mensagem (cerca de $40 a $50 no total).[2]

Para entender o contexto de como os preços do WhatsApp evoluíram junto com essas mudanças, veja a análise da 360Dialog sobre modelos de cobrança por assinatura.

Quem cobra você pelas mensagens do Meta Business Agent

A Meta fatura todas as empresas diretamente pelo uso do Meta Business Agent, incluindo empresas que acessam a WhatsApp Business Platform por meio de um Solution Provider.[2] Isso contorna o modelo atual de faturamento do BSP, em que o provedor cobra a empresa pelo uso de mensageria.

A cobrança é feita por meio de faturas mensais vinculadas a uma linha de crédito com a Meta, disponível para empresas elegíveis. Desde 8 de setembro de 2026, cartões de crédito e débito Visa e Mastercard também são aceitos, e essa opção está aberta a todas as empresas.[2]

A entrega depende da forma de pagamento, não da linha de crédito especificamente. A Meta não entrega as mensagens do Meta Business Agent enquanto não houver uma forma de pagamento vinculada à conta Business Agent.[7] Empresas que já têm linha de crédito com a Meta vinculam a conta Business Agent no Billing Hub, em Linhas de crédito. Empresas sem linha de crédito solicitam uma pelo Billing Hub, sujeita a análise e aprovação da Meta, ou pagam com cartão.[2] Vale conhecer uma exceção antes de planejar um rollout: um agente ativado com ai_audience em ALLOWLISTED_ONLY não exige forma de pagamento, então dá para testar um número de ponta a ponta com os consumidores da allowlist antes de resolver a cobrança.[7]

Em 1º de julho, 16 moedas estão habilitadas. A conta Business Agent é criada em uma delas, e uma conta em moeda diferente do dólar é faturada nessa moeda local, à taxa de câmbio do dia em que cada mensagem é entregue.[2]

Algumas plataformas de IA hoje afirmam que a fatura pelo uso do Meta Business Agent “pode vir do seu provedor, da Meta ou de ambos”. A documentação da Meta é explícita: a Meta cobra todas as empresas diretamente.[2]

O faturamento do Meta Business Agent faz parte de uma mudança de preços mais ampla. A partir de 1º de outubro de 2026, a Meta também vai começar a cobrar pelas mensagens de serviço (gratuitas desde novembro de 2024) e pelas mensagens de utilidade enviadas dentro de uma janela de atendimento ao cliente de 24 horas em aberto (gratuitas desde julho de 2025). Essas cobranças são por mensagem, às mesmas tarifas das mensagens de utilidade e de autenticação em cada mercado. Cada número de telefone recebe 1.000 mensagens de serviço gratuitas por mês a partir de 1º de outubro de 2026. As mensagens de serviço também podem ser incluídas em contratos de preço fixo (FPCs).[2] O cronograma completo e o que ele significa para um número gerenciado por BSP está em a cobrança de mensagens de serviço que volta em 1º de outubro de 2026.

Restrições e limites técnicos

O Meta Business Agent limita cada número a um agente, faz handoff automático em casos de baixa confiança ou violação de integridade e restringe os intervalos de follow-up e a segmentação de público a enumerações fixas.[1][7]

• Um agente por número. Um número não pode rodar mais de um produto de mensageria conflitante ao mesmo tempo.
• Comportamento ao desativar e reativar. Desativar o agente faz com que ele pare de responder em todas as conversas. Reativar faz com que ele responda apenas em conversas novas.
• Gatilhos de handoff automático. O agente faz handoff em casos de baixa confiança, violação de integridade ou quando o usuário pede para falar com um atendente humano. A configuração de handoff controla a mensagem enviada, não se o handoff acontece.
• Intervalos de follow-up. Uma enumeração fixa em segundos: 0, 300, 900, 1800, 3600, 7200, 28800, 86400. Zero desativa o follow-up.
• Controle de público. ai_audience aceita EVERYONE ou ALLOWLISTED_ONLY. Um endpoint de Allowlist separado limita o agente a números de telefone específicos de consumidores, para um rollout controlado.
• Exclusão de frases. never_say_phrases define frases exatas que o agente nunca pode incluir em uma resposta.
• Escopo de analytics. A Meta documenta analytics específicos do MBA em dois endpoints. O Insights retorna os turns ordenados da conversa mais recente de um consumidor, com latência ponta a ponta, um ID de sessão e um trace passo a passo das chamadas de modelo e de ferramenta por trás de cada turn. O Agent Eval retorna notas por conversa e por turn, com transcrições e categorias de falha. O Insights é consultado um número de telefone de consumidor por vez e cobre apenas a conversa mais recente desse consumidor.[2]

Como escolher um parceiro de API do WhatsApp para o Meta Business Agent

Escolher um parceiro de API do WhatsApp para o Meta Business Agent exige avaliar se o provedor concluiu os próprios requisitos do lado da plataforma e se consegue dar suporte a todo o ciclo de integração, da verificação de elegibilidade até a produção.[3][8]

Critérios principais:

• Status de Tech Provider. O parceiro precisa ser um Tech Provider registrado no Facebook Developer Portal, com App Review concluído e acesso avançado a whatsapp_business_messaging e whatsapp_business_management.
• Suporte a webhooks. A plataforma do parceiro precisa tratar o webhook standby e a ação release do Thread Control, para que a sua empresa consiga assumir conversas e devolvê-las ao agente.
• Modelo de token. BSPs usam um token BISU ao fazer chamadas de API em nome das WABAs dos clientes. Confirme se o seu parceiro oferece suporte a esse modelo de autenticação.
• Transparência de faturamento. Como a Meta fatura a sua empresa diretamente pelo uso de tokens, confirme o que o parceiro cobra separadamente pela infraestrutura de API e o que a fatura direta da Meta cobre.
• Apoio na elegibilidade. Um parceiro deve chamar o endpoint Eligibility em nome da sua empresa e conduzir você pelas duas etapas de aceite dos Termos de Serviço.

A 360Dialog opera como infraestrutura de WhatsApp Business API, oferecendo acesso à API, onboarding de números gerenciados por BSP e habilitação de parceiros pela Partner Platform. Para detalhes de implementação passo a passo, incluindo limitações conhecidas da plataforma, veja a documentação do Meta Business Agent da 360Dialog.[9] Para detalhes sobre os preços da infraestrutura da 360Dialog, veja a página de preços.

O que você vai encontrar nesta série

Este guia cobre o Meta Business Agent de forma abrangente. Artigos relacionados aprofundam temas específicos:

• Anúncio e contexto do Meta Business Agent, com o histórico do lançamento da plataforma e o que ele significa para clientes de BSP.
• O que acontece com a sua integração via BSP quando o Meta Business Agent é ativado, incluindo o webhook standby, o Thread Control e os dois requisitos de Termos de Serviço em detalhe.
• Quem cobra você pelas mensagens do Meta Business Agent, cobrindo a forma de pagamento, o faturamento mensal e a configuração de moeda.
• Elegibilidade para o MBA: verticais excluídas, condições do número e o endpoint Eligibility.
• Como ativar o Meta Business Agent em um número gerenciado por BSP, o passo a passo específico para BSP.

O Meta Business Agent traz faturamento direto pela Meta, roteamento em standby para os apps de parceiros e cobrança por token que junta IA e entrega. Como cada um desses pontos afeta a sua integração depende da sua arquitetura atual de webhooks e da elegibilidade das verticais dos seus clientes.

Pronto para conectar seus números? Começar a usar a API.

Perguntas frequentes

Posso usar o Meta Business Agent com um número gerenciado por BSP?

Sim. O Meta Business Agent exige um número gerenciado pela Cloud API, e isso inclui explicitamente números gerenciados por um Business Solution Provider ou por Embedded Signup.[1] O BSP ou Tech Provider precisa, além disso, aceitar os Termos de Serviço de Tech Provider no Facebook Developer Portal. Tanto os Termos de Serviço do Meta Business Agent aceitos pelo cliente quanto os Termos de Serviço de Tech Provider aceitos pelo provedor precisam estar em vigor antes de qualquer chamada de API funcionar.[3]

O Meta Business Agent é gratuito?

No caminho Platform API, o Meta Business Agent não é gratuito. A Meta cobra $2,00 por 1 milhão de tokens, aproximadamente 4 a 5 centavos de dólar por mensagem, com a cobrança iniciada em 1º de agosto de 2026, via faturamento mensal com uma linha de crédito da Meta.[2] No caminho Business App, existe uma cota gratuita. Depois de atingir o limite gratuito, a empresa pode assinar um plano Meta One para manter o acesso 24/7 ao agente ou esperar a renovação do limite gratuito.

O que acontece com as automações existentes quando o Meta Business Agent é ativado?

O efeito depende do caminho do produto. No caminho Business App, ativar o Meta Business Agent pausa as automações existentes, como mensagens de ausência e palavras-chave personalizadas. O agente aprende com essas automações e as incorpora quando possível. As automações voltam a funcionar quando o agente sai da conversa.[5] No caminho Platform API, o app do parceiro passa para o status de standby. A troca de mensagens dele continua pelo webhook standby, e ele retoma o controle enviando uma mensagem para a conversa.[3]

O Meta Business Agent funciona no Messenger e no Instagram?

O Meta Business Agent está disponível no WhatsApp, no Messenger e no Instagram. O caminho Business App funciona no app WhatsApp Business, no Messenger, no Instagram Pro e no Meta Business Suite.[5] A Platform API documenta hoje a integração com o WhatsApp, embora a enumeração de canais em agent settings liste messenger e instagram ao lado de whatsapp, o que indica infraestrutura multicanal.[7] A Meta anunciou a expansão para o Instagram no lançamento de junho de 2026.[4]

Fontes

[1] Meta, “Meta Business Agent Overview,” developers.facebook.com/documentation/meta-business-agent/overview. Accessed 20 Aug 2026.

[2] Meta, “Non-Template Messages Pricing,” developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages. Accessed 20 Aug 2026.

[3] Meta, “Get Started with Meta Business Agent,” developers.facebook.com/documentation/meta-business-agent/get-started. Accessed 20 Aug 2026.

[4] Meta Newsroom, “Meta Business Agent,” about.fb.com/news/2026/06/meta-business-agent/. Published 3 Jun 2026.

[5] WhatsApp Business, “Business App AI Agent,” whatsappbusiness.com/products/business-app-ai-agent/. Accessed 20 Aug 2026.

[6] Meta, “Agent Eligibility Reference,” developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-eligibility. Accessed 20 Aug 2026.

[7] Meta, “Agent Settings Reference,” developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings. Accessed 20 Aug 2026.

[8] Meta, “Get Started for Tech Providers,” developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers. Accessed 20 Aug 2026.

[9] 360Dialog, “Meta Business Agent,” docs.360dialog.com/docs/mba/meta-business-agent. Accessed 20 Aug 2026.

[10] Meta, “Thread Control (Cloud API),” developers.facebook.com/documentation/meta-business-agent/reference/operate/thread-control-cloud-api. Accessed 25 Aug 2026.

[11] Meta, “Conversation Turns,” developers.facebook.com/documentation/meta-business-agent/reference/insights/conversation-turns. Accessed 25 Aug 2026.

[12] Meta, “Agent Eval,” developers.facebook.com/documentation/meta-business-agent/reference/operate/agent-eval. Accessed 25 Aug 2026.