Perguntas frequentes sobre fluxos de trabalho

Perguntas frequentes sobre fluxos de trabalho no Vecta Desk.

Por que não consigo ativar um fluxo de trabalho?

Isso provavelmente é um problema de permissões. Você precisa de acesso a fluxos de trabalho para criá-los e ativá-los.

Solução: entre em contato com o administrador do seu espaço de trabalho para conceder acesso a fluxos de trabalho em Configurações → Membros → Funções.

Se você não vê a seção de fluxos de trabalho na sua barra lateral, isso confirma que é um problema de permissões.

Por que não vejo o botão do meu fluxo de trabalho manual na barra de navegação superior?

Fluxos de trabalho manuais só aparecem na barra de navegação se estiverem corretamente configurados:

1. O fluxo de trabalho deve estar ativado (não em modo rascunho).
2. A posição na barra de navegação deve estar definida como Fixado.
3. Para gatilhos Único/Em massa, você deve estar na página do objeto correto.

Para verificar: abra o fluxo de trabalho → clique no gatilho → verifique se a posição na barra de navegação está definida como “Fixado”.

Você sempre pode acessar fluxos de trabalho manuais via Cmd + K (ou Ctrl + K), independentemente das configurações da barra de navegação.

Qual é a diferença entre gatilhos manuais Único, Global e Em massa?

• Global: use quando o fluxo de trabalho não precisa de nenhum contexto de registro (por exemplo, gerar um relatório).
• Único: use quando você quer processar cada registro selecionado de forma independente (por exemplo, enviar e-mails individuais).
• Em massa: use quando você precisa processar registros em conjunto (requer a ação Iterador).

Veja Gatilhos de fluxo de trabalho para obter detalhes.

Não vejo um nó If/Else. O que devo fazer?

Um nó If/Else explícito ainda não está disponível, mas está em nosso roadmap.

Solução alternativa atual: crie várias ramificações a partir da sua etapa, cada uma começando com uma ação Filtro:

Etapa 1
   │
   ├── Ramificação A: Filtro (condição = verdadeira) → Ações...
   │
   └── Ramificação B: Filtro (condição = falsa) → Ações...

Apenas a ramificação em que a condição do filtro for atendida executará suas ações subsequentes.

Veja Como usar ramificações para um guia passo a passo.

As ramificações do fluxo de trabalho são executadas em paralelo?

Sim, as ramificações são executadas em paralelo por padrão.

Se você quiser que apenas uma ramificação seja executada:

• Adicione uma ação Filtro no início de cada ramificação.
• Defina condições opostas (por exemplo, Ramificação A: status = “Aberto”, Ramificação B: status ≠ “Aberto”).

Ramificações que não atendem à sua condição de filtro param de executar, enquanto as outras continuam.

Posso unir as ramificações novamente?

Sim. Após a conclusão das ramificações em paralelo, você pode adicionar uma etapa à qual ambas as ramificações se conectam.

No editor de fluxo de trabalho:

1. Conclua suas ações ramificadas.
2. Adicione uma nova etapa após as ramificações.
3. Arraste conexões do final de cada ramificação para essa nova etapa.

A etapa mesclada será executada após a conclusão de todas as ramificações conectadas.

Qual é o limite nos resultados de Pesquisar registros?

Pesquisar registros retorna no máximo 200 registros.

Se você precisar processar mais:

• Adicione filtros mais específicos para reduzir os resultados.
• Use fluxos de trabalho agendados para processar em lotes.
• Considere usar a API para operações em massa.

Para a maioria dos fluxos de trabalho, 200 registros são suficientes. Se você atingir esse limite regularmente, considere reestruturar sua automação.

Posso adicionar pessoas em CC nos e-mails do fluxo de trabalho?

Ainda não. Os campos CC e BCC para a ação Enviar e-mail estão em nosso roadmap.

Solução alternativa atual: adicione várias ações Enviar e-mail para enviar a destinatários adicionais, ou use uma Requisição HTTP para enviar por meio de um serviço de e-mail externo que dê suporte a CC.

Como uso as saídas de etapas anteriores?

Cada ação produz dados de saída que podem ser usados em etapas subsequentes.

Para referenciar dados de etapas anteriores:

• Use o seletor de variáveis ao configurar um campo.
• Ou digite {{stepName.fieldName}} diretamente.

Exemplos:

• Dados do gatilho: {{trigger.object.email}}
• Resultados da pesquisa: {{searchRecords[0].name}}
• Saída do código: {{code.calculatedValue}}

Passe o cursor sobre qualquer campo na configuração da ação para ver as variáveis disponíveis das etapas anteriores.

Por que meu Iterador falha?

O Iterador requer uma entrada do tipo array.

Problemas comuns:

1. A entrada não é um array: garanta que você está passando resultados de Pesquisar registros ou outra ação que retorne um array.
2. O array está vazio: adicione um filtro antes do Iterador para verificar {{searchRecords.length}} > 0.
3. Variável errada selecionada: certifique-se de selecionar o próprio array, não um único registro.

Configuração correta:

1. Pesquisar registros (retorna um array).
2. Filtro: length > 0.
3. Iterador: selecione {{searchRecords}}.
4. Ações dentro do Iterador usam {{iterator.currentItem.fieldName}}.

Qual é o tempo máximo de execução para ações de código?

As ações de código têm um tempo limite padrão de 5 minutos (300 segundos). O tempo limite máximo configurável é de 15 minutos (900 segundos). Se seu código exceder esse limite, a ação falhará com um erro de tempo limite.

Dicas para evitar estouros de tempo:

• Divida operações grandes em partes menores usando o Iterador.
• Evite computações pesadas; use serviços externos via Requisição HTTP para processamento intensivo.
• Otimize seu código para reduzir o tempo de execução.
• Se você precisar de um processamento mais longo, considere usar fluxos de trabalho agendados que processem dados em lotes.

Como leio as execuções de fluxo de trabalho?

As execuções de fluxo de trabalho mostram o histórico de execução e ajudam você a depurar problemas.

Acessar execuções:

• No editor de fluxo de trabalho → painel Execuções à direita.
• Ou vá para Execuções de fluxo de trabalho na barra lateral.

Entendendo uma execução:

• Status: Em execução, Concluída, Falhou, Aguardando.
• Etapas: veja quais etapas foram executadas e suas saídas.
• Erros: clique nas etapas com falha para ver as mensagens de erro.
• Dados: veja os dados de entrada/saída em cada etapa.

Veja Execuções de fluxo de trabalho para obter detalhes.

Por que não vejo minhas execuções de fluxo de trabalho?

As execuções de fluxo de trabalho podem estar falhando imediatamente devido a limites de taxa. Limite rígido: 5.000 execuções por hora por espaço de trabalho. Se você exceder esse limite, os fluxos são marcados imediatamente como falhos e não aparecerão na sua lista de execuções como esperado.

Cenários comuns que atingem esse limite:

• Selecionar mais de 5.000 registros com um gatilho manual Único.
• Vários fluxos de trabalho executando simultaneamente em todo o seu espaço de trabalho.
• Gatilhos automatizados de alta frequência (por exemplo, Registro atualizado em um objeto movimentado).

Soluções:

• Use gatilhos Em massa em vez de Único para processar muitos registros em uma única execução.
• Espace operações em lotes grandes.
• Use filtros para reduzir a frequência dos gatilhos.
• Agende fluxos de trabalho pesados fora do horário de pico.

Quais são os limites de taxa dos fluxos de trabalho?

O Vecta Desk tem dois limites de taxa para garantir a estabilidade do sistema:

Limite flexível (100/min): seus fluxos de trabalho não falharão — eles apenas aguardam na fila e são processados ao longo do tempo. Você pode acionar mais de 100 registros; a execução será mais lenta.

Limite rígido (5.000/h): isso se aplica a todo o seu espaço de trabalho. Se todos os seus fluxos combinados excederem 5.000 execuções em uma hora, execuções adicionais falharão imediatamente.

Dicas para permanecer dentro dos limites:

• Use gatilhos Em massa com Iterador em vez de gatilhos Único para grandes lotes.
• Combine automações relacionadas em menos fluxos de trabalho.
• Use fluxos de trabalho agendados para distribuir a carga ao longo do tempo.

Posso tentar novamente uma execução de fluxo de trabalho com falha?

Não, no momento não há funcionalidade de nova tentativa automática.

Se uma execução de fluxo de trabalho falhar, você precisará:

1. Revisar o erro em Configurações → Fluxos de trabalho → [Seu fluxo de trabalho] → Execuções.
2. Corrigir o problema (dados, configuração ou serviço externo).
3. Disparar manualmente o fluxo de trabalho novamente no(s) registro(s) afetado(s).

Dicas para reduzir falhas:

• Adicione nós Filtro para validar dados antes das ações.
• Use Pesquisar registros para verificar se existem registros relacionados.
• Teste profundamente com alguns registros antes de operações em massa.

A funcionalidade de nova tentativa automática está em nosso roadmap para uma versão futura.

Devo desativar fluxos de trabalho antes de importações CSV?

Sim, se seus fluxos de trabalho forem acionados por criação ou atualização de registros.

Quando você importa dados via CSV, cada registro criado ou atualizado pode acionar fluxos de trabalho. Uma importação grande (milhares de registros) pode:

• Atingir o limite de 5.000 execuções/hora.
• Enviar e-mails ou notificações inesperadas.
• Criar tarefas ou registros duplicados.

Antes de uma importação em massa:

1. Vá para Configurações → Fluxos de trabalho.
2. Identifique os fluxos de trabalho acionados pelo objeto que você está importando.
3. Desative-os temporariamente.
4. Execute sua importação CSV.
5. Reative os fluxos de trabalho quando terminar.

Alternativa: se você precisar que os fluxos de trabalho sejam executados nos dados importados, importe em lotes menores para permanecer dentro dos limites de taxa.

Como organizar o layout do meu fluxo de trabalho?

Se sua tela de fluxo de trabalho estiver desorganizada com nós espalhados, você pode organizá-la automaticamente:

1. Clique com o botão direito em qualquer lugar na tela do fluxo de trabalho.
2. Clique em Organizar fluxo de trabalho.

Isso reorganizará automaticamente todos os nós em um layout limpo e organizado.