Blocos do editor de fluxos
Referência dos blocos disponíveis e de como configurar cada um.
FluxosAtualizado em 02 de novembro de 2026
Blocos por grupo
| Grupo | Blocos | Uso |
|---|---|---|
| Fluxo | Retornar ao fluxo origem | Volta ao fluxo que chamou este. |
| Mensagens | Texto, Imagem, Áudio, Vídeo, Documento, Template + Botões (API oficial) | Enviar conteúdo. Fora da janela de 24 h na API Oficial, só template aprovado. |
| Perguntas | Texto, Escolha, E-mail, Número, Data | Perguntar e salvar a resposta em variável. |
| Lógica | Condição, Variável, Webhook, Pular para, Esperar, Código | Ramificar, aguardar tempo, integrar sistemas externos. |
| CRM | Tags, Mudar etapa, Responsável, Fonte, Departamento, Produtos, Campo personalizado | Atualizar o card do lead no funil. |
| Conversa | Rodízio de usuários, Criar negociação, Criar Tarefa, Ligar para Lead, Enviar notificação | Distribuir para vendedores e acionar a equipe. |
| IA | Pausar Fluxo, Remover intervenção, Agente IA (chamada única), Transferir para Agente de IA, Rodízio agentes IA, Entender intenção (IA) | Misturar fluxo e IA. |
| Enviar e-mail, Aguardar abertura/clique | Nutrição por e-mail. |
Como montar o canvas
- Arraste um bloco do painel esquerdo para o canvas.
- Ligue: puxe a bolinha de saída (embaixo do bloco) até a bolinha de entrada (em cima) do próximo.
- Clique no bloco para configurar e dê um Nome.
- Blocos com várias saídas (Escolha, Condição, Entender intenção) têm uma bolinha por resposta.
- Para excluir, use o botão vermelho no fim do painel do bloco.
Barra superior do editor
| Botão | O que faz |
|---|---|
| ← | Volta para a lista. |
| Salvamento automático | Salva cada alteração na hora. |
| Escolhe o(s) número(s). | |
| Gatilhos | Quando o fluxo dispara. |
| Horário | Horário de funcionamento. |
| Gerar IA | A IA monta o fluxo a partir de um texto. |
| Relatório | Desempenho por bloco. |
| Simular | Testa sem WhatsApp. |
| Notificações | Alertas para a equipe usados pelo bloco Enviar notificação. |
| Logs | Execuções reais, lead a lead. |
| Versões | Histórico; cada Publicar cria uma versão. |
| Publicar | Grava uma versão oficial. |
No canto inferior esquerdo do canvas ficam o zoom, o ajuste à tela e o cadeado (trava o canvas). O minimapa fica no canto inferior direito.
Mensagens
| Bloco | Campos | Observações |
|---|---|---|
| Texto | Texto; botões de variável ({{nome}}, {{telefone}}, {{numero}}, {{saudacao}}, {{pushName}}, {{remoteJid}}); A/B testing | No A/B o sistema sorteia uma variação por lead e registra qual foi enviada. |
| Imagem / Áudio / Vídeo / Documento | Upload do arquivo e legenda | O áudio é enviado como mensagem de voz. |
| Template + Botões (API oficial) | Template aprovado da lista; variáveis {{1}}, {{2}}… | Cada botão do template vira uma saída. Em conexão não oficial vira menu numerado em texto. |
Perguntas
O fluxo para e espera a resposta.
| Bloco | Campos |
|---|---|
| Texto / E-mail / Número / Data | Pergunta; Variável onde salvar; Persistir no contato; gravar em campo personalizado da negociação; Timeout de inatividade em minutos (0 = espera para sempre). E-mail, Número e Data validam o formato. |
| Escolha | Tudo acima + Opções (texto e valor); Enviar como opções interativas; Re-perguntar quando a resposta não bate e Mensagem de invalidação. Cada opção vira uma saída. |
Limites das opções interativas
Conexão v2: até 10 botões de 20 caracteres. Conexão v1: enquete com até 12 opções de 100 caracteres e pergunta de 255. A API Oficial não aceita botões fora de template — cai em menu numerado ("1, 2, 3"). Para botões reais na API Oficial, use Template + Botões.
Lógica
| Bloco | Como configurar |
|---|---|
| Condição | Variável + operador + valor, ou regras do CRM e variáveis. Verde = Verdadeiro, vermelha = Falso. |
| Variável | Nome da variável + valor (aceita {{outraVariavel}}); Persistir no contato opcional. |
| Webhook | Método (GET, POST, PUT, DELETE), URL, Headers, Body; Salvar em variáveis extrai campos do JSON de resposta; Salvar resposta inteira em cria também <nome>_status e <nome>_error. |
| Pular para | Outro bloco (mesmo fluxo) ou outro fluxo (sub-fluxo). Combine com Retornar ao fluxo origem no sub-fluxo. |
| Esperar | Segundos de pausa antes do próximo bloco. |
| Código | Script para transformar dados/variáveis quando o Webhook não basta. |
CRM e Conversa
| Bloco | Como configurar |
|---|---|
| Tags | Adicionar ou remover etiquetas. |
| Mudar etapa | Funil + etapa de destino. |
| Responsável | Atribuir, Tirar se for, Deixar vazio ou Substituir + usuário; Só atribuir se o usuário estiver online; Executar somente se (regras opcionais). |
| Fonte / Departamento / Produtos / Campo personalizado | Preenche o campo correspondente da negociação. |
| Conversa | Ações na conversa (ex.: fechar, marcar). |
| Rodízio de usuários | Distribui os leads entre os usuários escolhidos, em sequência. |
| Criar negociação | Título (aceita variáveis; vazio = nome do lead), funil de entrada, valor. Só cria se o lead ainda não tiver negociação. |
| Criar Tarefa | Título, responsável e prazo. |
| Ligar para Lead | Dispara ligação (exige Ligações configurado). |
| Enviar notificação | Escolhe uma notificação criada no painel Notificações. |
IA
| Bloco | Como configurar |
|---|---|
| Entender intenção (IA) | Variável onde gravar a intenção; texto a classificar (padrão {{input}}); intenções (id e descrição, cada uma vira uma saída); contexto adicional; intenção padrão quando não classifica. |
| Agente IA (chamada única) | A IA responde uma vez dentro do fluxo e o fluxo continua. |
| Transferir para Agente de IA | Passa a conversa para um agente. |
| Rodízio agentes IA | Distribui entre vários agentes de IA. |
| Remover intervenção | Tira a pausa de intervenção humana. |
| Pausar Fluxo | Encerra o fluxo e impede a IA de continuar respondendo. Blocos depois dele não rodam. |
Enviar e-mail exige remetente configurado no menu Email. Aguardar abertura/clique tem saídas para abriu, clicou e não abriu.