Builder · Atualizado em 06/10/2026
Como testar um fluxo no Builder
Simule uma conversa com o rascunho do fluxo, use variáveis de teste e leia o painel de depuração antes de publicar.
O painel de teste deixa você conversar com o seu fluxo dentro do Builder, como se fosse um contato, e ver por dentro o que o Pipe fez em cada passo.
Quando usar
Teste depois de qualquer mudança em blocos, condições de saída, variáveis ou ações, e sempre antes de Publicar fluxo. O teste é a forma mais rápida de descobrir um caminho que leva ao bloco errado ou uma variável que chegou vazia.
Pré-requisitos
- Permissão para abrir o Builder do fluxo.
- Um fluxo com ao menos o bloco Início.
- Para testar o agente de IA com respostas reais, a chave do provedor cadastrada nas variáveis sensíveis. Sem ela, o teste responde em modo simulação.
Passo a passo
- Abra o fluxo na aba Builder.
- Clique no botão Testar fluxo em construção, no canto da tela do Builder. O painel de mesmo nome abre.
- Se quiser simular dados do contato, em Variáveis de teste clique em + Adicionar variável de teste e preencha nome e valor.
- No campo Digite sua mensagem aqui, escreva a primeira mensagem do contato.
- Pressione Enter ou clique em Enviar. As respostas do fluxo aparecem na conversa.
- Continue a conversa. Quando o fluxo oferecer opções, você pode clicar nelas em vez de digitar.
- Abaixo da conversa, leia o painel de depuração: Bloco atual, Variáveis e Ações executadas.
- Clique no nome de um bloco no painel para localizá-lo no desenho.
- Para recomeçar, clique em Reiniciar teste.
- Quando terminar, clique em Fechar.
O que o painel mostra
| Área | O que informa |
|---|---|
| Conversa | As mensagens do contato de teste e as respostas do fluxo, incluindo texto, opções, links, imagens, vídeos, áudios, documentos e localização. |
| Bloco atual | O bloco em que o contato de teste está parado. Mostra "nenhum (fluxo encerrado)" quando o fluxo terminou. |
| Variáveis | O valor de cada variável criada até agora. Mostra "Nenhuma variável definida ainda" quando não há nenhuma. |
| Ações executadas | Cada bloco que rodou e as ações dele, na ordem. O item Ações globais reúne as ações globais. Erros aparecem ao lado da ação. |
| Expirar entrada | Aparece quando o contato espera num bloco com tempo de inatividade. Simula o fim do tempo sem você esperar. |
O que o teste faz e não faz
- Usa o rascunho atual, com o mesmo mecanismo que atende os contatos.
- Não envia mensagens por canal e não cria atendimento, conversa nem registro de execução. O encaminhamento para atendimento humano é simulado.
- Requisições HTTP e scripts rodam de verdade, com as mesmas proteções do uso normal. Teste com cuidado ações que alteram dados em sistemas externos.
- O estado do contato de teste continua entre as mensagens, até você clicar em Reiniciar teste.
- O agente de IA, sem chave cadastrada, responde com o prefixo [Simulação]. Digitar
/handoff nomesegue o direcionamento com esse nome.
Exemplo na Loja Girassol
Antes de publicar o fluxo da Loja Girassol, a equipe testa dois caminhos.
- Envia "onde está minha entrega". O Bloco atual passa a ser Pedidos, e a mensagem de orientação aparece.
- Clica em Reiniciar teste.
- Envia "oi, tudo bem?". Como nenhuma condição bate, a conversa vai para a Saída padrão, o bloco Atendimento humano.
- Em Variáveis, confere que
assuntoficou vazia nesse segundo caminho, como esperado.
Resultado esperado
Cada caminho do fluxo leva ao bloco previsto, as mensagens mostram os valores das variáveis e a seção Ações executadas não traz erros.
Boas práticas
- Reinicie o teste entre um caminho e outro para começar sempre do bloco Início.
- Use Variáveis de teste para simular contatos com dados diferentes, como um contato sem e-mail.
- Leia os erros de Ações executadas, mesmo quando a conversa parece correta.
Limitações
- O teste não passa por nenhum canal. Depois de publicar, vale fazer uma conversa de verificação pelo canal conectado.
- Tempos de inatividade não correm sozinhos no teste. Use o botão Expirar entrada.
- O teste não grava nada no Desk, nos relatórios nem no histórico de atendimentos.
Problemas comuns
- A conversa não responde: leia a mensagem de erro em vermelho no painel e corrija o bloco ou a ação indicada. Confira também se há blocos marcados em vermelho no desenho.
- O teste segue um caminho inesperado: abra o bloco e revise a ordem das condições de saída. A primeira verdadeira vence.
- Uma variável aparece vazia: confira se o nome é idêntico ao usado na mensagem e se a ação que a cria rodou antes, em Ações executadas.
- A resposta do agente de IA vem como [Simulação]: a chave do provedor não foi encontrada nas variáveis sensíveis do fluxo.
- Quero começar do zero: clique em Reiniciar teste. O contato de teste e as variáveis de teste são limpos.
Próximos passos
Perguntas frequentes
O teste usa o rascunho ou a versão publicada?
O rascunho, ou seja, o que você está vendo no Builder agora. Você não precisa publicar para testar.
O teste envia mensagens para clientes reais?
Não. O teste usa um contato de teste isolado, e nada é enviado por canal nem gravado como conversa ou atendimento.
Como começo a conversa de novo?
Clique em Reiniciar teste, no topo do painel. Não há confirmação: o contato de teste e as variáveis são zerados na hora.
O teste ativa o atendimento humano?
O teste simula o encaminhamento em memória, sem criar atendimento real no Desk.
Posso testar com dados diferentes?
Sim. Em Variáveis de teste, use Adicionar variável de teste para definir o nome e o valor de variáveis antes de enviar a mensagem.
Esse artigo foi útil?
Obrigado pelo retorno!