Manual do painel · AUTOMAÇÕES

Fluxos em Automações: organizar os fluxos em pastas e desenhar o caminho da conversa nó a nó

Fluxos serve para desenhar, nó a nó, o caminho que a conversa segue quando algo acontece (uma mensagem, um aviso do sistema, um horário, uma etiqueta), com agentes de IA, condições e ações, e organizar esses fluxos em pastas.

Quando aparece: Aparece no grupo Automações quando a liberação de Fluxos e Webhooks está ligada para a conta; a conta nova já nasce com as Automações ligadas, exceto Anúncios. Também é preciso que o módulo Base de conhecimento avançada esteja ativo; sem ele, o endereço leva à página do módulo.

Quem pode usar

PapelO que vê e faz
DonoVê e edita tudo, e é o único que publica um fluxo (inclusive com avaliação falhando), volta para uma versão antiga e tira um fluxo do ar.
AdminVê a lista e o editor, cria e edita fluxos, pastas e conversas de exemplo, testa e exclui. Não publica: o diálogo avisa que só o responsável pela conta publica.
AtendenteNão vê o item no menu; quem abre o endereço direto volta para o início do painel.

Telas

Fluxos

A tela Fluxos serve para ver todos os fluxos da conta, criar um novo e organizar a lista em pastas, com busca, ordem e a coluna de agentes de IA que cada fluxo usa.

Endereço no painel: /app/automacoes/fluxos

Como chegar: Pelo menu Automações › Fluxos. O endereço antigo na Base avançada continua funcionando.

Cabeçalho

Botões e ações

Nova pasta
Abre o diálogo para criar uma pasta. Pasta só organiza a lista; não muda o que os fluxos fazem.
Novo fluxo
Abre o diálogo para dar nome e escolher o gatilho do fluxo.
  • Um quadro lembra que pastas, versões, rascunho e publicado, teste com conversa e Execuções seguem como antes.

Busca e ordem

Campos e filtros

Buscar fluxo
Filtra a lista pelo nome; dentro de uma pasta aberta, busca só nela.
Ordenar
Nome (A a Z), Mais nós ou Situação.

Botões e ações

Limpar a busca
Aparece quando a busca não acha nada e volta à lista inteira.

Pastas

A lista de pastas e a lista de fluxos de dentro de cada uma.

Botões e ações

Abrir a pasta ‹pasta›, ‹n› fluxos
Mostra só os fluxos da pasta.
Mais ações da pasta ‹pasta›
Abre o menu da pasta com Abrir, Renomear e Excluir a pasta.
Ver fluxos sem pasta, ‹n› fluxos
Mostra os fluxos que não estão em nenhuma pasta.
Todos os fluxos
Lista todos os fluxos da conta, de todas as pastas.
Todas as pastas
Dentro de uma pasta, volta para a lista de pastas.
Renomear
Troca o nome da pasta no lugar; Enter salva e Esc cancela. Nome repetido dá erro.
Excluir a pasta
Pede confirmação; os fluxos da pasta voltam para Sem pasta e nenhum fluxo é apagado.
Ver todas as pastas
Aparece numa pasta vazia, para voltar à lista.
  • Sem pasta reúne os fluxos que não estão em nenhuma pasta.
  • Arraste um fluxo até uma pasta, ou use o menu do cartão › Mover para…
  • Solte aqui para tirar da pasta: dentro de uma pasta, soltar o fluxo ali o deixa sem pasta.

Tabela de fluxos

Uma linha por fluxo; clicar na linha abre o editor.

Botões e ações

Mais ações de ‹fluxo›
Abre o menu da linha com Mover para… e Excluir fluxo.
Mover para…
Abre o diálogo para escolher a pasta de destino.
Excluir fluxo
Abre o diálogo de excluir ou arquivar o fluxo.
  • Colunas: Fluxo, Gatilho, Nós, Agentes de IA, Situação e Última execução.
  • Agentes de IA mostra os agentes que o fluxo usa; passar o mouse mostra o nome que o lead vê. Agente apagado aparece como tal.
  • Situação: Publicado com a versão, Alterações não publicadas, Rascunho ou Fora do ar.
  • Última execução: Nenhuma ainda, Hoje ou Ontem com a hora, ou a data.

