## Visão geral

O **Flow Builder** é o construtor visual de fluxos conversacionais da ConversaLabs. Em vez de
escrever código, você monta o diálogo conectando **nós** em um canvas: uma mensagem leva a um menu de
opções, que leva a uma condição, que pode consultar uma API e seguir caminhos diferentes conforme a
resposta do contato.

É a ferramenta certa quando a automação precisa de **várias etapas e interação** — autoatendimento
por menu, qualificação de leads, agendamento, coleta de dados e integrações — algo além do alcance de
uma regra simples.

## Pré-requisitos

- O módulo **Flow Builder** habilitado para a sua conta (recurso opcional, ativado por plano/flag). Se
  não aparecer no menu, fale com um administrador.
- Permissão de administrador para criar e publicar fluxos.
- Uma caixa de entrada (por exemplo, WhatsApp) onde o fluxo será acionado.
- Para nós que dependem de outros módulos (Pagamentos, Follow-ups, CRM, Contratos), o módulo
  correspondente precisa estar ativo.

## Passo a passo

1. Abra o **Flow Builder** e crie um novo fluxo (você pode partir de um modelo da galeria).
2. Configure o **gatilho** do fluxo (o evento que o inicia) no nó de início.
3. Arraste **nós** do painel para o canvas e conecte-os para desenhar o caminho da conversa.
4. Configure cada nó no painel lateral (texto da mensagem, opções do menu, regra da condição, URL da
   requisição, etc.).
5. Use **variáveis** para guardar e reutilizar respostas do contato e dados de integrações.
6. **Teste** o fluxo (há recursos de teste de requisição e de acompanhamento de sessão) e **publique**.

## Configurações & opções

Tipos de nó mais usados:

| Nó | Para que serve |
| --- | --- |
| Mensagem de texto | Envia um texto ao contato. |
| Menu de opções | Apresenta botões ou lista para o contato escolher. |
| Mídia | Envia imagem, vídeo, áudio ou documento. |
| Condição | Segue caminhos diferentes conforme uma regra/variável. |
| Requisição HTTP | Consulta uma API externa e usa a resposta no fluxo. |
| Variação A/B | Divide o tráfego entre caminhos para testar mensagens. |
| Pagamento | Cria/envia cobrança e aguarda o pagamento (módulo Pagamentos). |
| Follow-up | Inscreve ou cancela o contato em uma sequência (módulo Follow-ups). |
| Contrato | Envia um contrato para assinatura (módulo Contratos). |

- **Variáveis**: capture respostas e dados de API e reutilize-os em mensagens e condições.
- **Galeria de modelos**: comece de um fluxo pronto e adapte.
- **Teste e rastreamento de sessão**: valide o comportamento antes de publicar.

## Casos de uso

- **Autoatendimento por menu**: o contato escolhe um assunto e é direcionado ao time certo.
- **Qualificação de leads**: perguntas em sequência que gravam respostas em variáveis e no CRM.
- **Agendamento e cobrança**: coletar dados, criar uma cobrança e confirmar após o pagamento.
- **Integração**: consultar um pedido por uma requisição HTTP e responder o status ao cliente.

## Dicas, limites e boas práticas

- Desenhe o fluxo no papel antes de montar — mapeie os caminhos e os pontos de saída.
- Sempre ofereça uma saída para **falar com um humano**; nem tudo deve ficar no automático.
- Teste cada caminho, inclusive as respostas inesperadas do contato.
- Cuidado com loops e com mensagens em excesso (boas práticas anti-ban do WhatsApp).
- Mantenha os fluxos curtos e objetivos — divida fluxos muito grandes em partes reaproveitáveis.

## Solução de problemas

- **Não vejo o Flow Builder**: o módulo pode não estar habilitado para a conta ou para o seu perfil.
- **O fluxo não inicia**: confira o gatilho e se o fluxo está publicado e vinculado à caixa de entrada certa.
- **O fluxo parou no meio**: provavelmente há um nó sem caminho de saída para a resposta recebida —
  cubra todas as opções e adicione um caminho padrão.
- **A requisição HTTP falhou**: use o testador de requisição para checar URL, cabeçalhos e resposta.

## Veja também

- [Visão geral de Automação e Fluxos](/hc/ajuda/articles/automation-flows-overview-pt-br)
- [Regras de automação: gatilhos, condições e ações](/hc/ajuda/articles/automation-flows-regras-de-automacao-pt-br)
- [Bots e Captain (IA de atendimento)](/hc/ajuda/articles/automation-flows-bots-e-captain-pt-br)
- [Roteamento inteligente (Smart Routing)](/hc/ajuda/articles/automation-flows-smart-routing-pt-br)