Blocos do fluxo: o que cada um faz
Como um fluxo é montado (início, ligações, variáveis, saída de erro) e o que faz cada bloco da lista, de mensagens a IA, pipeline e integrações.
Um fluxo é uma sequência de blocos ligados por linhas. Cada bloco faz uma coisa (mandar uma mensagem, esperar, mover um negócio…) e passa para o próximo. Esta página explica como o editor funciona e o que faz cada bloco.
Onde fica: menu Fluxos › Novo fluxo (ou abra um fluxo da lista). Os blocos ficam na lista à esquerda do quadro.
Como um fluxo funciona#
- Início: todo fluxo começa nele. Se o fluxo recebe informações de quem o chama (outro fluxo, uma ação da IA, uma integração), elas são as entradas do Início.
- Adicionar um bloco: clique no bloco na lista da esquerda: ele entra depois do último bloco. A janela de configuração abre; preencha e clique em Salvar. Use Buscar bloco… para achar pelo nome.
- Ligações: a linha entre dois blocos define a ordem. Arraste da bolinha de um bloco até o outro para ligar.
- Variáveis: nos campos de texto, o botão { } abre Inserir variável, com abas como Contato, Conversa, Negócio, Conta, Entradas e Bloco. A aba Bloco traz o que os blocos anteriores devolveram (por exemplo, o resumo do Extrair com IA).
- Saída de erro: ligue esse interruptor no bloco para o fluxo seguir por outro caminho quando aquele bloco falhar (por exemplo, avisar a equipe). Desligado, uma falha encerra a execução.
- Salvar: clique em Salvar, no alto. Se faltar algo, a lista de blocos mostra as pendências embaixo, e o fluxo não salva até você corrigir.
Quando um bloco precisa de uma conversa (por exemplo, Enviar mensagem na conversa do fluxo), ele usa a conversa que chamou o fluxo ou, se o fluxo não veio de uma conversa, a do contato com atividade mais recente.
Estrutura do fluxo#
Blocos que organizam o caminho. Ficam no topo da lista.
| Bloco | O que faz |
|---|---|
| Início | Começo do fluxo. Define as entradas que ele recebe. |
| Comentário | Um bilhete no quadro para explicar uma parte do fluxo. Não executa nada. |
| Condição | Compara valores (número, texto, sim/não, vazio) em regras, na ordem. A primeira regra que bater escolhe o caminho; se nenhuma bater, segue pela saída padrão. |
| Teste A/B | Sorteia um caminho de acordo com os pesos (ex.: 50% / 50%), para comparar duas mensagens. Pode gravar o caminho sorteado numa variável do contato. |
| Delay | Espera um tempo (segundos, minutos, horas ou dias) e continua. Veja abaixo quando ele cancela. |
| Extrair com IA | A IA lê um texto (por padrão, as últimas mensagens da conversa) e devolve os campos que você definir: um resumo, o interesse do cliente, uma classificação. Usa créditos de IA. |
| Adicionar nota | Escreve uma nota interna na conversa, no contato ou nos dois. O cliente não recebe nada. |
| Enviar notificação | Avisa a equipe pela plataforma (aba Notificações e aviso no navegador) as pessoas ligadas à conversa. |
| Chamar fluxo | Executa outro fluxo. Aguardar retorno usa o que ele devolve; Executar em segundo plano segue sem esperar. |
| Retornar dados | Encerra o fluxo devolvendo valores para quem o chamou (outro fluxo ou a IA, quando o fluxo é uma ação dela). |
| JSON | Monta um JSON a partir de campos ou lê um JSON recebido e separa os campos. Útil com Requisição HTTP. |
| Código Lua | Bloco avançado: roda um código em Lua e devolve valores para os blocos seguintes. |
Quando o Delay cancela o resto#
Em Cancelar o restante do fluxo se… você escolhe o que interrompe a espera:
| Opção | Cancela quando |
|---|---|
| Qualquer ação na conversa (padrão) | O cliente, alguém da equipe ou a IA manda mensagem antes do tempo |
| Apenas mensagens enviadas pela plataforma | A IA ou alguém da equipe responde. Mensagem do cliente não cancela |
| Mensagem do lead ou de um atendente humano | O cliente responde ou alguém da equipe manda mensagem. Mensagens da IA não cancelam |
| Nunca cancelar (só vence pelo tempo) | Nunca: o resto sempre roda quando o tempo vence |
Mensagem#
| Bloco | O que faz |
|---|---|
| Enviar mensagem | Envia uma ou mais mensagens (texto, áudio, imagem, vídeo ou documento), com intervalo opcional entre elas, na conversa do fluxo, por uma conexão escolhida ou para um telefone avulso. No WhatsApp, mensagem livre só vale até 24 horas depois da última mensagem do cliente; fora disso, use template. |
| Enviar template WhatsApp | Envia um modelo aprovado pela Meta. Aparece quando a conta tem WhatsApp Oficial conectado. |
| Enviar e-mail | Envia um e-mail de texto pelo e-mail da sua empresa. Aparece quando há um e-mail conectado em Integrações › E-mail. |
| Instagram - Responder comentário e Direct | Responde a um comentário num post e/ou manda mensagem direta para quem comentou. Use com o gatilho Comentário em post (Instagram). Aparece quando há Instagram conectado. |
Agentes IA#
| Bloco | O que faz |
|---|---|
| Pausar IA | A IA para de responder nesta conversa até ser reativada. |
| Ativar IA em modo espera | Reativa a IA na conversa: ela volta a responder quando o cliente escrever. |
| Ativar IA com input | Reativa a IA e pede para ela responder na hora, seguindo uma orientação que você escreve (opcional). |
| Adicionar sussurro para a IA | Deixa uma mensagem interna que só a IA lê, para dar contexto (ex.: os dados com que o lead chegou). |
| Gerar resposta com Agente IA | Usa um agente da conta para escrever um texto, sem enviar nada nem mexer na conversa. O texto fica disponível para os blocos seguintes. |
| Bloquear/Liberar follow-up da IA | Impede (ou volta a permitir) que a IA mande mensagens de retomada nesta conversa. |
| Selecionar skills da IA | Escolhe quais skills a IA pode usar nesta conversa daqui para frente. |
Pipeline#
| Bloco | O que faz |
|---|---|
| Criar negócio | Cria um negócio na pipeline e etapa escolhidas (sem etapa, na primeira). Sem atendente nem fila, a primeira fila de distribuição escolhe o responsável. |
| Mover negócio | Leva o negócio para a pipeline e a etapa escolhidas. |
| Marcar negócio como perdido | Marca o negócio como perdido, com o motivo. |
Atribuição#
| Bloco | O que faz |
|---|---|
| Distribuir contato | Aplica uma política de distribuição publicada: ela decide fila ou responsável (e cria o negócio, se a regra pedir). Veja Distribuição. |
| Atribuir atendente | Define quem atende a conversa: uma fila com aceite automático escolhe, ou você indica a pessoa. |
Contato#
| Bloco | O que faz |
|---|---|
| Definir variável do contato | Grava um valor num campo personalizado ou no cadastro (Nome, E-mail, Telefone). |
| Adicionar etiqueta no contato / Remover etiqueta do contato | Coloca ou tira etiquetas, sem mexer nas outras. |
| Adicionar origem ao contato | Registra mais uma origem (de onde o contato veio), que entra nos relatórios. |
| Atualizar contato com a observadora | A IA relê o histórico do contato e atualiza o que ela acompanha dele. Usa créditos de IA. |
| Buscar imóvel | Busca um imóvel pelo código. Só no módulo de imóveis. |
| Definir imóvel de interesse principal | Marca um imóvel como o interesse principal do contato. Só no módulo de imóveis. |
Conversa#
| Bloco | O que faz |
|---|---|
| Mudar status da conversa | Finaliza a conversa ou reabre como Atendendo, Novo ou Não respondido. |
| Reportar status no relatório | Registra um resultado da conversa nos relatórios (ex.: Qualificado, Sem Resposta). |
Agenda#
| Bloco | O que faz |
|---|---|
| Criar atividade | Cria uma tarefa ou compromisso para o contato, com lembrete opcional. Ao ser concluída, pode executar um fluxo ou mover o negócio de etapa. |
Integração#
| Bloco | O que faz |
|---|---|
| Requisição HTTP | Chama um sistema externo (ex.: o seu ERP) e recebe a resposta para usar nos blocos seguintes. |
| Meta Ads - CAPI | Envia um evento de conversão para o Meta Ads, para medir e melhorar os anúncios. Só administradores configuram. |
Observação
A lista muda conforme a conta: blocos de WhatsApp Oficial, e-mail e Instagram só aparecem com a conexão ativa, e os de imóvel só com o módulo de imóveis. Um fluxo que já usa um desses blocos continua abrindo e funcionando para edição.
Dúvidas comuns#
Qual a diferença entre “Adicionar nota” e “Adicionar sussurro para a IA”?
A nota é para a equipe ler. O sussurro é para a IA ler e usar como contexto. O cliente não vê nenhum dos dois.
Como faço o fluxo esperar uma resposta do cliente?
Use um Delay com o tempo de espera e a opção Qualquer ação na conversa (ou Mensagem do lead ou de um atendente humano): se o cliente responder antes, o resto do fluxo é cancelado; se não responder, o fluxo segue, por exemplo, com um lembrete.