# 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:59.228Z

## Página

- Título: Criar o fluxo de retorno do MBA
- URL humana: https://agilize.app/docs/configuracao/inteligencia-artificial/meta-business-agent/fluxo-retorno-intencoes-timeout
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Ligue intenções, transbordo e prazo esgotado às ações da Agilize e saiba quando devolver a conversa à Meta.

## Seções

- Crie a entrada e conecte as saídas
- Use as variáveis capturadas
- Devolva ou conclua a conversa de propósito
- Configure o prazo de inatividade no número
- Teste a jornada completa

## Conteúdo da página

# Criar o fluxo de retorno do MBA

Com o MBA ativo, **a Meta recebe a primeira mensagem**. O fluxo da Agilize só começa quando uma intenção, um transbordo ou a regra de inatividade entrega a conversa a ele. Por isso, crie um fluxo específico para MBA e vincule-o ao número; os fluxos convencionais continuam disponíveis para números no modo **Fluxo Padrão**.

---
title: "Ida e volta entre Meta e Agilize"
caption: "Cada saída do fluxo MBA deve ter um destino claro: atender, devolver à Meta ou encerrar."
definition: |
  flowchart TD
    C[Cliente escreve] --> M[MBA responde primeiro]
    M -->|Intenção, transbordo ou timeout| E[Entrada MBA]
    E --> A{Rota configurada}
    A -->|Equipe| H[Atendimento humano]
    A -->|Resolver no fluxo| F[Ações do bot]
    F -->|Meta Business Agent| M
    F -->|Finalizar Atendimento| X[Conversa concluída]
---

## Crie a entrada e conecte as saídas

Abra :ScreenEntry{href="https://my.agilize.app/messenger/bot/flow/create" label="Criar fluxo MBA" path="sidebar lateral > módulo Mensageria > Configurações > Bots / Fluxos Automáticos > Criar"}. Preencha o nome, marque **Fluxo de retorno do Meta Business Agent** ao fim do formulário e selecione **Agente Meta deste fluxo**. Salve e abra o editor visual.

A **Entrada MBA** substitui o início convencional e oferece:

| Saída | Quando chega ao fluxo | Destino possível |
| --- | --- | --- |
| Uma saída por intenção | O agente aciona a condição cadastrada para aquela rota. | Enviar mensagem, executar ações da Agilize ou transferir a uma equipe. |
| **Erro / Transbordo** | Pedido explícito de atendimento humano sem rota específica, ou caso que o agente não conseguiu resolver. | Transferir a um departamento ou seguir um tratamento de exceção. |
| **Prazo esgotado** | A conversa ficou inativa pelo prazo configurado no número e a opção **Enviar ao fluxo MBA** está ativa. | Avisar, transferir a um departamento ou concluir, conforme o desenho do fluxo. |

Se você alterar as intenções do agente, abra a configuração da **Entrada MBA** e clique em **Atualizar saídas**. Confira cada conexão, especialmente após remover uma intenção. Uma saída sem destino não cria automaticamente atendimento humano.

## Use as variáveis capturadas

Os dados explicitamente informados pelo cliente e cadastrados como **Variáveis de saída** ficam disponíveis no fluxo depois do retorno. Você pode usá-los em uma mensagem, condição ou ação de cadastro. Monte também um caminho para quando um dado não tiver sido informado: a captura de variáveis não é garantida em toda conversa.

Exemplo: o agente registra `empresa` e recebe a intenção **proposta**. O fluxo confirma a solicitação, usa `empresa` se houver valor e transfere ao departamento comercial. Se `empresa` estiver vazia, solicita o dado antes de prosseguir.

## Devolva ou conclua a conversa de propósito

Quando uma rota da Agilize terminar e a IA deva voltar a conversar com o cliente, conecte o node **Meta Business Agent**. Ele devolve o controle ao **agente já vinculado ao número**; não há escolha de outro agente nesse node. Se uma nova intenção for acionada, o fluxo pode receber outro retorno.

Para atendimento humano, use o node de transferência adequado ao departamento. Para encerrar a sala, use **Finalizar Atendimento**. Esses destinos têm efeitos distintos: uma mensagem que apenas diz “transferi você” não transfere a conversa, e uma mensagem de despedida não equivale ao node de encerramento.

O node **Meta Business Agent** aparece nos fluxos MBA. Não use esse desenho para substituir a entrada de fluxos convencionais já existentes.

## Configure o prazo de inatividade no número

Na :ScreenEntry{href="https://my.agilize.app/messenger/meta/phone" label="edição do WhatsApp" path="sidebar lateral > módulo Mensageria > Configurações > Canais Integrados > Contas do WhatsApp > editar número"}, ajuste **Inatividade da conversa** entre **1 minuto e 5 dias** e escolha **Ao vencer o prazo**:

- **Concluir conversa**: a Agilize encerra a sala se ela ainda estiver com a IA. Não há transferência automática para uma pessoa.
- **Enviar ao fluxo MBA**: a conversa segue pela saída **Prazo esgotado**. Conecte essa saída antes de salvar a opção. Ela pode transferir ao atendimento humano ou executar outro destino que você definir.

O prazo considera a atividade mais recente da conversa. Se uma pessoa já assumiu a sala ou ela foi concluída, a regra de inatividade do MBA não deve encerrá-la. No exemplo **Prazo esgotado → Mensagem → Finalizar Atendimento**, o resultado é conclusão, não transferência a um atendente.

## Teste a jornada completa

Faça uma conversa real de teste para cada intenção e para **Erro / Transbordo**. Depois teste uma rota que termina no node **Meta Business Agent** e confirme que a próxima resposta volta a ser da IA. Para o prazo esgotado, use inicialmente um intervalo curto em um número de teste e confira se a saída escolhida tomou a ação esperada.

O [teste do agente na interface](/docs/configuracao/inteligencia-artificial/meta-business-agent/testar-acompanhar-mba) é útil para respostas, mas o repasse real ao fluxo deve ser validado em uma conversa de WhatsApp.