Tema
Flow Builder
Visao Geral
O Flow Builder e a ferramenta de automacao visual do Paralela. Com ele, voce cria fluxos de conversa automatizados usando um editor de arrastar e soltar, sem precisar escrever codigo.
Com o Flow Builder, voce pode:
- Automatizar respostas e saudacoes
- Direcionar clientes para filas ou atendentes
- Coletar informacoes do cliente com perguntas
- Criar menus interativos com opcoes
- Integrar com IA, webhooks e outros recursos
Acessando o Flow Builder
- No menu lateral, acesse Fluxos.
- A tela principal exibe a lista de todos os fluxos da empresa, organizada por categoria.
- Use a busca e os filtros para localizar fluxos especificos.
- Clique no nome do fluxo para abri-lo diretamente no editor.
- Use o botao de ativar/desativar em cada linha para ligar ou desligar um fluxo sem precisar abri-lo.
- Use a estrela para marcar fluxos como favoritos — eles aparecem no topo da categoria.
- Use o menu de tres pontos (⋮) de cada fluxo para acoes secundarias:
- Renomear
- Abrir em nova aba
- Versoes
- Mover para categoria
- Duplicar
- Excluir
Criando um Fluxo
- Na tela de fluxos, clique no botao de menu (tres pontos) no canto superior direito.
- Selecione Novo Fluxo.
- Preencha o nome do fluxo.
- Apos criar, clique no nome do novo fluxo para abrir o editor visual (canvas).
Voce tambem pode criar fluxos a partir de templates ou importar um fluxo em formato JSON.
O Canvas (Editor Visual)
O canvas e o editor onde voce monta o fluxo visualmente.
Como funciona
- Cada elemento do fluxo e representado por um no (bloco).
- Voce conecta os nos com linhas que definem o caminho da conversa.
- O no de Inicio e o ponto de entrada do fluxo. Todo fluxo comeca por ele.
- Clique no botao + (flutuante no canto inferior-esquerdo) para abrir o seletor de acoes.
- Arraste os nos para organizar o layout.
- Clique duas vezes em um no para editar suas configuracoes.
Seletor de Acoes
O seletor exibe todas as acoes disponiveis agrupadas por categoria, com nome e descricao visiveis:
| Categoria | Acoes |
|---|---|
| Conteudo | Conteudo, Pergunta |
| Navegacao | Menu, Randomizador, Condicao |
| Acoes | Acao, Acao Condicionada, Notificacao WhatsApp, Ativar IA |
| Controle de Fluxo | Intervalo, Espera, Encerrar |
Use o campo de busca no topo do seletor para filtrar acoes por nome ou descricao.
Atalhos de Teclado
| Atalho | Acao |
|---|---|
| Ctrl + S | Salvar fluxo |
| Ctrl + K | Abrir seletor de acoes |
| Delete / Backspace | Remover no ou conexao selecionada |
| Shift + clique | Selecao multipla |
Tipos de Nos
| No | Descricao |
|---|---|
| Inicio | Ponto de entrada do fluxo. Todo fluxo tem exatamente um. |
| Conteudo | Envia uma ou mais mensagens ao cliente (texto, imagem, audio, video, documento). |
| Menu | Apresenta opcoes numeradas para o cliente escolher. |
| Pergunta | Faz uma pergunta e armazena a resposta em uma variavel. |
| Condicao | Avalia uma ou mais condicoes e direciona o fluxo por caminhos diferentes (ver secao detalhada abaixo). |
| Acao Condicionada | Executa uma acao somente se determinada condicao for atendida. |
| Acao | Realiza operacoes como transferir fila, adicionar tag, chamar webhook ou atualizar ticket. |
| Intervalo | Adiciona um tempo de espera entre etapas (ex: aguardar 5 segundos). |
| Espera | Pausa o fluxo ate que o cliente responda ou um tempo limite seja atingido. |
| Randomizador | Distribui o fluxo aleatoriamente entre caminhos diferentes (util para testes A/B). |
| Notificacao WhatsApp | Envia uma notificacao via WhatsApp para um numero especifico. |
| Enviar Template Oficial | Dispara um template aprovado da API Oficial do WhatsApp, permitindo enviar mensagens fora da janela de 24h (ideal para campanhas). Ver secao detalhada abaixo. |
| Ativar IA | Ativa um assistente de IA (prompt) para responder ao cliente. |
| Encerrar | Finaliza o fluxo. |
Controles do Canvas
- Minimapa: visao geral do fluxo no canto inferior.
- Zoom: use os controles ou a roda do mouse para aproximar e afastar.
- Arrastar: clique e arraste o fundo para mover a area visivel.
- Salvar: o fluxo e salvo automaticamente alguns segundos apos qualquer alteracao. Um indicador ao lado do botao "Salvar Fluxo" mostra o status (Salvando, Salvo, Erro). Voce tambem pode salvar manualmente clicando no botao.
No de Conteudo
O no de Conteudo permite enviar multiplas mensagens e midias em sequencia. Ao editar o no, voce pode adicionar os seguintes tipos de conteudo:
| Tipo | Descricao |
|---|---|
| Mensagem | Texto simples com suporte a variaveis. |
| Imagem | Arquivos PNG, JPG, JPEG e similares. |
| Audio | Arquivos MP3, OGG, OPUS e similares. |
| Video | Arquivos MP4, AVI e similares. |
| Documento | Qualquer tipo de arquivo (PDF, DOCX, XLSX, CSV, TXT, etc.), exceto executaveis e scripts por questoes de seguranca. |
| Intervalo | Pausa entre envios (em segundos). |
Cada tipo de midia possui seu proprio botao de upload. Arquivos de imagem, audio e video devem ser enviados pelos respectivos botoes — o botao de Documento aceita apenas arquivos que nao sejam midia.
O tamanho maximo por arquivo e de 100MB.
Enviar Template Oficial
O no Enviar Template Oficial permite disparar um template aprovado pelo WhatsApp Business diretamente de dentro de um fluxo. E o caminho recomendado para enviar mensagens fora da janela de 24h (regra da API Oficial), especialmente em campanhas automatizadas.
Quando usar
- Campanhas em massa via API Oficial: associe um fluxo a uma campanha; o no envia o template para cada contato sem intervencao manual.
- Reativacao de leads frios: contatar quem nao interage ha mais de 24h.
- Notificacoes transacionais: confirmacoes de pedido, lembretes de agendamento, atualizacoes de status.
Pre-requisitos
- A conexao usada pelo ticket precisa ser do tipo API Oficial (
wppoficial). Conexoes WhatsApp Web nao suportam templates. - O template precisa estar APROVADO pela Meta (status APPROVED) e ativo.
- Sincronize seus templates antes de usar: pagina Templates de WhatsApp > botao Sincronizar.
Configurando o no
- Adicione o no Enviar Template Oficial ao canvas (categoria Acoes).
- Selecione a conexao (apenas conexoes da API Oficial sao listadas) — usado para listar os templates disponiveis.
- Escolha o template desejado. A pre-visualizacao mostra cabecalho, corpo, rodape e botoes.
- Para cada parametro detectado (
1,2, etc.), defina:- Texto literal: um valor fixo (ex: "Black Friday").
- Variavel do fluxo: usa o valor da variavel daquele ticket (ex:
contact_name, ou variaveis salvas em nos anteriores).
- Salve o no e conecte as duas saidas:
- Saida superior (sucesso): caminho seguido quando o template e aceito pela API.
- Saida inferior (falha): caminho seguido quando o envio falha (template rejeitado, contato sem opt-in, rate limit, conexao nao oficial, etc.).
Substituicao de variaveis
- Variaveis do contato (nome, numero, etc.) e variaveis salvas durante o fluxo podem ser usadas em qualquer parametro do template.
- A substituicao usa o mesmo motor (Mustache) das demais mensagens do fluxo.
- Se a variavel nao existir, o parametro vira string vazia — recomenda-se sempre testar com a area de sandbox.
Tratamento de falhas
Templates podem falhar por varios motivos:
- A conexao do ticket nao e API Oficial.
- Template inativo, rejeitado ou pausado pela Meta.
- Contato deu opt-out (24h block / business policy).
- Rate limit ou janela diaria atingida.
- Erro na API do WhatsApp.
Use o ramo de falha para registrar logs (webhook), enviar notificacao ao atendente, ou cair em uma mensagem alternativa via canal nao-oficial.
Limitacoes
- Componentes de header com midia (imagem/video/documento) ainda recebem apenas o tipo
text. Para midia dinamica, use webhooks que retornem URLs e configure no proprio template. - Botoes do tipo URL ou Phone nao requerem parametros via fluxo (ja sao definidos no template). Apenas botoes QUICK_REPLY aceitam payload do fluxo.
Categorias de Fluxos
Organize seus fluxos em categorias para facilitar a gestao.
- Acesse o gerenciador de categorias pelo icone de pastas no topo da tela de fluxos.
- Crie categorias com nome, cor e icone.
- Crie subcategorias (categorias filhas) para hierarquias mais detalhadas.
- Mova fluxos entre categorias.
- Reordene categorias conforme sua preferencia.
Fluxos sem categoria aparecem em uma secao separada.
Templates de Fluxo
Templates sao modelos prontos que facilitam a criacao de novos fluxos.
Usando templates
- Na tela de fluxos, clique no icone de templates no topo.
- Navegue pela galeria de templates disponiveis.
- Filtre por categoria, complexidade ou tags.
- Selecione um template para criar um novo fluxo baseado nele.
Criando seus proprios templates
- Dentro do editor de um fluxo, voce pode salvar o fluxo atual como template.
- Templates podem ser publicos (visiveis para todas as empresas) ou restritos a sua empresa.
- Reutilize seus templates para padronizar fluxos de atendimento.
Versionamento
O Flow Builder mantem um historico de versoes de cada fluxo.
| Acao | Como fazer |
|---|---|
| Ver historico | No menu de acoes do fluxo, clique em Historico de Versoes. |
| Restaurar versao | Selecione uma versao anterior e clique em restaurar. |
| Comparar versoes | Visualize as diferencas entre versoes para entender o que mudou. |
Cada vez que voce salva o fluxo, uma nova versao pode ser registrada com uma descricao da alteracao.
Listas de Frases
Listas de Frases sao conjuntos de mensagens reutilizaveis que podem ser referenciados dentro dos nos do fluxo.
- Acesse pelo menu lateral em Listas de Frases (dentro da secao de fluxos).
- Crie listas com varias mensagens alternativas.
- Ao usar uma lista em um no de conteudo, o sistema seleciona uma mensagem da lista.
- Util para variar respostas automaticas ou realizar testes A/B de mensagens.
Flow Copilot (Assistente de Fluxo)
O Flow Copilot e um assistente de inteligencia artificial que ajuda a criar e modificar fluxos.
Como usar
- Acesse o Copilot pela tela dedicada ou pelo painel dentro do editor de fluxo.
- Descreva em linguagem natural o que voce precisa. Exemplos:
- "Crie um fluxo de boas-vindas com uma mensagem e encerramento."
- "Crie um fluxo com menu de 3 opcoes: Vendas, Suporte e Financeiro."
- "Liste todos os meus fluxos disponiveis."
- O Copilot gera a estrutura do fluxo automaticamente.
- Voce pode refinar o resultado conversando com o assistente.
O Copilot tambem pode criar recursos auxiliares como filas e tags.
Campanhas de Fluxo
Fluxos podem ser usados como base para campanhas de envio em massa.
- Crie uma campanha e associe um fluxo existente.
- Selecione o grupo de contatos que recebera a campanha.
- Agende o envio para uma data e horario especificos.
- Acompanhe os resultados da campanha apos o envio.
Cada contato da campanha passara pelo fluxo de forma individual, como se fosse uma conversa normal.
Integracao com Outros Recursos
O que pode disparar um fluxo
| Origem | Descricao |
|---|---|
| Webhook | Um sistema externo envia uma requisicao que inicia o fluxo. |
| Automacoes de IA | Um assistente de IA direciona a conversa para um fluxo. |
| Automacoes do Kanban | Uma mudanca de etapa no Kanban dispara o fluxo. |
| Campanhas | Uma campanha de envio executa o fluxo para cada contato. |
O que um fluxo pode fazer
| Acao | Descricao |
|---|---|
| Enviar mensagens | Texto, imagens, audios, videos e documentos para o cliente. |
| Transferir fila | Direcionar o atendimento para uma fila especifica. |
| Gerenciar tags | Adicionar ou remover tags do contato. |
| Chamar webhooks | Enviar dados para sistemas externos via HTTP. |
| Ativar IA | Acionar um assistente de IA para continuar a conversa. |
| Enviar notificacoes | Disparar notificacoes via WhatsApp. |
| Atualizar ticket | Modificar informacoes do ticket de atendimento. |
| Salvar info do contato | Atualizar campos padrao ou customizados do contato. |
No de Condicao
O no de Condicao permite avaliar criterios sobre o contato, ticket ou conversa e direcionar o fluxo por caminhos diferentes conforme o resultado.
Tipos de condicao disponiveis
| Condicao | Descricao |
|---|---|
| Pergunta | Avalia a resposta dada a uma pergunta anterior do fluxo |
| Contato possui tag | Verifica se o contato possui ou nao determinadas tags |
| Estagio do kanban | Verifica em qual etapa do kanban o contato se encontra |
| Quantidade de tickets | Avalia a quantidade de tickets do contato |
| Status do ticket | Verifica o status do ticket atual (aberto, pendente, fechado) |
| Conexao do ticket | Verifica por qual conexao (WhatsApp) o ticket chegou |
| Numero do contato | Avalia o numero de telefone do contato |
| Horario atual | Compara a hora atual com um valor (ex: maior ou igual a 08:00) |
| Dia da semana | Verifica se o dia da semana atual e um (ou e qualquer um de) varios dias selecionados |
| Aniversario do contato | Verifica se o aniversario do contato e hoje, neste mes, nos proximos N dias (mes/dia), ou antes/depois/entre datas especificas (data completa, util para filtros por idade) |
Operadores disponiveis
Os operadores variam conforme o tipo de condicao. Os principais sao:
| Operador | Descricao |
|---|---|
| Igual a | Valor exato |
| Diferente de | Valor diferente |
| Contem | Texto contem o valor informado |
| Nao contem | Texto nao contem o valor informado |
| Comeca com | Texto comeca com o valor informado |
| Nao comeca com | Texto nao comeca com o valor informado |
| Entre | Valor numerico dentro de um intervalo |
| Maior que / Menor que | Comparacao numerica |
Para a condicao Numero do contato, os operadores disponiveis sao: Comeca com, Nao comeca com, Contem, Nao contem, Igual a e Diferente de. Isso e util para segmentar fluxos por DDD ou pais (ex: numeros que comecam com "5511").
Acao Condicionada: Salvar Informacoes do Contato
Esta acao permite atualizar os dados do contato diretamente pelo fluxo. Voce pode salvar tanto campos padrao quanto campos customizados, usando valores fixos ou variaveis coletadas durante a conversa.
Como funciona
- No canvas, adicione um no de Acao Condicionada.
- Selecione a acao Salvar informacoes do contato.
- Clique no botao + para adicionar mapeamentos de campos.
- Para cada campo, configure:
- Tipo: Campo padrao ou Campo customizado.
- Campo: Selecione qual campo sera atualizado.
- Valor: Informe um valor fixo ou use uma variavel do fluxo (ex:
).
Campos padrao disponiveis
| Campo | Descricao |
|---|---|
| Nome | Nome do contato |
| Endereco de e-mail | |
| Documento (CPF/CNPJ) | Numero de documento |
| Endereco | Endereco completo |
| Data de nascimento | Data de nascimento |
Campos customizados
Alem dos campos padrao, voce pode salvar valores em qualquer campo customizado cadastrado na sua empresa. Os campos customizados disponiveis sao carregados automaticamente ao selecionar o tipo "Campo customizado".
Para gerenciar os campos customizados disponiveis, acesse Configuracoes > Campos Customizados.
Usando variaveis
Voce pode usar variaveis coletadas durante o fluxo como valor dos campos. Por exemplo:
- Use um no de Pergunta para coletar o e-mail do cliente e armazene na variavel
email_cliente. - No no de Salvar informacoes do contato, mapeie o campo E-mail para o valor
.
O seletor de variaveis na parte inferior do formulario mostra todas as variaveis disponiveis. Clique em uma variavel para copia-la e cole no campo de valor.
Resultado da acao
| Caminho | Quando |
|---|---|
| Conexao A (sucesso) | Todos os campos foram salvos com sucesso. |
| Conexao B (falha) | Ocorreu um erro ao salvar (ex: contato nao encontrado, campo obrigatorio sem valor). |
Importacao e Exportacao
Voce pode compartilhar fluxos entre ambientes usando arquivos JSON.
| Acao | Como fazer |
|---|---|
| Exportar | No menu de acoes do fluxo, clique em Exportar JSON. Um arquivo sera baixado. |
| Importar | No menu superior da tela de fluxos, clique em Importar e selecione o arquivo JSON. |
O arquivo exportado contem todos os nos e conexoes do fluxo, permitindo recria-lo em outra conta ou ambiente.
Dicas de Uso
- Nomeie seus fluxos de forma descritiva para facilitar a busca.
- Use categorias para separar fluxos por departamento ou finalidade.
- Favorita os fluxos mais usados para acesso rapido.
- Teste o fluxo antes de ativa-lo, verificando cada caminho possivel.
- Use o versionamento para reverter alteracoes indesejadas.
- Comece com templates e adapte conforme sua necessidade.