# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-10-02T05:13:58.225Z ## Página - Título: Ativar o Meta Business Agent em um WhatsApp - URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/meta-business-agent/ativar-mba-whatsapp - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Aceite os termos no WhatsApp Manager, vincule agente e fluxo, prepare o número e ative as respostas da Meta. ## Seções - Antes de começar: aceite os termos na Meta - Cadastre o agente e o fluxo - Vincule e prepare o número - Reutilize sem duplicar - Se a preparação ou a ativação falhar ## Conteúdo da página # Ativar o Meta Business Agent em um WhatsApp Use este guia para habilitar o MBA em um número já [integrado pela Meta](/docs/configuracao/canais-whatsapp-integracoes/integrar-whatsapp-meta). O agente é cadastrado na Agilize independentemente do número: um mesmo cadastro pode atender vários WhatsApps, mas cada número tem sua própria preparação, publicação, ativação e fluxo de retorno. ## Antes de começar: aceite os termos na Meta Entre no [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) com acesso administrativo, selecione a **conta do WhatsApp Business** correta e abra **Meta Business Agent**. Escolha o número desejado, inicie a configuração e **aceite os Termos de Serviço do Meta Business Agent** ali. Essa aceitação é feita na Meta, para o número que você pretende configurar; não existe um aceite equivalente no cadastro da Agilize. A [orientação oficial da Meta](https://developers.facebook.com/documentation/meta-business-agent/get-started) coloca essa etapa antes da ativação do agente. Se a aba do MBA não aparecer no WhatsApp Manager, a Meta informa que ela só é exibida quando há pelo menos um número elegível na conta selecionada. Confira a conta e o número antes de prosseguir. Na Agilize, a ação **Verificar elegibilidade** ajuda a confirmar a resposta da Meta para o número. Para ativar respostas para **Todos os clientes**, configure também um método de pagamento na Meta. Para uma validação inicial, a opção **Somente contatos de teste** pode ser usada sem esse método, conforme as [regras de ativação da Meta](https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings). ## Cadastre o agente e o fluxo Abra :ScreenEntry{href="https://my.agilize.app/messenger/meta/mba/agent/create" label="Criar agente Meta" path="sidebar lateral > módulo Mensageria > Configurações > Agentes de IA > Meta Business Agent (MBA) > Agentes Meta > Criar"}. Defina nome, prompt, intenções e variáveis; depois complemente o conhecimento. O guia [Configurar o agente e o conhecimento](/docs/configuracao/inteligencia-artificial/meta-business-agent/configurar-agente-conhecimento) mostra como fazer isso sem provocar transferências prematuras. Crie um :ScreenEntry{href="https://my.agilize.app/messenger/bot/flow/create" label="Criar fluxo de retorno" path="sidebar lateral > módulo Mensageria > Configurações > Bots / Fluxos Automáticos > Criar"} e marque **Fluxo de retorno do Meta Business Agent**. Selecione o agente desse fluxo e conecte as saídas que deverão receber intenções, erros, transbordos e inatividade. Esse fluxo é diferente de um fluxo convencional: [veja como montar as rotas](/docs/configuracao/inteligencia-artificial/meta-business-agent/fluxo-retorno-intencoes-timeout). ## Vincule e prepare o número 1. Acesse :ScreenEntry{href="https://my.agilize.app/messenger/meta/phone" label="Contas do WhatsApp" path="sidebar lateral > módulo Mensageria > Configurações > Canais Integrados > Contas do WhatsApp"} e abra a **edição** do número. 2. Em **Atendimento inicial**, selecione **Meta Business Agent**. Enquanto esse modo estiver selecionado, o campo de fluxo convencional não é usado como entrada inicial. 3. Em **Agente**, selecione o cadastro desejado. Em **Fluxo de retorno**, vincule um fluxo MBA do mesmo agente. 4. Clique em **Preparar na Meta**. Se a configuração já existir na Meta, a Agilize pode sincronizá-la. 5. Clique em **Publicar alterações** para enviar prompt, conhecimento e rotas desse agente ao número. 6. Use **Testar agente** e faça também uma conversa real de teste antes da liberação geral. 7. Clique em **Ativar respostas** e escolha **Somente contatos de teste** ou **Todos os clientes**. Preparar e publicar não são a mesma coisa que ativar respostas. O teste na interface pode ficar disponível após preparação e publicação, mesmo com as respostas ainda desativadas para clientes. ## Reutilize sem duplicar Você pode selecionar o mesmo agente em outro número integrado. Depois, vincule um fluxo de retorno, prepare e publique a configuração **nesse segundo número**. Editar o cadastro compartilhado não publica automaticamente as mudanças nos números já vinculados: use **Publicar alterações** em cada um ou **Publicar nos números vinculados** na visualização do agente. Confira o resultado de cada publicação. Para interromper as respostas do MBA em um número, use **Desativar respostas neste número**. Se também quiser que a conversa volte a começar pelo bot convencional, selecione **Fluxo Padrão** em **Atendimento inicial** e configure o fluxo de atendimento. Essa escolha não apaga o cadastro compartilhado do agente. ## Se a preparação ou a ativação falhar | O que aparece | O que conferir | | --- | --- | | Número não elegível | Conta do WhatsApp e número escolhidos no WhatsApp Manager; resultado de **Verificar elegibilidade** na Agilize. | | Meta recusa a preparação | Termos do MBA aceitos no WhatsApp Manager para o número correto e permissões da integração. | | Meta recusa **Todos os clientes** | Método de pagamento do MBA na Meta. Teste antes com **Somente contatos de teste**. | | Agente preparado, mas não responde | Confirme publicação, público escolhido, ativação das respostas e contatos de teste, quando aplicável. | Depois da ativação, consulte [como testar e acompanhar o MBA](/docs/configuracao/inteligencia-artificial/meta-business-agent/testar-acompanhar-mba).