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
- Execute simulacao com payload realista.
- Confira contexto gerado por node.
- Ajuste regras/transformacoes.
- 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:
- Confirmar entrada no
WA Trigger. - Verificar se
AI Noderetornou intencao e score. - Validar roteamento do
Switch Node. - Inspecionar resposta do
HTTP Request(status, body, timeout). - Confirmar execucao do node de resposta (
WA Send Text). - 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.