Nós do Workflow
Os nós são os blocos de construção de qualquer workflow no Hashdata. Cada nó representa uma etapa do processo — seja o evento que dá início à automação, uma ação que envia um e-mail, uma decisão condicional ou uma espera por aprovação. Ao conectar nós em sequência, você descreve visualmente todo o fluxo de trabalho, sem precisar escrever uma linha de código.
Existem dois tipos fundamentais de nós:
- Gatilhos: iniciam o workflow. Todo workflow precisa de exatamente um nó gatilho como ponto de partida. Ele define quando e por quê uma nova instância do processo é criada.
- Ações: executam tarefas concretas após o gatilho. Podem enviar comunicações, aguardar decisões humanas, manipular dados externos ou controlar o fluxo lógico do processo.
Compreender os tipos de nós disponíveis e como eles se encaixam é o primeiro passo para construir automações eficazes.
Tipos de Nós
A tabela abaixo lista todos os nós disponíveis no editor de workflow, com seu tipo e uma descrição resumida de sua função.
| Nome | Tipo | Descrição |
|---|---|---|
| Gatilho por Formulário | Gatilho | Inicia o workflow quando uma resposta de formulário é criada, alterada ou excluída. Você escolhe o formulário e os tipos de evento que disparam o processo. |
| Gatilho Agendado | Gatilho | Inicia o workflow em um horário programado: diariamente, semanalmente, quinzenalmente ou mensalmente. Como não há respondente, é obrigatório configurar destinatários. |
| Aprovação | Ação | Envia um e-mail para aprovadores e aguarda a decisão deles. Cada resultado possível (desfecho) gera uma saída diferente no canvas. Suporta timeout configurável. |
| Enviar E-mail | Ação | Envia um e-mail para um ou mais destinatários com assunto e corpo customizado, suportando variáveis de formulário e artefatos como anexos. Avança imediatamente após o envio. |
| Solicitar Resposta de Formulário | Ação | Convida destinatários a preencher um formulário Hashdata e aguarda a resposta antes de continuar. Suporta timeout opcional que gera uma saída alternativa. |
| Solicitar Complementação de resposta (follow-up) | Ação | Pede a destinatários que editem ou complementem uma resposta já coletada anteriormente no processo. Funciona de forma similar ao nó de solicitação de resposta. |
| Definir Status | Ação | Define o texto de status da instância, visível na coluna "Último passo" da listagem de instâncias. Suporta variáveis e avança imediatamente após a execução. |
| Convergência (Join) | Ação | Aguarda que todas as branches paralelas ativas cheguem a este ponto antes de continuar. Essencial para sincronizar fluxos que se dividiram anteriormente. |
| Aguardar | Ação | Pausa a execução do workflow por um período de tempo definido: minutos, horas, dias ou semanas. Útil para criar intervalos entre etapas do processo. |
| Decisão (If/Else) | Ação | Avalia condições sobre campos de formulários ancestrais e direciona o fluxo para a saída Verdadeiro ou Falso conforme o resultado. |
| Chamada HTTP (Webhook Out) | Ação | Realiza uma requisição HTTP para uma URL externa (HTTPS obrigatório). Suporta múltiplos métodos e tipos de conteúdo. Gera saídas para Sucesso e Erro. |
| Criar PDF | Ação | Gera um arquivo PDF personalizado a partir de conteúdo HTML editado visualmente, com suporte a variáveis de formulário. O PDF vira artefato disponível para nós seguintes (e-mails, uploads, aprovações). Possui saída única e avança imediatamente. |
| Histórico do Workflow | Ação | Gera automaticamente um PDF com o histórico completo de eventos da instância — sem necessidade de configurar conteúdo. Ideal para auditoria e rastreabilidade. O PDF vira artefato para nós seguintes. Possui saída única e avança imediatamente. |
Além dos nós nativos acima, o Hashdata oferece nós de integração com serviços externos como Slack, Microsoft Teams, Google Sheets, Excel 365, Google Drive e OneDrive. Esses nós requerem uma conexão OAuth configurada previamente nas integrações do space.
Adicionando Nós ao Canvas
Para adicionar um nó ao seu workflow, você tem duas formas:
- Arrastar da paleta lateral: No editor de workflow, localize a barra lateral esquerda com a lista de nós disponíveis. Clique e arraste o nó desejado para qualquer área livre do canvas. Ele será posicionado onde você soltar.
- Clicar em um nó existente: Ao passar o cursor sobre um nó já adicionado ao canvas, um ícone de adição aparece nas saídas do nó. Clicando nele, você pode selecionar o próximo nó a ser adicionado diretamente conectado ao atual.
Após adicionar o nó ao canvas, clique sobre ele para abrir o painel de configuração e preencher suas propriedades.
Mantenha o canvas organizado posicionando os nós da esquerda para a direita ou de cima para baixo, seguindo o sentido natural do fluxo. Isso facilita a leitura e manutenção do workflow por toda a equipe.
Conectando Nós
As conexões entre nós definem a ordem de execução do workflow. Para conectar dois nós:
- Passe o cursor sobre o nó de origem até que os conectores de saída apareçam (círculos nas bordas direita ou inferior do nó).
- Clique e arraste a partir do conector de saída.
- Solte sobre o nó de destino para criar a conexão.
Cada conexão forma uma transição — uma seta no canvas que representa o caminho que a instância do workflow percorrerá. Uma transição sem condição é sempre seguida quando o nó de origem conclui sua execução.
Nós adicionados ao canvas mas não conectados ao fluxo principal não serão executados. Certifique-se de que todos os nós estejam devidamente ligados antes de publicar o workflow.
Nós com Múltiplas Saídas
Alguns nós geram mais de uma saída no canvas, permitindo que o fluxo se ramifique conforme o resultado da etapa:
- Aprovação: gera uma saída para cada desfecho configurado (ex: "Aprovado", "Reprovado", "Precisa Revisar") e uma saída adicional chamada TIMEOUT caso o prazo seja atingido sem resposta.
- Decisão (If/Else): gera sempre duas saídas — Verdadeiro (condição satisfeita) e Falso (condição não satisfeita).
- Chamada HTTP (Webhook Out): gera duas saídas — Sucesso (resposta HTTP 2xx) e Erro (qualquer outro código de resposta ou falha de rede).
- Solicitar Resposta de Formulário: gera a saída principal (quando a resposta é recebida) e uma saída TIMEOUT caso o prazo configurado expire sem resposta.
Cada saída deve ser conectada ao próximo nó correspondente ao cenário que ela representa. Saídas não conectadas encerram o fluxo naquele caminho.
Configurando um Nó
Cada nó possui propriedades específicas que definem seu comportamento. Para configurá-lo:
- Clique sobre o nó no canvas para selecioná-lo.
- O painel de propriedades será aberto à direita do canvas.
- Preencha os campos exibidos. Campos marcados com asterisco (*) são obrigatórios.
- Após preencher todas as configurações, clique em Salvar para confirmar as alterações.
As configurações variam conforme o tipo do nó — desde a escolha de um formulário e destinatários até a definição de condições complexas ou mapeamento de colunas para uma planilha externa.
Muitos campos de configuração suportam o uso de variáveis no formato {{nome_do_campo}}, que são substituídas em tempo de execução pelos valores coletados nos formulários ancestrais da instância.
Condições nas Transições
Além de conectar nós, você pode configurar condições em cada transição para controlar quando ela deve ser seguida. Para configurar uma condição:
- Clique sobre a seta de conexão entre dois nós no canvas.
- O painel de configuração da transição será aberto.
- Defina as condições desejadas com base nos campos de formulários ancestrais do workflow.
- Salve as configurações.
Quando uma transição possui condições, ela só será seguida se todas as condições forem satisfeitas no momento da execução. Transições sem condição são sempre seguidas quando o nó de origem conclui.
Use múltiplas saídas (nó If/Else ou outcomes/desfechos de Aprovação) quando a lógica de ramificação é parte central do nó. Use condições em transições para filtros adicionais em caminhos que já partem de uma saída específica.
Ramificação e Convergência
Workflows podem ter branches paralelas — caminhos que se executam simultaneamente. Isso acontece quando um nó possui múltiplas saídas e todas são conectadas a nós diferentes.
Fork (Ramificação)
Quando todas as saídas de um nó são ativadas ao mesmo tempo (como em alguns cenários de Aprovação), o workflow se divide em branches paralelas. Cada branch avança de forma independente.
Join (Convergência)
O nó Convergência (Join) é usado para sincronizar branches paralelas. Ele aguarda que todas as branches que chegam a ele sejam concluídas antes de continuar o fluxo. O número de entradas do Join é definido automaticamente com base nas conexões feitas no canvas.
Certifique-se de que todas as branches conectadas ao nó Join realmente têm possibilidade de alcançá-lo. Se uma branch puder terminar sem chegar ao Join (por exemplo, por uma condição que nunca é satisfeita), o workflow ficará bloqueado aguardando indefinidamente.
Páginas de Referência por Nó
Para detalhes completos de configuração de cada nó, consulte as páginas individuais: