Fluxo não publica

Se clicar em Publicar no Flow Builder e receber um erro, o problema está quase sempre na estrutura ou referências do fluxo.

Causas comuns

• nó desligado sem ligação de saída;
• variável referenciada num nó que não existe no contexto;
• condição de branch inválida ou vazia;
• subfluxo apagado mas ainda referenciado por um nó trigger_subflow;
• nó transfer sem número de destino válido.

Passos para resolver

1. No Flow Builder, clique em Validar. O canvas mostra os avisos em vermelho.
2. Corrija cada aviso antes de tentar publicar.
3. Verifique que cada variável usada foi declarada ou existe por omissão.
4. Confirme que os subfluxos referenciados ainda existem e estão publicados.
5. Tente publicar novamente.

Validação via API

GET /api/v1/agents/{agent_id}/flows/{flow_id}/validate

O response indica erros de estrutura, referências inválidas e caminhos sem saída. Corrija todos os itens antes de usar POST /api/v1/agents/{agent_id}/publish.