> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/guia-de-usabilidade/meta-business-agent.md). # Meta Business Agent Configure, teste e publique o agente comercial de IA da Meta no WhatsApp. O **Meta Business Agent** é um agente comercial com inteligência artificial da Meta vinculado a um número do WhatsApp Business. Nesta tela você verifica a elegibilidade, prepara o conhecimento, testa as respostas e controla a publicação do agente. > **Importante:** o recurso depende da elegibilidade do número e da conta Meta. Se a Meta ainda não tiver liberado o agente, os botões de configuração permanecerão bloqueados. ### Acessar e selecionar o número 1. No menu lateral do workspace, clique em **Meta Business Agent**. 2. Selecione a **WABA** no primeiro campo. 3. Selecione o **Número** que receberá o agente. 4. Aguarde a verificação da Meta e o carregamento das configurações. Os dados, tarefas e testes exibidos na página sempre pertencem ao número selecionado. Use **Atualizar** depois de uma alteração externa ou para consultar novamente o status. O filtro **Pendentes** mostra somente os itens que ainda precisam de atenção. ![Tela principal do Meta Business Agent com seleção de WABA e número](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/EDD3c328jI4XEtrU6Ejf/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.21.19.png?alt=media\&token=8f28e686-aace-4d89-bf38-5a611b404d5a) ### Sequência recomendada de configuração Siga as etapas abaixo na ordem. É a mesma sequência apresentada na documentação de **Recursos da API**, agora explicada para uso pelo painel. #### 1. Confirme a elegibilidade na Meta O número e a conta precisam estar elegíveis antes de qualquer configuração. A plataforma verifica essa condição ao carregar o agente. Se a Meta ainda não tiver liberado o recurso, a tela informa que o Meta Business Agent não está disponível para aquele número ou conta. Nesse caso, **Configurar**, **Adicionar**, **Gerenciar**, **Testar**, **Publicar** e **Configurações** ficam bloqueados. 1. Confirme se selecionou a WABA e o número corretos. 2. Aguarde a habilitação pela Meta. 3. Clique em **Atualizar** para verificar novamente. Quando estiver elegível, os cartões passam a mostrar as **Habilidades**, as fontes da **Base de conhecimento** e o **Agent ID**. ![Estado de elegibilidade do Meta Business Agent](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/hRWklb8c019VYNI6NtQP/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.40.52.png?alt=media\&token=4bbf2674-4a63-4726-89f3-ffddad2de954) > **Atenção:** conclua as informações obrigatórias e valide as respostas antes de publicar. Arquivos, sites, connectors e testes são opcionais, mas ajudam a tornar o agente mais confiável. #### 2. Preencha as informações da empresa Na linha **Informações da empresa**, clique em **Configurar**. 1. Descreva a empresa, os produtos ou serviços e o objetivo do atendimento. 2. Informe os meios de pagamento aceitos. 3. Explique as regras de entrega e envio. 4. Registre a política de troca e devolução. 5. Adicione informações de compra, e-mail, horário de atendimento e endereço ou canal de contato. 6. Revise os dados e clique em **Salvar**. Use somente informações confirmadas. Quando um prazo ou preço depender de consulta, explique essa condição em vez de registrar uma promessa fixa. ![Configuração das informações da empresa](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/tzvkO0FmMV65udWo9Qay/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.28.23.png?alt=media\&token=0764fed6-7da0-4c59-8d3f-c721b7808e88) #### 3. Cadastre perguntas frequentes Na linha **Perguntas frequentes**, clique em **Configurar**. 1. Escreva uma pergunta como o cliente normalmente faria. 2. Informe uma resposta completa, direta e atualizada. 3. Clique em **Salvar**. 4. Repita o processo para os demais assuntos relevantes. As FAQs cadastradas aparecem abaixo do formulário. Use o lápis para editar e a lixeira para excluir. Prefira uma pergunta por intenção: se duas perguntas precisarem de respostas diferentes, cadastre-as separadamente. ![Cadastro de perguntas frequentes](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/kW1S0O0UIb3xh9pUiT8m/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.28.43.png?alt=media\&token=54717a19-92cd-4c5c-a156-d1711c297c8c) #### 4. Defina habilidades Na linha **Habilidades**, clique em **Configurar**. As habilidades dizem ao agente como agir em situações específicas. 1. Informe um título técnico em letras minúsculas, números e hífens, como `consultar-status-pedido`. 2. Adicione uma descrição curta do objetivo. 3. Escreva instruções claras sobre como o agente deve responder ou agir. 4. Clique em **Salvar**. 5. Valide o comportamento na área de testes. Use o lápis para editar uma habilidade existente e a lixeira para removê-la. Evite instruções contraditórias entre habilidades. ![Configuração de habilidades do agente](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/R38gDA3cXMshirMOS8Ve/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.29.17.png?alt=media\&token=0bbe5798-d57f-4d64-9aea-c8e762733037) #### 5. Adicione arquivos como conhecimento Na linha **Arquivos**, clique em **Adicionar**. 1. Arraste um arquivo para a área indicada ou clique em **Selecionar arquivo**. 2. Aguarde o envio e o processamento. 3. Clique em **Salvar** para manter a alteração. São aceitos PDF, DOC, DOCX, PNG, JPG e JPEG de até **100 MB**. CSV e XLSX podem depender da habilitação do recurso. Enquanto o status estiver como **Processando**, aguarde antes de testar respostas baseadas no documento. Antes do envio, remova dados confidenciais desnecessários, confirme se o conteúdo está atualizado e evite versões duplicadas ou contraditórias. ![Adição de arquivos à base de conhecimento](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/3ZEvF899GBJPp8M2k9Kj/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.29.33.png?alt=media\&token=0e2fc8d8-6054-4c2a-8bbc-5b92e7447bdc) #### 6. Adicione sites como conhecimento Na linha **Sites**, clique em **Adicionar**. 1. Informe a URL pública da página que contém o conteúdo de referência. 2. Salve a fonte. 3. Aguarde a leitura do site pela Meta. 4. Confirme o status na lista antes de testar. Use páginas oficiais, públicas e estáveis. Atualize ou exclua uma URL quando o conteúdo mudar. Não cadastre áreas privadas, páginas temporárias ou conteúdo de terceiros sem autorização. ![Adição de sites à base de conhecimento](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/9rCW5pulo8S9XNGOno50/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.57.10.png?alt=media\&token=ad8a3f55-9358-47e0-b218-5f68070437a8) #### 7. Conecte serviços externos Na linha **Connectors**, clique em **Gerenciar**. Connectors permitem que o agente utilize serviços e APIs externas. 1. Informe o nome, a URL base e uma descrição objetiva. 2. Selecione o tipo de autenticação disponível: **NONE**, **API\_KEY** ou **OAUTH2\_CLIENT\_CREDENTIALS**. 3. Preencha as credenciais somente nos campos próprios. 4. Clique em **Salvar**. O connector aparece abaixo do formulário. Use o lápis para alterar a configuração e a lixeira para remover. Nunca coloque tokens, chaves, segredos OAuth ou certificados na descrição. Depois da configuração, a equipe técnica pode associar as ferramentas que o agente executará. ![Gerenciamento de connectors](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/pxC7hcW2Jjl02o9AmzDJ/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.58.45.png?alt=media\&token=bc33693b-17f8-432f-98ad-1c6bca3367b6) #### 8. Teste o agente Na linha **Teste seu agente**, clique em **Testar**. 1. Digite uma pergunta parecida com uma solicitação real em **Mensagem de teste**. 2. Clique em **Enviar** e aguarde a resposta. 3. Confira a conversa simulada à esquerda. 4. Analise os dados retornados pela Meta à direita. 5. Copie o **ID da conversa** para continuar o mesmo contexto em outro teste. 6. Deixe o ID vazio quando quiser iniciar uma conversa nova. O teste é uma simulação e **não envia mensagem real pelo WhatsApp**. Avalie clareza, precisão, tom de voz, uso das fontes e necessidade de encaminhamento para uma pessoa. ![Abertura do teste do agente](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/C6dy9vRXhAakr3NuMpUW/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.32.26.png?alt=media\&token=782ad81c-4372-4a62-885b-bd94421c15b4) ![Conversa simulada durante o teste](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/U2VdoQsASL3SwvY9sqMX/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.32.55.png?alt=media\&token=716483a4-5536-4bf9-846e-421efdf6425b) ![Resultado técnico retornado pela Meta](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/AywsTo6kKwsGGuv0xNJn/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.33.11.png?alt=media\&token=d8c26b77-4d01-4e89-8053-592d44e2d298) #### 9. Ajuste o rollout e o atendimento humano Clique em **Configurações** no canto superior direito. 1. Ative **Rollout do agente** somente quando o conteúdo e os testes estiverem aprovados. 2. Escolha o **Público do agente**. 3. Ative **Permitir encaminhamento para humano**, se a operação oferecer atendimento humano. 4. Escreva uma mensagem simples para informar a transferência. 5. Opcionalmente, ative o follow-up, escolha o intervalo e revise a mensagem. 6. Em **Frases que o agente nunca deve dizer**, informe uma frase por linha. 7. Clique em **Salvar**. Use **Todos** apenas depois da homologação. Para um lançamento controlado, restrinja a audiência aos contatos autorizados pela allowlist. Evite follow-ups em frequência excessiva e inclua nas frases proibidas promessas, termos ou orientações que a operação não pode utilizar. ![Configurações de rollout, handoff e follow-up](https://3723060873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces/ech0v4OAuw7OeuwoISIc/uploads/l6aSC02DlvYu53XSWoRy/Captura%20de%20Tela%202026-08-28%20a%CC%80s%2011.27.43.png?alt=media\&token=39c369c1-833a-467e-8a17-46df9b328889) ### Publicar o agente Depois de concluir a sequência: 1. confirme a WABA e o número; 2. revise os itens obrigatórios; 3. execute perguntas de teste com cenários diferentes; 4. corrija informações, FAQs ou habilidades imprecisas; 5. clique em **Publicar** na tela principal; 6. aguarde a aplicação da configuração no provedor; 7. acompanhe o comportamento inicial e mantenha uma rota de atendimento humano. > **Boa prática:** comece com uma audiência controlada, acompanhe as conversas e só amplie o rollout após validar respostas, fontes e encaminhamentos. ### Problemas comuns | Situação | O que verificar | | ---------------------------------- | ------------------------------------------------------------------ | | Botões desabilitados | Elegibilidade do número e da conta Meta. | | Conteúdo de arquivo não aparece | Status de processamento e formato do arquivo. | | Site não é utilizado nas respostas | URL pública, status da leitura e relevância da página. | | Resposta incorreta | Informações da empresa, FAQs, habilidades e fontes contraditórias. | | Teste perde o contexto | Reutilização do ID da conversa. | | Agente não atende clientes | Rollout, público configurado e publicação concluída. | Para integrações técnicas e referência de endpoints, consulte [Meta Business Agent em Recursos da API](https://docs.otima.io/whatsapp/recursos-de-api/meta-business-agent).