Diálogo Nova pasta

Campos e filtros

Nome da pastaobrigatório
Até 40 letras e que ainda não exista, sem diferenciar maiúsculas nem acentos.

Botões e ações

Criar pasta
Cria a pasta.
Cancelar
Fecha sem criar.

Diálogo Mover para…

Para trocar a pasta pelo teclado, sem arrastar.

Campos e filtros

Pasta de destino
Sem pasta ou uma das pastas.

Botões e ações

Mover
Leva o fluxo para a pasta escolhida.
Cancelar
Fecha sem mover.

Diálogo Novo fluxo

Campos e filtros

Nome
O nome do fluxo; vazio, ele nasce como Novo fluxo.

Botões e ações

Mensagem do lead
Gatilho que roda antes do atendimento normal da IA.
Aviso do seu sistema
Gatilho que roda quando chega um webhook do sistema da empresa.
Agenda
Gatilho num horário que se repete.
Evento no atendimento
Gatilho quando o lead muda de etapa ou fica quente.
Cancelar
Fecha sem criar.
Criar e abrir o editor
Cria o fluxo e abre o editor.
  • Se o gatilho já tem um fluxo publicado, o aviso diz qual: só um vale por vez.

Estados da tela

Carregando
Blocos em esqueleto enquanto a lista carrega.
Sem nada ainda
Nenhum fluxo ainda, com o botão Criar o primeiro fluxo. Também há avisos para busca sem resultado, pasta vazia e Todos os fluxos estão numa pasta.
Se der erro
Não foi possível carregar os fluxos, com o botão de tentar de novo.
A busca não acha nada
Nenhum fluxo com o texto buscado, com o botão Limpar a busca.
A pasta aberta está vazia
O aviso de que a pasta está vazia e como mover um fluxo para ela.

Editor de fluxo

A tela Editor de fluxo serve para desenhar nó a nó o que acontece na conversa, em tela cheia: a lista de nós à esquerda, o canvas no meio e o inspetor do nó selecionado à direita, com teste, avaliações, execuções e versões.

Endereço no painel: /app/automacoes/fluxos/‹…›

Como chegar: Clique numa linha em Fluxos, ou em Criar e abrir o editor no diálogo Novo fluxo.

Barra do topo

Campos e filtros

Nome do fluxo
Editável; salva ao sair do campo ou com Enter.

Botões e ações

Voltar
Volta para a lista de fluxos.
Editor
Modo de edição no canvas.
Execuções
Modo com as conversas que passaram pelo fluxo nas últimas 24 h.
Avaliações
Modo com as conversas de exemplo que rodam a cada publicação.
Versão
Seletor de versões: escolher uma antiga pergunta se quer voltar para ela; escolher a que está no ar oferece tirá-la do ar.
Central de ajuda
Abre o guia da Base de conhecimento avançada.
PublicarDono
Abre o diálogo de publicação.
Mais ações do fluxo
Abre o menu do fluxo.
Excluir fluxo
Abre o diálogo de excluir ou arquivar; depois volta para Fluxos.
  • O caminho Fluxos › pasta › Rascunho e o número da versão (ou a versão publicada).
  • Selo Alterações não publicadas ou Publicado com a versão.

Lista de nós

Campos e filtros

Buscar componente
Busca pelo nome ou pela descrição; abre todos os grupos.
Só os novos
Mostra só os componentes com o selo Novo.

Botões e ações

Favoritar
Estrela de cada nó: põe ou tira do grupo Favoritos.
Favoritos
Grupo com os nós favoritados (só aparece com algum).
Gatilhos
Grupo: Mensagem do lead, Primeira mensagem, Mensagem com condição, Aviso do seu sistema, Agenda, Evento no atendimento e Etiqueta adicionada. O gatilho do fluxo já está no canvas.
IA
Grupo: Agente de IA, Classificar intenção, Extrair campos, Gerar resposta e Resumir.
Lógica
Grupo: Condição, Esperar, Dividir e Randomizador.
Ações
Grupo: Chamar ação, Enviar formulário (só com os Formulários no WhatsApp liberados), Vincular agente, Mensagem de texto, Mensagem de mídia, Menu de opções, Salvar variável, Requisição HTTP, Transferir conversa, Buscar conversa e Marcar no CRM.
Equipe
Grupo: Passar para a equipe e Avisar a equipe.
  • Arraste um nó para o canvas, dê dois cliques ou pressione Enter para adicionar. Cada tipo de gatilho só pode aparecer uma vez no fluxo.

Canvas

  • Os nós arrastáveis e os fios curvos com rótulo de saída (sim, não, erro, A, B, encontrou, não encontrou, sem resposta, o texto de cada opção do menu) e as contagens das últimas 24 h.
  • Ligue uma saída a outro nó puxando o fio; cada saída tem um fio só.
  • Delete ou Backspace removem o nó selecionado (o Início e o gatilho não saem).
  • No rodapé do canvas: quantos nós, quem editou e quando, e o salvo há do salvamento automático. Falha ao salvar aparece ali, e o editor tenta de novo.

Barra do canvas e teste

Campos e filtros

Mensagem do lead para o teste
O que o lead diria; Enter roda. A última mensagem fica lembrada.

Botões e ações

Enquadrar
Ajusta o zoom para caber o fluxo inteiro.
Aproximar
Aumenta o zoom.
Afastar
Diminui o zoom.
Desfazer
Desfaz a última mudança no canvas.
Testar com uma conversa
Abre a caixa do teste; durante o teste, vira Rodando a conversa de teste…
Rodar o teste
Roda o rascunho em simulação: cada nó acende por onde passou e, no fim, um aviso resume nós, tempo e resposta. Nada é enviado, gravado ou cobrado.
Cancelar
Fecha a caixa do teste.

Inspetor do nó: todos os nós

Abre ao selecionar um nó; os campos mudam com o tipo.

Campos e filtros

Título do nó
O nome do nó no canvas.
Linha do canvas
A descrição curta que aparece no nó.

Botões e ações

Fechar
Fecha o inspetor.
Excluir nó
Remove o nó e os fios dele (não aparece no Início nem no gatilho).
  • Modelo: nos nós de IA, a IA da conta ou, no plano com IA própria, o modelo da empresa.
  • Últimas 24 h: as entradas no nó e, na Condição, quantos foram para sim e para não.
  • Aviso com o que falta para publicar.
  • Num fluxo com mensagem livre, o aviso de que fora da janela de 24 horas do WhatsApp a mensagem livre não sai: use um modelo aprovado pela Meta.

Inspetor: gatilhos

Campos e filtros

Evento do seu sistema
Aviso do seu sistema: o evento nomeado na tela Webhooks.
Dias
Agenda: os dias da semana.
Hora (no fuso da conta)
Agenda: a hora.
Para os leads da etiqueta
Agenda: quem recebe.
Quando
Evento no atendimento: O lead mudou de etapa no Funil ou O lead ficou quente.
Canais
Primeira mensagem: WhatsApp, Instagram Direct ou Web chat; escolha pelo menos um.
Conta como primeira se não fala há
Primeira mensagem: depois de quantos dias sem conversa o contato volta a contar como primeiro contato.
A mensagem
Mensagem com condição: contém, é igual a ou começa com.
Palavras (separe por vírgula)
Mensagem com condição: as palavras buscadas; não diferencia maiúsculas nem acentos.
Etiqueta
Etiqueta adicionada: a etiqueta que dispara o fluxo. A etiqueta que o próprio fluxo põe não dispara, para um fluxo não acordar o outro sem parar.

Botões e ações

