Controle de fluxo avançado: try/catch, paralelo e unir ramos

Como tratar erros com Try / Catch, abrir vários ramos com Executar em paralelo e juntá-los de volta com Unir ramos nas suas automações.

Jun 26, 2026

Veja este passo no vídeo · Controle de fluxo

O que é e quando usar

Quando uma automação faz várias coisas ao mesmo tempo ou chama serviços externos, você precisa controlar a ordem e o que acontece se algo falhar. O Omnifox tem três nós avançados para isso, todos na seção Ações da paleta do editor de automações:

  • Try / Catch (tratar erros) — detecta se o nó anterior falhou e roteia por uma saída diferente.
  • Executar em paralelo — abre vários ramos a partir de um ponto.
  • Unir ramos — junta esses ramos de volta em um único ponto antes de continuar.

São ideais para chamadas de API (HTTP request), envios de e-mail ou mensagens que podem falhar, e para disparar várias ações que não dependem umas das outras.

Try / Catch (tratar erros)

Esse nó lê o resultado do nó imediatamente anterior e roteia conforme ele tenha dado certo ou errado. Por isso você deve colocá-lo logo após o nó que quer monitorar (por exemplo um HTTP request, um e-mail ou uma mensagem).

Ele tem duas saídas:

  • success (verde) — o nó anterior terminou OK.
  • error (vermelho) — o nó anterior retornou erro ou lançou uma exceção.

No ramo error você tem duas variáveis para informar o que aconteceu:

  • {{$error.message}} — o texto do erro.
  • {{$error.node}} — o ID do nó que falhou.

Um uso típico: depois de um HTTP request ao seu CRM, coloque um Try / Catch; pela saída success você segue o fluxo normal e pela error notifica um agente com a mensagem do erro.

Executar em paralelo

Abre entre 1 e 5 ramos (campo "Quantidade de ramos"). Cada ramo tem seu próprio handle de saída: b1, b2, … bN. Conecte cada handle ao início do seu ramo.

Nesta versão os ramos são executados de forma sequencial em ordem numérica (b1, depois b2, …), mesmo que o desenho no quadro pareça paralelo. O resultado final é o mesmo: todos os ramos rodam.

Diminuir o contador de ramos não apaga os edges existentes: se você configurou b3, b4, b5 e voltar para 2, esses edges sobrevivem.

Unir ramos (merge)

É um ponto de sincronização (join). Conta os edges que entram nesse nó e só deixa o fluxo avançar quando todos chegaram. Conecte a saída de cada ramo paralelo a esse mesmo nó.

  • Se chegar um único edge, o merge atua como passagem direta (pass-through).
  • Se um ramo nunca chegar, o merge fica bloqueado indefinidamente.

Passos para montar um fan-out com fechamento

  1. Abra o editor da automação em Automações.
  2. Arraste um nó Executar em paralelo e defina a quantidade de ramos.
  3. Conecte cada handle (b1, b2, …) à primeira ação do seu ramo.
  4. Monte cada ramo com as ações que precisar.
  5. Arraste um nó Unir ramos e conecte a saída final de cada ramo a ele.
  6. Continue o fluxo a partir da saída do merge.

Verificação

Use o botão de teste do editor (Test run) e veja a linha do tempo da execução: você deve ver cada ramo rodar e o merge avançar uma única vez, no final.

Se não funcionar

  • A automação trava no merge: algum ramo não chegou. Confira que cada ramo termine conectado ao merge, ou limite-o com um nó de espera (Wait until event) para que o ramo não fique pendente para sempre.
  • O Try / Catch sempre dá success: você o colocou longe do nó a monitorar. Ele deve ir imediatamente depois.
  • {{$error.message}} sai vazio: você está usando fora do ramo error; essas variáveis só existem após um erro real.

Dicas

  • Combine Try / Catch + Unir ramos para tentativas: no ramo error incremente um contador com o nó de variáveis e tente de novo.
  • Mantenha os ramos independentes; se um ramo depende do resultado de outro, não use paralelo, encadeie-os.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp