Solução de problemas de fluxo de trabalho

Problemas comuns de fluxos de trabalho e como resolvê-los.

Problemas comuns e soluções

O fluxo de trabalho não dispara

Sintomas: seu fluxo de trabalho não é executado quando você espera.

Possíveis causas:

1. Fluxo de trabalho não ativado: garanta que esteja definido como “Ativo”, não “Rascunho”.
2. Condições do gatilho não atendidas: verifique se o gatilho corresponde ao evento esperado.
3. Campo não monitorado: para gatilhos “Registro é atualizado”, garanta que o campo específico esteja sendo monitorado.
4. Permissões: verifique se você tem permissão para executar fluxos de trabalho.

Soluções:

• Verifique o status do fluxo de trabalho na lista de fluxos de trabalho.
• Teste com a ação específica que você espera que o dispare.
• Revise a configuração do gatilho.
• Entre em contato com o seu administrador sobre permissões.

Os gatilhos do fluxo de trabalho ocorrem cedo demais (campos vazios)

Sintomas: ao criar um registro manualmente na interface, o seu fluxo de trabalho é acionado antes de você ter tempo de preencher todos os campos. O fluxo de trabalho é executado com a maioria dos campos vazios.

Por que isso acontece: o Vecta Desk salva tudo em tempo real — não há um modo separado de “edição” vs. “leitura”. Quando você cria um registro, ele é salvo imediatamente, acionando o evento “Registro é criado” antes de você preencher os campos adicionais.

Quando “Registro é criado” funciona bem:

• Registros criados por chamadas de API (os campos são preenchidos em uma única requisição).
• Registros criados por importação.
• Criação automática de registros a partir de outros fluxos de trabalho.

Solução: para registros criados manualmente na interface, use “Registro é criado ou atualizado” como seu gatilho. Dessa forma:

• O fluxo de trabalho é acionado depois que o usuário termina de preencher e salvar os campos.
• Você obtém os dados completos em vez de valores vazios.

Se você quer que o fluxo de trabalho seja executado apenas uma vez por registro, adicione uma ação Filtro para verificar um campo como createdAt igual a updatedAt (primeiro salvamento) ou use um campo de caixa de seleção personalizado para acompanhar se o fluxo já foi executado.

Ações com falha

Sintomas: o fluxo de trabalho é executado, mas algumas ações falham.

Possíveis causas:

1. Dados ausentes: campos obrigatórios estão vazios.
2. Referências inválidas: variáveis de etapas anteriores não existem.
3. Erros de API: serviços externos retornando erros.
4. Problemas de permissão: a ação requer permissões que você não possui.

Soluções:

• Verifique os detalhes da execução do fluxo de trabalho em busca de mensagens de erro.
• Verifique se todos os campos obrigatórios têm valores.
• Teste as conexões de API de forma independente.
• Revise as permissões de função.

Erros de requisição HTTP

Sintomas: ações de requisição HTTP falham ou retornam resultados inesperados.

Códigos de erro comuns:

• 400: solicitação inválida — verifique o formato do corpo da requisição.
• 401: não autorizado — verifique a chave da API.
• 403: proibido — verifique as permissões da API.
• 404: não encontrado — verifique a URL do endpoint.
• 429: muitas requisições — implemente limitação de taxa.
• 500: erro do servidor — problema no serviço externo.

Soluções:

• Verifique a URL do endpoint da API.
• Verifique os cabeçalhos de autenticação.
• Teste a chamada de API primeiro fora do Vecta Desk.
• Adicione tratamento de erros em ações de código.

Erros em ações de código

Sintomas: o código JavaScript não é executado.

Problemas comuns:

1. Erros de sintaxe: erros de digitação ou JavaScript inválido.
2. Variáveis indefinidas: referenciando variáveis que não existem.
3. Erros de tipo: operações com tipos de dados incorretos.
4. Tempo limite excedido: código demorando muito para executar.

Soluções:

• Use a validação integrada do editor de código.
• Teste a lógica do código primeiro em um console JavaScript.
• Adicione instruções console.log para depuração.
• Simplifique operações complexas.

E-mail não enviado

Sintomas: a ação Enviar e-mail não entrega os e-mails.

Possíveis causas:

1. Nenhuma conta de e-mail conectada: verifique Configurações → Contas.
2. Endereço de e-mail inválido: o e-mail do destinatário está com formato inválido.
3. Limites de envio: limites de taxa do provedor de e-mail atingidos.
4. Filtros de spam: e-mails sendo bloqueados.

Soluções:

• Verifique a conexão da conta de e-mail.
• Valide os endereços de e-mail dos destinatários.
• Verifique os limites do provedor de e-mail.
• Revise o conteúdo do e-mail para gatilhos de spam.

Depuração de fluxos de trabalho

Usando execuções de fluxo de trabalho

1. Vá para o editor de fluxo de trabalho.
2. Abra o painel Execuções.
3. Encontre a execução com falha.
4. Clique para ver os detalhes passo a passo.
5. Revise as mensagens de erro e os dados de saída.

Testando etapas individuais

1. Para ações de código, use o botão Testar.
2. Para requisições HTTP, teste o endpoint separadamente.
3. Crie registros de teste para acionar fluxos de trabalho.
4. Use gatilhos manuais para testes controlados.

Padrões comuns de depuração

• Adicione logs: use ações de código para registrar valores intermediários para depuração.
• Isole etapas: teste cada etapa de forma independente para identificar falhas.
• Verifique o fluxo de dados: confirme que cada etapa recebe os dados de entrada esperados.

Boas práticas para evitar problemas

Antes da ativação

• Teste cuidadosamente no modo de rascunho.
• Valide todas as conexões de API.
• Revise cuidadosamente as condições do gatilho.
• Documente o comportamento esperado.

Durante o desenvolvimento

• Use nomes descritivos para as etapas.
• Adicione comentários nas ações de código.
• Teste com dados realistas.
• Planeje casos-limite.

Após a ativação

• Monitore de perto as execuções iniciais.
• Configure alertas para falhas.
• Revise regularmente o histórico de execuções.
• Mantenha os fluxos de trabalho simples quando possível.