Builder · Atualizado em 06/10/2026
Como criar um fluxo no Builder do Pipe
Crie um fluxo, monte os blocos no Builder, ligue os caminhos, teste e publique para automatizar o início das conversas.
Um fluxo é o roteiro automático que o Pipe segue quando um contato escreve: ele decide o que responder, o que perguntar e quando passar a conversa para uma pessoa. O Builder é a tela em que você desenha esse roteiro com blocos e setas.
Quando usar
Crie um fluxo quando quiser que o Pipe atenda o início da conversa sozinho, por exemplo para dar boas-vindas, perguntar o assunto e só então chamar um atendente. Se a sua operação só precisa de atendentes respondendo no Desk, ainda assim vale ter um fluxo mínimo, porque é ele que encaminha a conversa para a fila de atendimento.
Pré-requisitos
- Acesso ao portal de gestão e a permissão de criar fluxos. Sem ela, a criação não fica disponível para você.
- Para editar o desenho de um fluxo existente, a permissão de editar o Builder naquele fluxo.
- Para publicar, a permissão de publicar fluxo, que é concedida na conta e não por fluxo.
- Uma ideia simples do caminho: primeira mensagem, o que o contato pode responder e para onde cada resposta leva.
Passo a passo
- No portal, inicie a criação de um fluxo. A tela Escolha como começar seu fluxo oferece duas opções: Usar template, marcada como Ideal para começar, e Construir do zero.
- Se escolher Usar template, leia a apresentação Modelo de fluxo pré-configurado e clique em Escolher esse template. Se escolher Construir do zero, você vai direto para a tela do nome.
- No campo Nome do fluxo, digite um nome de 2 a 30 caracteres. O nome não pode começar com número nem com caractere especial.
- Confirme a criação. Se o Pipe responder que houve um erro e pedir outro nome, tente um nome diferente: o nome do fluxo precisa ser único.
- Abra o fluxo e entre na aba Builder. O Builder abre o rascunho mais recente; se ele não existir, abre a versão publicada; se também não houver, mostra o desenho inicial.
- Clique no bloco Início para abrir o painel do bloco. Ele é a porta de entrada: tudo que o contato escrever primeiro passa por aqui.
- Para criar mais um bloco, clique em Adicionar bloco na barra de ferramentas. No painel NOVO BLOCO, escolha Padrão, Humano, Pesquisa de satisfação, Agente de IA, AI Answers ou um subfluxo.
- Dê um nome ao bloco no topo do painel (o campo Nome do bloco) e monte o conteúdo na primeira aba. Os tipos de conteúdo estão nos artigos de blocos listados em Próximos passos.
- Ligue os blocos. Arraste a partir do ponto de saída de um bloco até o bloco de destino, ou abra a aba Condições de saída do bloco e escolha o destino em Ir para.
- Defina a Saída padrão de cada bloco, que define para onde a conversa segue quando nenhuma condição for cumprida. Veja o detalhe em condições de saída.
- Abra o teste pelo botão Testar fluxo em construção, envie uma mensagem e confira o caminho. Veja como testar um fluxo.
- Quando estiver satisfeito, clique em Publicar fluxo. Ao concluir, o Pipe mostra o aviso Fluxo publicado!.
Ferramentas da tela
| Controle | Para que serve |
|---|---|
| Adicionar bloco | Abre o painel NOVO BLOCO com os tipos de bloco. |
| Publicar fluxo | Transforma o rascunho na versão que atende os contatos. |
| Configuração | Abre as abas Variáveis, Versões e Ações globais. |
| Biblioteca de variáveis | Lista as variáveis do sistema e as que o seu fluxo já usa. |
| Pesquisar | Procura blocos por título, tags, conteúdo, ações ou saídas. |
| Testar fluxo em construção | Abre o painel de teste do rascunho. |
| Desfazer (Ctrl+z) e Refazer (Ctrl+Shift+z) | Voltam e avançam as alterações. |
| Tela Cheia (Alt+Enter) | Amplia o Builder para a tela inteira. |
| Zoom | Aproxima ou afasta o desenho. Arraste o fundo para mover o desenho. |
Exemplo na Loja Girassol
A Loja Girassol quer receber o cliente, perguntar o assunto e só então chamar o atendimento.
- O bloco Início envia "Oi! Aqui é a Loja Girassol. Sobre o que você quer falar?" e espera a resposta.
- Um bloco Padrão chamado Pedidos responde com orientações sobre acompanhamento de entrega.
- Um bloco Humano chamado Atendimento humano coloca a conversa na fila do Desk.
- No bloco Início, uma condição de saída leva quem escrever "pedido" para o bloco Pedidos. A Saída padrão leva todo o resto para o Atendimento humano.
O resultado são dois caminhos curtos e uma regra clara de quando uma pessoa assume.
Resultado esperado
O rodapé do Builder mostra Salvo e a quantidade de blocos. Depois de publicar, os canais conectados passam a usar o fluxo publicado. A partir daí, qualquer edição vira um novo rascunho e só entra no ar quando você publicar de novo.
Boas práticas
- Dê nomes que descrevam o objetivo do bloco, como "Pedidos" ou "Troca e devolução". É assim que os blocos aparecem no painel de teste.
- Defina a Saída padrão de todo bloco que tenha condições, para que a conversa sempre tenha um destino previsto.
- Teste cada caminho depois de uma mudança, inclusive o caminho em que o contato escreve algo inesperado.
- Antes de uma mudança grande, baixe uma cópia do fluxo (veja importar e exportar um fluxo).
Limitações
- O roteador não tem Builder. O desenho é sempre editado no fluxo de cada serviço.
- Um fluxo precisa ser válido para ser publicado. Blocos marcados em vermelho bloqueiam a publicação até serem corrigidos.
Problemas comuns
- Aparece "Erro ao publicar o fluxo: Um ou mais blocos estão inválidos": corrija os blocos marcados em vermelho. Abra cada um e complete os campos obrigatórios ou o destino da saída.
- Aparece "Existe um loop no seu fluxo": há blocos que levam uns aos outros sem pedir nada ao contato. Inclua uma entrada do usuário (pergunta com espera de resposta) em um dos blocos do ciclo.
- O botão Publicar fluxo está cinza: passe o mouse sobre ele. A dica informa o motivo: falta de permissão, carregamento em andamento ou nada para publicar.
- O rodapé mostra "Alterações não salvas" por muito tempo: aguarde alguns segundos. Se aparecer o botão Tentar de novo, clique nele para forçar o salvamento.
- Mensagem dizendo que roteador não tem Builder: o projeto aberto é um roteador. Abra o fluxo de um dos serviços dele.
Próximos passos
Perguntas frequentes
Qual é a diferença entre fluxo e roteador?
O fluxo tem um desenho de blocos que você edita no Builder. O roteador não tem Builder: ele só distribui a conversa entre os serviços. Se você abrir o Builder de um roteador, o Pipe avisa que o desenho deve ser editado no fluxo de cada serviço.
Preciso salvar o que estou editando?
Não. O Builder salva sozinho e mostra o estado no rodapé: Salvando, Alterações não salvas ou Salvo. Salvar é diferente de publicar: só a versão publicada atende os contatos.
Por que o botão Publicar fluxo está desabilitado?
Porque você não tem a permissão de publicar fluxo, porque ainda carrega o desenho ou porque não há nada novo para publicar: a versão que está no ar já é igual ao que você vê.
Posso desfazer uma alteração?
Sim. Use Desfazer (Ctrl+z) e Refazer (Ctrl+Shift+z) no rodapé do Builder.
Esse artigo foi útil?
Obrigado pelo retorno!