Trocar gatilho
Troca o tipo do gatilho no lugar; o fio de saída continua ligado. Num fluxo publicado, o gatilho novo só vale ao publicar.

Inspetor: nós de IA

Campos e filtros

Qual agente conversa aqui
Agente de IA: escolhe um dos agentes da conta, com a situação dele. Agente apagado pede escolher outro; agente não publicado avisa que a conversa seguiria sem ele.
Devolve ao fluxo quando
Agente de IA: o agente devolve a conversa quando cumpre o objetivo, quando transfere para a equipe ou depois de um número de mensagens.
Instrução só deste ponto (opcional)
Agente de IA: soma às instruções do agente só neste fluxo.
Intenções
Classificar intenção: as intenções possíveis (Enter acrescenta); abaixo da confiança vira outro.
Confiança mínima
Classificar e Extrair: o limite de confiança da IA.
Campos
Extrair campos: cada campo, o formato e se é obrigatório.
Se faltar, a IA pergunta
Extrair campos: a pergunta ao lead quando falta um dado; o fluxo espera a resposta.
Instrução
Gerar resposta: o que a resposta deve dizer; usa a persona e os fatos aprovados.
Para quem
Resumir: a equipe (vai com o transbordo) ou o CRM (anotação na ficha).
  • O nó Agente de IA usa as ferramentas e o modelo do agente; o consumo aparece no Uso dele. O canal é o da conversa.

Inspetor: nós de lógica

Campos e filtros

Condição
As regras sobre intenção, confiança, campos extraídos, resposta da ação, aviso do sistema e lead; saídas sim e não.
Combinar
Com mais de uma regra: todas valem (e) ou qualquer uma vale (ou).
Esperar por
Um tempo ou só a resposta do lead.
ou a resposta do lead, o que vier primeiro
Esperar: segue quando o lead responde, mesmo antes do tempo.
Caminho A recebe
Dividir: o percentual do caminho A; o mesmo lead cai sempre no mesmo lado.
Modo
Randomizador: Aleatório (cada lead cai num caminho conforme o peso) ou Em sequência (rodízio A, B, C, A…).
Nome do caminho
Randomizador: o nome de cada caminho, que vira o rótulo da saída.
Peso
Randomizador: o peso de cada caminho; no modo Aleatório os pesos precisam somar 100%.

Botões e ações

Regra
Na Condição, acrescenta uma regra.
Tirar esta regra
Na Condição, remove a regra.

Inspetor: nós de ação

Campos e filtros

Ação
Chamar ação: uma ação publicada; se o sistema não responder ou a consulta não puder rodar, segue pelo fio erro.
Formulário
Enviar formulário: o formulário publicado a enviar.
Agente
Vincular agente: o agente que atende a conversa daqui em diante. Diferente do nó Agente de IA, que conversa só naquele ponto do fluxo e devolve.
Texto
Mensagem de texto: texto fixo, com variáveis.
Tipo
Mensagem de mídia: Imagem, Áudio, Vídeo ou Documento, cada um com seu limite de tamanho.
Endereço do arquivo
Mensagem de mídia: endereço com https://, com variável se quiser.
Legenda (opcional)
Mensagem de mídia: a legenda. O WhatsApp não mostra legenda no áudio.
Formato
Menu de opções: Botões (até 3) ou Lista (até 10).
Pergunta
Menu de opções: o texto que o lead lê.
Opções (cada uma vira uma saída)
Menu de opções: até 20 letras por botão e 24 por item da lista; cada opção vira uma saída.
Esperar a resposta por
Menu de opções: quanto tempo espera; sem resposta segue pela saída sem resposta.
Unidade
Menu de opções: minutos ou horas.
Nome
Salvar variável: letras minúsculas, números e _, começando por letra.
Valor
Salvar variável: texto fixo ou outra variável. Em Buscar conversa, o número ou a variável com o telefone.
Guardar
Salvar variável: Só nesta conversa ou No contato, para as próximas.
Endereço
Requisição HTTP: o endereço completo com https://.
Método
Requisição HTTP: o método da chamada.
Cabeçalhos
Requisição HTTP: nome e valor de cada cabeçalho. Segredos vêm do cofre de segredos e o valor nunca aparece na tela.
Corpo (JSON, com variáveis)
Requisição HTTP: o corpo enviado.
Guardar da resposta
Requisição HTTP: o campo da resposta e a variável em que ele fica guardado.
Para
Transferir conversa: Outra fila da equipe ou Outro agente de IA.
Destino
Transferir conversa: a fila ou o agente de destino.
Levar o resumo da conversa
Transferir conversa: leva o resumo para quem recebe.
Buscar por
Buscar conversa: o dado que identifica o contato, como o Telefone.
Guardar em
Buscar conversa: a variável em que fica a conversa encontrada; saídas encontrou e não encontrou.
O que fazer
Marcar no CRM: Pôr a etiqueta, Tirar a etiqueta ou Mover para a etapa.

