# Guia do Construtor de Fluxos

O Construtor de Fluxos é o editor visual de automações do Dialogix: você desenha o atendimento arrastando blocos numa tela — mensagens, perguntas, menus com botões, decisões, ações no CRM e até um Agente de IA no meio do caminho — e publica. Todo cliente que cair na fila configurada é conduzido pelo fluxo, sem código e sem ferramenta externa.

📷 [Captura de tela aqui — canvas do Construtor de Fluxos com um fluxo montado]

## Criando e publicando

Acesse **IA & Automação → Construtor de Fluxos → novo fluxo**. O trabalho acontece em **rascunho**: você monta, ajusta e testa sem afetar ninguém. Ao clicar em **Publicar**, aquela versão vira a oficial — conversas novas usam a versão publicada, e quem já estava no meio do fluxo **termina na versão em que começou** (publicar nunca quebra conversa em andamento).

Depois, vincule o fluxo a uma **fila** (na tela da fila). Cada fila aceita **um** automatismo por vez — fluxo, agente de IA ou chatbot legado, nunca dois juntos.

## Os blocos

**Gatilhos**
- **Entrada na fila** (implícito): cliente caiu na fila → fluxo começa.
- **⚡ Gatilho: Webhook** — um sistema externo (site, ERP, gateway) dispara o fluxo chamando uma URL secreta do Dialogix. É assim que um formulário do seu site vira conversa no WhatsApp: o site envia nome+telefone, o Dialogix cria o contato e inicia o fluxo.

**Conversa**
- **Mensagem** — texto com variáveis (ex.: `{{contact.name}}`).
- **Mídia** — imagem, PDF ou áudio.
- **Pergunta** — envia uma pergunta e **espera** a resposta do cliente, guardando-a numa variável pra usar depois (em condições, mensagens ou integrações).
- **Menu** — escolha entre opções, em três formatos: texto numerado, **botões** ou **lista nativa** do WhatsApp. Cada opção segue por um caminho diferente do fluxo.
- **Espera** — pausa o fluxo pelo tempo configurado.

**Decisão**
- **Condição** — desvia o fluxo comparando variáveis (respostas, dados do contato, retorno de integrações): caminho "sim" e caminho "não".

**Ações no CRM**
- **Tag** — aplica/remove etiqueta (escolhida em lista, sem digitar errado).
- **Mover etapa** — move a oportunidade no funil.
- **Transferir** — manda pra outra fila/atendente e encerra a automação.
- **Encerrar** — fecha o ticket.

**Integrações**
- **Requisição HTTP** — chama qualquer API (seu ERP, seu sistema) e traz o retorno pra dentro do fluxo como variáveis. Suporta cabeçalhos, query e corpo, tudo com variáveis — e **credenciais seguras** via `{{secret.NOME}}` (ver capítulo *Cofre de Credenciais*).
- **Integração n8n** — dispara um workflow do n8n e usa a resposta no fluxo, pra automações avançadas.
- **Agente de IA** — 🏆 o bloco que nenhum concorrente tem: coloca um Agente de IA **dentro** do fluxo. Ex.: o menu qualifica, e quem escolhe "quero um orçamento" cai na IA com toda a inteligência dela (base de conhecimento, ferramentas, transferência).

**Fim** — encerra o fluxo (o ticket segue conforme configurado).

📷 [Captura de tela aqui — painel de configuração de um nó de Menu com botões]

## Variáveis

Tudo que o fluxo aprende vira variável: respostas de Pergunta, escolhas de Menu, retorno de HTTP/n8n, dados do contato. Use com `{{nome_da_variavel}}` em qualquer campo de texto — inclusive campos aninhados do retorno de uma API (`{{pedido.status}}`).

## Dicas

- Teste sempre com seu próprio número antes de apontar a fila real.
- Menus com **botões** convertem mais que texto numerado.
- Veja receitas completas na página **Automações — Casos de Uso** deste capítulo.