Pular para o conteúdo principal

Debug e Simulacao

Use o simulador para reproduzir cenarios com payload de teste.

Quando usar simulacao

  • Antes de publicar qualquer alteracao
  • Depois de mudar regra de roteamento
  • Ao corrigir incidente de producao
  • Ao trocar credencial de integracao

Fluxo recomendado

  1. Execute simulacao com payload realista.
  2. Confira contexto gerado por node.
  3. Ajuste regras/transformacoes.
  4. Revalide e publique.

Cenario guiado: WhatsApp sem resposta apos integracao

Sintoma: mensagem chega no trigger, mas cliente nao recebe retorno.

Passo a passo de diagnostico:

  1. Confirmar entrada no WA Trigger.
  2. Verificar se AI Node retornou intencao e score.
  3. Validar roteamento do Switch Node.
  4. Inspecionar resposta do HTTP Request (status, body, timeout).
  5. Confirmar execucao do node de resposta (WA Send Text).
  6. Se etapa externa falhar, validar caminho de fallback/handoff.

Payload minimo de teste:

{
"trigger": {
"channel": "whatsapp",
"contact": {
"id": "wa_123",
"name": "Joao"
},
"message": {
"text": "Quero pagar minha fatura"
}
}
}

Preview no FlowBuilder

Este exemplo abre direto no FlowBuilder embedado. A visualizacao em Fluxo/JSON, simulacao e operacoes do flow ficam dentro do proprio editor.

Nao foi possivel carregar o preview embedado automaticamente.

Playbook de diagnostico rapido

Caso 1: flow nao responde

  • Verifique se o trigger esta ativo.
  • Confirme se o evento realmente chegou.
  • Valide se ha conexao de saida no primeiro node.

Caso 2: resposta vazia ou incorreta

  • Inspecione variaveis usadas no template.
  • Revise caminhos de contexto.
  • Teste com payload de producao.

Caso 3: falha em node externo

  • Revise credencial e permissao.
  • Verifique timeout e formato do payload.
  • Aplique fallback para evitar interrupcao total.

Matriz de validacao de fallback

  • API externa fora: cliente recebe mensagem padrao e segue para fila humana.
  • API externa lenta: timeout respeitado e fluxo nao fica preso.
  • Campo obrigatorio ausente: erro registrado e fluxo segue por rota segura.

Checklist pre-publicacao

  • Simulacao sem erro com payload real
  • Roteamento validado em todos os caminhos
  • Tratamento de erro configurado
  • Logs suficientes para suporte

Proximo passo

Para regras condicionais mais robustas, siga para JSONLogic.