Botões e ações

Abrir a ação
Em Chamar ação, abre o editor da ação escolhida.
Testar só este nó
Em Chamar ação, abre o teste da ação.
Testar com um pedido de exemplo
Em Requisição HTTP, faz uma chamada de teste e mostra o resultado e o tempo.
  • Mensagem de mídia: imagem até 5 MB (JPG, PNG), áudio até 16 MB (MP3, OGG, AAC), vídeo até 16 MB (MP4) e documento até 100 MB (PDF).
  • Menu de opções: a Meta aceita até 3 botões; para mais opções, use Lista. Há uma prévia no WhatsApp, e se o lead escrever em vez de tocar a IA entende qual opção ele quis.
  • Requisição HTTP: duas saídas, sucesso (2xx) e erro ou sem resposta em 10 s.
  • Transferir conversa: Passar para a equipe continua sendo o transbordo comum, com o nome do atendente.

Inspetor: nós da equipe

Campos e filtros

Fila
Passar para a equipe: a fila; leva o resumo e os campos, e o lead vê o nome do atendente.
Aviso no sino
Avisar a equipe: a mensagem no sino, sem tirar a conversa da IA.

Modo Execuções

Botões e ações

Todas
Mostra todas as conversas das últimas 24 h.
Com erro
Só as que terminaram com erro.
  • Cada conversa com o lead, o desfecho, o caminho nó a nó e a duração; clicar volta ao editor com o caminho aceso no canvas.

Modo Avaliações

Campos e filtros

Nome curtoobrigatório
O nome da conversa de exemplo.
Conversa de exemploobrigatório
O que o lead diz.
Esperado (na ordem)obrigatório
Os passos que o fluxo tem de fazer, nesta ordem; pode fazer outros no meio. Extrair campos só conta quando o fluxo pergunta ao lead o que faltou.

Botões e ações

Conversa de exemplo
Abre o diálogo de nova conversa de exemplo.
Rodar de novo
Roda todas as avaliações; cada resultado aparece ao terminar.
Editar
Edita a conversa de exemplo.
Excluir ‹nome›
Pergunta e apaga de vez a conversa de exemplo.
Salvar
Salva a conversa de exemplo.
Excluir
Confirma a exclusão da conversa de exemplo.
  • Tabela: Conversa de exemplo, Esperado, Obtido e Resultado (passou, falhou ou ainda não rodou). Uma falha bloqueia o botão Publicar.

Diálogos de publicação e de versão

Campos e filtros

Código de verificação
Quando o fluxo chama uma ação que grava.

Botões e ações

PublicarDono
Publica a versão; a IA usa a partir da próxima mensagem.
Publicar assim mesmoDono
Com avaliação falhando, publica e fica registrado.
Corrigir antes
Fecha para corrigir (com avaliação falhando).
Tirar do arDono
Na versão em uso, tira o fluxo do ar e libera o gatilho para outro fluxo.
Voltar para estaDono
A versão antiga vira a próxima, publicada agora, e substitui o rascunho.
  • O diálogo roda as avaliações ao abrir e mostra o que mudou.
  • Se o gatilho já tem outro fluxo publicado, avisa qual: tire aquele do ar para publicar este.

