Appearance
Testar e Publicar
Antes de ligar o fluxo para os clientes, você pode testá-lo do início ao fim — sem precisar de um cliente real, sem mandar mensagem de WhatsApp, sem riscos. Nesta página você aprende a testar e, quando estiver tudo certo, a publicar.
Testar o fluxo (Single-Run)
O teste rápido (ou single-run) simula uma execução completa do fluxo com dados que você fornece. É como fazer um "ensaio" antes da peça de verdade.
Passo a passo
- Com o fluxo aberto no canvas, clique no botão **Testar** (ou **Run**) no canto superior direito.
CAPTURAR: barra superior do canvas com o botão Testar destacado
- Um painel lateral abre pedindo os dados de entrada do fluxo — os mesmos que viriam do gatilho em produção (ex.: mensagem do cliente, dados do contato).
CAPTURAR: painel de entrada do single-run com campos como userinput.query, contact.name e contact.phone para preencher
- Preencha os dados de teste e clique em **Executar**.
- O canvas mostra o progresso em tempo real: cada nó acende conforme é processado — verde para sucesso, vermelho para erro.CAPTURARCAPTURAR: canvas durante o teste com nós coloridos indicando o caminho percorrido: verde para executados com sucesso
- Clique em qualquer nó para ver os dados que entraram e saíram dele — ótimo para depurar problemas.CAPTURARCAPTURAR: painel de detalhes de um nó após o teste, mostrando as variáveis de entrada e saída com seus valores
Entendendo os resultados
Após o teste, cada nó mostra um indicador de resultado:
| Indicador | Significado |
|---|---|
| Verde | Nó executou com sucesso |
| Vermelho | Nó falhou — clique para ver o erro |
| Cinza | Nó não foi executado (caminho não percorrido) |
| Âmbar | Nó executou com aviso |
O que checar após o teste
- As variáveis têm os valores certos? Abra cada nó e veja as saídas.
- O caminho percorrido é o esperado? Confira se as condições (IF/ELSE, Classificador) tomaram o caminho correto.
- As mensagens ficaram bem formatadas? Verifique os textos gerados pelos nós de LLM e Template.
- As integrações retornaram dados? Confira as respostas dos nós HTTP, MCP e Data Source.
CAPTURAR: painel de resultado de um nó HTTP após o teste mostrando o JSON retornado pela API
Corrigindo erros
Se um nó falhou (vermelho), clique nele para ver a mensagem de erro. Os erros mais comuns são:
| Erro | Causa provável | O que fazer |
|---|---|---|
| Variável não encontrada | Nome digitado errado | Verifique a expressão {{ }} com o nome exato da variável |
| Timeout | API ou MCP demorou demais | Aumente o timeout do nó ou verifique a disponibilidade do serviço |
| Falha na autenticação | Token ou chave de API inválida | Revise as credenciais do servidor MCP ou do nó HTTP |
| Saída não conectada | Nó sem conexão de saída | Conecte a saída do nó ao próximo bloco |
Atenção
Durante o teste, nós do tipo Enviar Mensagem e Ação na Plataforma podem executar ações reais dependendo da configuração. Use dados fictícios nos campos de contato para evitar enviar mensagens reais a clientes.
Publicar o fluxo
Quando o teste estiver passando sem erros, é hora de publicar.
- Clique no botão **Publicar** no canto superior direito do canvas.
CAPTURAR: botão Publicar destacado na barra superior do canvas, ao lado do botão Testar
- Uma confirmação aparece perguntando se você quer substituir a versão publicada anterior. Confirme.
CAPTURAR: modal de confirmação de publicação com o resumo das mudanças e o botão de confirmar
- O fluxo entra em produção e começa a atender clientes reais imediatamente.
O que acontece após publicar
- O fluxo anterior fica salvo como histórico de versão — você pode consultar versões antigas.
- Conversas em andamento que já estavam no fluxo continuam na versão anterior até terminarem.
- Novas conversas que chegarem começam na versão recém-publicada.
Despublicando um fluxo
Se precisar pausar o fluxo temporariamente:
- Abra o fluxo no canvas.
- Clique em **...** (mais opções) e escolha **Despublicar**.
CAPTURAR: menu de opções do fluxo com a opção Despublicar destacada
- O fluxo para de aceitar novas conversas. Conversas em andamento podem ser finalizadas manualmente.
Dica
Antes de publicar uma mudança grande, teste com dados que cobrem todos os caminhos do fluxo — não só o caminho principal. Um cliente sempre vai fazer algo que você não esperava. Quanto mais cenários você testar, menos surpresas em produção.