Solução de Problemas do Workflow

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Problemas Comuns e Soluções

​

Workflow 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 o fluxo de trabalho esteja definido como “Active”, não “Draft”
2. Condições do gatilho não atendidas: Verifique se o gatilho corresponde ao evento esperado
3. Campo não monitorado: Para gatilhos “Record is Updated”, 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

​

Gatilhos do fluxo de trabalho ocorrem cedo demais (campos vazios)

Sintomas: Ao criar um registro manualmente na interface do usuário (UI), 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: Twenty salva tudo em tempo real — não há um modo separado de “edit” vs “read”. Quando você cria um registro, ele é salvo imediatamente, acionando o evento “Record is created” antes de você preencher os campos adicionais. Quando “Record is created” 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 UI, use “Record is created or updated” como seu gatilho em vez disso. 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

​

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 Twenty
• 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 Send Email 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 Runs
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 Test
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