Estados da tela

Carregando
Esqueletos do topo e do canvas.
Sem nada ainda
Execuções: Nenhuma conversa passou por aqui ainda. Avaliações: Nenhuma conversa de exemplo.
Se der erro
Não foi possível abrir este fluxo (pode ter sido excluído ou a conexão caiu). Falha ao salvar aparece no rodapé do canvas, que tenta de novo.
No celular
O aviso Para editar, use o computador. Dá para ver o fluxo, as execuções e testar com uma conversa.
Fluxo em uso por outro gatilho publicado
O diálogo de publicação diz qual fluxo já usa o gatilho; só um vale por vez.

Passo a passo

Como criar um fluxo

  1. Em Automações › Fluxos, clique em Novo fluxo.
  2. Dê um nome e escolha o gatilho: Mensagem do lead, Aviso do seu sistema, Agenda ou Evento no atendimento.
  3. Clique em Criar e abrir o editor.
  4. Arraste os nós da lista para o canvas e ligue as saídas puxando o fio.
  5. Teste com Testar com uma conversa e, quando estiver bom, o dono clica em Publicar.

Como organizar os fluxos em pastas

  1. Clique em Nova pasta, escreva o nome (até 40 letras) e clique em Criar pasta.
  2. Arraste a linha do fluxo até a pasta, ou abra o menu da linha e escolha Mover para… e depois Mover.
  3. Para renomear ou excluir a pasta, abra Mais ações da pasta; os fluxos de uma pasta excluída voltam para Sem pasta.

Como pôr um agente de IA para conversar num ponto do fluxo

  1. Na lista de nós, no grupo IA, arraste Agente de IA para o canvas.
  2. Em Qual agente conversa aqui, escolha o agente (ele precisa estar publicado).
  3. Em Devolve ao fluxo quando, escolha o objetivo cumprido, a transferência para a equipe ou um número de mensagens.
  4. Ligue as saídas do nó aos próximos passos.

Como testar um fluxo antes de publicar

  1. No editor, clique em Testar com uma conversa.
  2. Escreva a Mensagem do lead para o teste e clique em Rodar o teste.
  3. Veja por onde os nós acenderam e leia o aviso com o resumo. Nada é enviado, gravado ou cobrado.
  4. Em Avaliações, cadastre conversas de exemplo; elas rodam a cada publicação.

Como voltar para uma versão antiga ou tirar o fluxo do ar

  1. No seletor Versão, escolha a versão antiga e confirme em Voltar para esta; ela vira a próxima versão, publicada agora.
  2. Para tirar o fluxo do ar, escolha no seletor a versão que está no ar e use Tirar do ar; o gatilho fica livre para outro fluxo.
  3. Só o responsável pela conta faz as duas coisas.

Perguntas frequentes

Posso ter dois fluxos com o mesmo gatilho no ar?

Não. Só um fluxo publicado vale por gatilho. O diálogo de publicação diz qual fluxo já usa o gatilho; tire aquele do ar para publicar o outro.

Excluir uma pasta apaga os fluxos?

Não. Os fluxos voltam para Sem pasta e continuam publicados como antes.

O teste com conversa envia mensagem de verdade?

Não. É uma simulação: nada é enviado, gravado ou cobrado.

Qual a diferença entre o nó Agente de IA e o Vincular agente?

O Agente de IA conversa só naquele ponto do fluxo e devolve a conversa. O Vincular agente faz um agente atender a conversa daqui em diante.

Quem pode publicar um fluxo?

Só o responsável pela conta. O administrador cria, edita e testa, mas o diálogo avisa que a publicação é do dono.

Posso editar um fluxo pelo celular?

Não. No celular dá para ver o fluxo, as execuções e testar com uma conversa; para editar, use o computador.