Nó: Definir Status
O nó Definir Status permite que você configure um texto descritivo para a instância do workflow. Esse texto é exibido na coluna Último passo no painel de instâncias, permitindo que qualquer membro da equipe identifique rapidamente em qual estágio cada instância se encontra — sem precisar abrir o histórico detalhado.
Diferente de nós que aguardam uma ação externa, o Definir Status avança imediatamente após gravar o texto, sem interromper o fluxo do processo. É um nó de apoio à visibilidade operacional.
Quando usar
Use o nó Definir Status sempre que precisar aumentar a transparência sobre o andamento de um processo. Ele é especialmente valioso em workflows que:
- Possuem múltiplas etapas longas — processos de aprovação em vários níveis, coleta de informações em sequência, ou integrações com sistemas externos podem demorar horas ou dias. Sem um status atualizado, fica difícil saber se uma instância está travada ou apenas aguardando.
- Envolvem múltiplos responsáveis — quando diferentes pessoas acompanham o painel de instâncias, o texto de status evita perguntas repetidas do tipo "em que fase está isso?".
- Precisam de auditoria simplificada — gestores que monitoram volumes grandes de solicitações ganham uma visão imediata do estado de cada item sem abrir cada instância individualmente.
- Combinam branches paralelas — em workflows com divisões (múltiplos caminhos simultâneos), um status bem posicionado antes do nó de convergência (JOIN) esclarece o que cada branch estava fazendo.
Coloque o nó Definir Status imediatamente antes de nós como Aprovação ou Solicitar Resposta de Formulário. Assim, quando a instância entrar em espera, o painel já exibirá a mensagem correta — por exemplo, "Aguardando aprovação do gestor financeiro" — tornando o estado visível para toda a equipe antes mesmo de qualquer ação ocorrer.
Configuração
A configuração do nó Definir Status é simples e conta com um único campo:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Texto de status | Sim | Mensagem descritiva exibida na coluna Último passo. Suporta variáveis no formato {{nome_do_campo}} para incluir dados dinâmicos da instância. |
Usando variáveis no texto de status
Você pode enriquecer o texto de status com informações reais da instância usando a sintaxe {{nome_do_campo}}. As variáveis disponíveis correspondem aos campos de formulários que já foram respondidos até aquele ponto no fluxo — ou seja, campos de formulários que fazem parte dos nós anteriores ao Definir Status na sequência do workflow.
Exemplo: se o formulário de entrada possui um campo chamado solicitante, você pode escrever:
Solicitação recebida de {{solicitante}}
O painel de instâncias exibirá algo como: Solicitação recebida de Maria Souza.
Se uma variável referenciada no texto ainda não tiver sido preenchida na instância (por exemplo, um campo de um formulário que ainda não foi respondido), ela será exibida em branco. Certifique-se de que o nó Definir Status está posicionado após todos os nós que coletam os dados que você quer exibir.
Exemplos de uso
A seguir, alguns modelos de texto de status para situações comuns. Adapte os nomes das variáveis conforme os campos reais dos seus formulários.
Registro da entrada da solicitação
Solicitação recebida em {{data_envio}} por {{email_solicitante}}
Resultado esperado no painel: Solicitação recebida em 01/06/2026 por joao@empresa.com
Use este texto logo após o gatilho do formulário para confirmar que a instância foi iniciada e identificar quem a enviou.
Registro de aprovação
Aprovado pelo gestor em {{data_aprovacao}}
Resultado esperado no painel: Aprovado pelo gestor em 02/06/2026
Posicione este nó na saída de Aprovado do nó de Aprovação para que o histórico mostre claramente que a etapa de aprovação foi concluída com sucesso.
Indicação de exportação concluída
Dados exportados para planilha
Texto fixo, sem variáveis. Use após nós de exportação (como Exportar para Google Sheets) para registrar que os dados foram enviados ao sistema externo.
Status de etapa em andamento (antes de aguardar ação)
Aguardando complementação de dados por {{email_responsavel}}
Resultado esperado no painel: Aguardando complementação de dados por ana@empresa.com
Posicione antes de um nó Solicitar Complementação (follow-up) para deixar o painel informativo enquanto a instância aguarda a ação do responsável.
Status em workflow de múltiplas aprovações
Etapa 1 aprovada — Aguardando aprovação do diretor
Texto descritivo que combina o resultado já alcançado com o próximo passo esperado. Muito útil em workflows com cadeia de aprovações sequenciais.
Comportamento
O nó Definir Status tem um comportamento distinto dos demais nós de ação:
- Avanço imediato: assim que o nó é executado, ele grava o texto de status e passa o controle para o próximo nó imediatamente. Não há espera por resposta, aprovação ou período de tempo.
- Não interrompe o fluxo: por avançar instantaneamente, ele pode ser inserido em qualquer ponto do workflow sem adicionar latência ao processo.
- Atualiza o painel em tempo real: o texto gravado aparece imediatamente na coluna Último passo do painel de instâncias, visível para todos os usuários com permissão de visualização.
- Saída única: o nó possui apenas uma saída, pois não há condição de falha nem desvio de caminho — ele sempre avança normalmente.
O Definir Status apenas atualiza o texto exibido no painel interno do Hashdata. Ele não envia emails, mensagens no Slack ou qualquer outro tipo de notificação. Para comunicar mudanças de status externamente, utilize os nós Enviar Email, Enviar Mensagem no Slack ou Enviar Mensagem no Teams em conjunto.
Acumulação de status
Quando um workflow possui múltiplos nós Definir Status ao longo do fluxo, cada execução substitui o texto anterior — mas o histórico completo de todos os textos definidos durante a vida da instância fica registrado e é exibido de forma concatenada no detalhe da instância, separados por |.
Exemplo de histórico acumulado:
Solicitação recebida em 01/06/2026 | Aguardando aprovação do gestor | Aprovado pelo gestor em 02/06/2026 | Dados exportados para planilha
Isso permite que você reconstrua a trajetória da instância apenas lendo o histórico de status, sem precisar analisar cada nó individualmente.
Projete seus textos de status pensando em como eles formarão uma linha do tempo legível quando concatenados. Prefira frases no passado para etapas concluídas ("Aprovado em...") e no gerúndio ou futuro para etapas em andamento ("Aguardando...", "Enviando..."). Isso torna o histórico acumulado muito mais informativo.
Permissões necessárias
Para adicionar ou configurar o nó Definir Status em um workflow, o usuário precisa da permissão "Gerenciar Workflows". Usuários com apenas a permissão "Visualizar Workflows" podem visualizar o painel de instâncias e ler os textos de status, mas não podem editar o design do workflow.
Para mais informações sobre permissões, consulte a seção de gerenciamento de workflows.