O que é o Flow Builder?
Onde acessar: Menu lateral > Automação > FlowBuilder
O Flow Builder e um editor visual onde você cria automações sem precisar programar. Funciona como um fluxograma: você conecta blocos (nos) que definem o que acontece quando um cliente envia uma mensagem.
Gerar Flow com IA
Onde acessar: Menu lateral > Automação > FlowBuilder > botao "Gerar com IA" (icone de estrelas na barra superior)
Descreva em linguagem natural o que você quer que o flow faca, e a IA monta a estrutura automaticamente para você.
Como usar
- Abra o Flow Builder (Automação > FlowBuilder)
- Clique em "Gerar com IA" na barra superior (icone de estrelas brilhantes)
- Descreva o flow que você precisa em português (ex: "Quero um bot que receba o cliente, pergunte o nome e telefone, e transfira para a fila de vendas")
- Ou clique em um dos exemplos prontos para preencher automaticamente
- Clique em "Gerar Fluxo" — a IA cria os nos e conexões em segundos
- O flow gerado aparece no canvas, pronto para ser editado e personalizado
- Revise, ajuste e salve normalmente
Exemplos de prompts
- "Bot de boas-vindas que pergunta o que o cliente precisa e direciona para a fila correta"
- "Qualificação de lead: coletar nome, email e interesse antes de transferir para vendas"
- "Recuperação de carrinho com cupom de desconto"
- "Pesquisa de satisfação NPS após atendimento"
- "Atendimento com IA que escala para humano se não resolver"
Dicas
- Seja específico: quanto mais detalhes, melhor o resultado (ex: "mensagem de boas-vindas, aguardar resposta, se disser 'preço' enviar tabela, senao transferir para suporte")
- Use os exemplos como ponto de partida e adapte o texto para o seu negócio
- O flow gerado e editável — você pode mover nos, alterar textos e adicionar novas condições
- Use Ctrl+Z para desfazer se quiser voltar ao canvas anterior
Como criar um Flow
- Va em Automação > FlowBuilder
- Clique em "Novo Flow"
- De um nome para o flow
- O editor visual vai abrir
- Arraste blocos do menu lateral para a area de trabalho
- Conecte os blocos entre si
- Configure cada bloco clicando nele
- Quando terminar, clique em "Salvar" e depois ative o flow (toggle verde)
Tipos de Blocos Disponíveis (26 tipos)
Trigger (Gatilho) — o ponto de partida
- Palavra-chave: Ativa quando o cliente envia uma palavra específica (ex: "preço", "oi"). Configure as palavras no painel lateral.
- Primeira mensagem: Ativa quando o cliente envia a primeira mensagem (sem histórico previo)
- Clique em botao: Ativa quando o cliente clica em um botao específico. Informe o ID do botao.
- Tag adicionada: Ativa quando uma tag e adicionada ao contato. Informe o nome da tag.
- API externa: Ativa via chamada POST /flows/{id}/trigger. Útil para integrações.
- Agendado: Ativa em horarios específicos usando expressão cron (ex: 0 9 * * 1-5 = 9h seg-sex). Plano Business+.
Mensagens
- Enviar Texto: Envia uma mensagem de texto. Suporta variáveis como {nome}, {telefone}. Tem delay humanizado (simula "digitando...").
- Enviar Imagem: Envia imagem com legenda opcional. Informe a URL da imagem.
- Enviar Áudio: Envia áudio gravado. Informe a URL do áudio.
- Enviar Vídeo: Envia vídeo com legenda opcional. Informe a URL.
- Enviar Documento: Envia PDF, planilha ou arquivo. Informe URL e nome do arquivo.
- Botoes de Resposta: Envia mensagem com até 3 botoes clicáveis. Cada botao tem limite de 20 caracteres. Pode adicionar rodape (footer).
- Lista de Opções: Menu com secoes e opções para o usuário escolher. Cada opção pode ter título e descrição.
Lógica
- Condição (Se/Senao): Verifica uma condição e segue caminhos diferentes. Campos disponíveis: última mensagem, nome, email, telefone, tag, campo personalizado. Operadores: igual, diferente, contem, começa com, termina com, maior que, menor que, vazio, não vazio.
- Aguardar: Pausa o fluxo por um tempo (segundos, minutos ou horas).
- Aguardar Resposta: Para e espera o cliente responder. Configurações: timeout em horas, acao se expirar (encerrar flow, enviar mensagem, continuar), filtro de respostas validas, salvar resposta em variável.
- Teste A/B: Divide o tráfego aleatoriamente entre caminhos. Cada caminho tem nome e peso percentual (total deve ser 100%). Plano Business+.
- Coleta de Dados: Faz multiplas perguntas em sequência com validação automática. Tipos: texto, email, telefone, número, CPF. Cada pergunta pode ter mensagem de erro personalizada para resposta invalida. Máximo de tentativas configurável.
Contato
- Adicionar Tag: Aplica uma tag ao contato (ex: "lead-quente", "vip").
- Remover Tag: Remove uma tag do contato.
- Salvar Variável: Salva um valor em uma variável do fluxo. Fonte: valor fixo, resposta do usuário, ou resposta de webhook.
- Atualizar Campo: Atualiza um campo do perfil do contato (nome, email, telefone, empresa, endereço, observações, campo personalizado).
- Criar Oportunidade: Cria um deal no pipeline CRM. Campos: título (suporta variáveis), pipeline, estágio inicial, valor em R$.
Transferências
- Transferir para Humano: Encaminha a conversa para um atendente. Configurações: mensagem antes de transferir, equipe/fila, atendente específico, prioridade (baixa/normal/alta/urgente), nota interna (so o atendente ve).
- Transferir para IA: Encaminha para um agente de IA. Configurações completas: provedor (Anthropic Claude, OpenAI GPT, Groq Llama, Custom), modelo (dropdown por provedor), prompt do sistema (persona da IA), mensagem inicial, temperatura, max tokens, incluir histórico da conversa (últimas N mensagens), base de conhecimento RAG, fallback se IA não resolver (transferir humano, encerrar, enviar mensagem).
- Mover para Equipe: Move o ticket para outra equipe de atendimento. Campos: nome da fila, mensagem antes de transferir.
Integrações
- Webhook: Chama uma URL externa com dados do contato. Configurações: URL, método (GET/POST/PUT/PATCH), autenticação (nenhuma, Bearer Token, Basic Auth, API Key), headers customizáveis (pares chave-valor), body template em JSON com variáveis {nome}, timeout, retry automático, salvar resposta em variável.
- Requisição HTTP: Faz uma requisição HTTP genérica. Mesmas opções do webhook + método DELETE + campo para salvar resposta.
Controle
- Início: Ponto de entrada do fluxo. Define o trigger (ver secao Trigger acima).
- Finalizar Fluxo: Encerra o fluxo para este contato.
- Ir para Outro Fluxo: Redireciona o contato para outro fluxo. Informe o ID do fluxo destino.
- Nota: Area de anotação visual no canvas. Não participa do fluxo. Útil para comentarios e instruções da equipe. 6 cores disponíveis.
Import e Export de Flows
Como exportar um flow
No editor: Clique em "Exportar" na barra superior. Um arquivo .json sera baixado com todos os nos, conexões e configurações do flow. Na lista de flows: Clique nos 3 pontinhos do flow > "Exportar JSON".
Como importar um flow
Na lista de flows: Clique no botao "Importar" ao lado de "Novo Flow". Selecione um arquivo .json exportado anteriormente. O flow sera criado e você sera redirecionado para o editor. No editor: Clique em "Importar" na barra superior. O canvas atual sera substituido pelo conteúdo do arquivo (você pode desfazer com Ctrl+Z).
Quando usar
- Migrar flows do ambiente de desenvolvimento para produção
- Compartilhar flows entre contas/tenants
- Fazer backup de um flow antes de editar
- Usar como template base para novos flows
Templates Prontos
Onde acessar: No editor, clique no botao "Usar Template Pronto" na barra lateral esquerda.
Templates disponíveis:
- Bot de Boas-vindas: Recebe o cliente, pergunta o que precisa e direciona para a fila correta
- Qualificação de Lead: Coleta nome e email do lead antes de transferir para vendas
- Recuperação de Carrinho: Envia lembrete automático quando o cliente abandona o carrinho, com cupom de desconto
- Pesquisa NPS: Coleta nota de satisfação e classifica como promotor ou detrator
- Atendimento com IA: Tenta resolver com IA primeiro, escala para humano se não conseguir
- Onboarding Automático: Guia o novo cliente pelos primeiros passos da plataforma
Atalhos de Teclado no Editor
- Ctrl+Z: Desfazer (até 50 ações)
- Ctrl+Y ou Ctrl+Shift+Z: Refazer
- Ctrl+D: Duplicar no selecionado
- Delete: Excluir no selecionado
- Shift+Click: Selecionar múltiplos nos
Dicas para Flows
- Comece simples: um trigger + uma mensagem já funciona
- Teste antes de ativar: use seu próprio número para testar
- Use condições para personalizar: diferentes respostas para diferentes clientes
- Sempre tenha um caminho padrão (senao) para quando nenhuma condição e atendida
- Use o delay humanizado para parecer mais natural (simula "digitando...")
- Use variáveis {nome} para personalizar as mensagens
- Exporte seus flows como backup antes de fazer grandes alterações (veja alterações não salvas)
- Use templates prontos como ponto de partida
Validação de Flows
O editor valida seu flow em tempo real. Erros aparecem em vermelho na barra superior:
- "O fluxo precisa de um no Início" — arraste o bloco Início para o canvas
- "No X não tem conexão de entrada" — conecte o no a outro bloco
- "No X precisa de uma mensagem" — clique no no e preencha o texto
- Clique no erro para ser levado diretamente ao no com problema
Limites por Plano
- Essencial (R$49,90): 3 flows
- Profissional (R$149,90): 15 flows + recuperação de carrinho
- Business (R$299,90): 50 flows + Teste A/B + Triggers Agendados
- Enterprise (R$499,90): Ilimitado
Recuperação de Carrinho Abandonado (Profissional+)
Onde acessar: Menu lateral > Automação > Carrinho Abandonado
Quando um cliente abandona um carrinho em sua loja online, o ConvertaFlow pode enviar automaticamente uma mensagem por WhatsApp para recuperar a venda.
Como configurar:
- Conecte sua plataforma de e-commerce (Menu > Integrações > E-Commerce)
- Va em Automação > Carrinho Abandonado
- Ative a recuperação
- Configure o tempo de espera (ex: 30 minutos após abandono)
- Crie a mensagem de recuperação
Dica: use o template "Recuperação de Carrinho" no Flow Builder para uma versão mais avançada com cupom de desconto.
Plataformas de E-Commerce suportadas
Shopify, Hotmart, Eduzz, WooCommerce, Kiwify, Monetizze, Nuvemshop, Mercado Livre, entre outros.
Problemas Comuns
Meu flow não esta ativando
- Verifique se o flow esta ativo (toggle verde na lista)
- Verifique se o trigger esta correto (palavra-chave exata?)
- Verifique se ha outro flow com a mesma palavra-chave (prioridade conflitante)
- Verifique se o contato já esta em outro flow ativo
Meu flow para no meio
- Verifique se o no "Aguardar Resposta" tem timeout configurado
- Verifique se todas as condições tem ambos os caminhos (Sim e Não) conectados
- Verifique se os nos de transferência estão configurados (fila/atendente existem?)
Como testar um flow
- Ative o flow
- Envie a palavra-chave de trigger pelo WhatsApp usando seu próprio número
- Acompanhe a execução em tempo real: no editor, clique em "Logs" para ver o histórico
- Use o modo Replay para visualizar o caminho que o contato percorreu