Flow Builder
Validação e publicação
Como validar um fluxo e publicar a versão executável.
Antes de publicar, o Flow Builder corre um conjunto de validações automáticas.
Níveis de severidade
| Severidade | Significado |
|---|---|
| Erro | Impede a publicação. |
| Aviso | Permite publicar, mas deve ser revisto. |
Erros comuns
| ID do erro | Causa |
|---|---|
missing-required-spine-path | A coluna Main → Antes da conversa → Saudação foi desligada. |
missing-reachable-end | O fluxo não tem nenhum nó end alcançável. |
invalid-edge-* | Ligação entre tipos de nó não permitida. |
conversation-missing-instruction-* | Nó Conversation sem instrução. |
branch-needs-two-paths-* | Branch com menos de um caminho condicional. |
transfer-missing-* | Transferência sem destino, telefone, fila, SIP URI ou Phone Book. |
booking-missing-* | Booking sem título, calendário, variável de contacto ou horário. |
jump-dangling-* | Jump aponta para um nó que já não existe. |
trigger-subflow-self-* | Subfluxo tenta acionar a si próprio. |
Avisos comuns
- Ciclos (
cycle-*): assinalados apenas quando nenhum caminho dentro do ciclo consegue terminar a chamada. unreachable-node-*: nó que nenhuma ligação alcança a partir do início.conversation-missing-expected-info-*: Conversation sem informação esperada ou perguntas de recolha.
Outros erros que pode encontrar: branch-missing-fallback-* (branch sem caminho "Caso contrário"), branch-path-unlinked-* e branch-fallback-unlinked-* (caminhos por ligar), branch-duplicate-condition-* (condições repetidas) e subflow-entry-triggers-missing-* (subfluxo sem gatilhos de entrada).
Canais e estado live
A secção Publicação mostra uma nota sobre canais: WhatsApp e email ainda não existem no runtime; o SMS durante a chamada funciona (via Ombala); Agendamento e Transferência só bloqueiam a publicação se o fornecedor (calendário / telefonia) não estiver configurado.
Publicar
- Clique em Publicar no topo do builder.
- O sistema valida o fluxo.
- Se não houver erros, a nova versão passa a ser a versão live.
- O runtime passa a usar essa versão em chamadas novas.
Chamadas já em curso continuam com a versão que iniciaram. Apenas chamadas novas usam a versão publicada.

