Ações

Notificação de Comparação

Envie notificações automáticas com base em resultados de comparações configuradas no workspace.
atualizado

Notifique sobre resultados de comparações no seu fluxo

O nó de Notificação de Comparação envia um e-mail automático aos responsáveis de uma comparação, listando os itens pendentes no momento da execução. Ele é útil para cobranças periódicas, lembretes automáticos ou acompanhamento de divergências sem intervenção manual.

Este nó é automático — não gera tarefa. Ao ser alcançado durante a execução do fluxo, o e-mail é disparado imediatamente e o fluxo avança para o próximo nó.

Para utilizar este nó, é necessário que o módulo de Comparações esteja ativado no workspace e que ao menos uma comparação já tenha sido configurada. Para saber como configurar comparações, consulte a documentação do módulo de Comparações.

Quando usar este nó

Utilize o nó Notificação de Comparação quando precisar enviar lembretes automáticos sobre itens pendentes em uma comparação, sem depender de ação manual de um membro do workspace.

Ele é ideal para:

  • Cobranças periódicas para responsáveis com itens pendentes de envio
  • Lembretes automáticos sobre itens reprovados aguardando correção
  • Acompanhamento diário de divergências pendentes de resolução
  • Alertas programados para gestores sobre status geral da comparação
O nó envia apenas um e-mail por grupo de responsáveis, mesmo que existam múltiplos itens pendentes. Se um responsável tem 50 itens pendentes, ele recebe um único e-mail com o resumo de todos.

Como funciona

O nó consulta a comparação selecionada no momento da execução e identifica os itens pendentes. O e-mail é enviado aos responsáveis configurados na comparação — ou seja, aos membros dos grupos de responsáveis definidos no campo Responsável da configuração da comparação.

O nó não aguarda o encerramento da comparação — ele executa no momento em que o fluxo chega até ele, enviando o status atual dos itens pendentes naquele instante. Isso permite que você programe cobranças recorrentes via trigger Timer, por exemplo.

O relatório final da comparação é anexado automaticamente ao e-mail. O destinatário recebe tanto o corpo do e-mail configurado quanto o arquivo com o resumo dos itens pendentes.

Configurações do nó

  • Nome do Nó — identificação do nó no canvas. O padrão é "Notificação de Comparação", mas pode ser personalizado.
  • Comparação (obrigatório) — selecione uma comparação existente no workspace. As opções listadas são as comparações já configuradas no módulo de Comparações.
  • Provedor — serviço utilizado para o envio do e-mail. As opções disponíveis são:
    • Enspace — utiliza o sistema de e-mail nativo do ENSPACE.
    • SMTP — utiliza um servidor SMTP configurado nas integrações do workspace.
    • Integração — utiliza uma integração de e-mail externa configurada no workspace (ex: SendGrid).
  • Assunto (obrigatório) — título do e-mail que será exibido na caixa de entrada do destinatário. Aceita variáveis dinâmicas com {{ para inserir dados de nós anteriores do fluxo.
  • Layout Base — define o modelo visual do e-mail:
    • Enspace — layout padronizado com cabeçalho e formatação do ENSPACE.
    • Empty — layout em branco, sem estilo ou marcação predefinida.
  • Corpo (obrigatório) — conteúdo do e-mail. Possui editor de texto com formatação e aceita variáveis dinâmicas com {{ para inserir dados de nós anteriores do fluxo.
Atenção:
Não é possível filtrar por status específico nem notificar apenas um responsável em particular. O nó sempre envia para todos os responsáveis da comparação, com o resumo de todos os itens pendentes no momento da execução.

Comportamento dos dados

  • Destinatários — o e-mail é enviado aos membros dos grupos configurados como responsáveis na comparação selecionada. Se um membro pertencer a múltiplos grupos de responsáveis, recebe apenas um e-mail.
  • Relatório anexado — o relatório final da comparação é anexado automaticamente ao e-mail, contendo o resumo dos itens pendentes.
  • Execução sem pendentes — se não houver itens pendentes na comparação no momento da execução, o e-mail ainda é enviado, mas o relatório anexado estará vazio ou conterá apenas a estrutura sem dados.
  • Comparação excluída — se a comparação selecionada for excluída após a configuração do nó, a execução resultará em erro.
  • Comparação inativa — se a comparação estiver configurada mas o módulo de Comparações for desativado no workspace, a execução do nó falhará.
  • Variáveis disponíveis — o nó pode acessar variáveis de nós anteriores do fluxo (conectados direta ou indiretamente) usando a sintaxe {{nome_da_variavel}}, da mesma forma que outros nós do Spaceflow.
Alterações na configuração da comparação (adição ou remoção de responsáveis) afetam apenas novas execuções. A lista de destinatários é resolvida no momento do disparo.

Exemplo de uso

Cobrança diária de itens pendentes

Um fluxo dispara automaticamente todo dia às 7h da manhã via trigger Timer. O nó de Notificação de Comparação verifica os itens pendentes e envia um e-mail de cobrança aos responsáveis.

Neste exemplo:

  1. O trigger Timer dispara o fluxo todos os dias às 7h.
  2. O nó consulta a comparação configurada e identifica os itens pendentes.
  3. Um único e-mail é enviado a cada grupo de responsáveis com o resumo dos itens pendentes.
  4. O relatório final da comparação é anexado automaticamente ao e-mail.
  5. O fluxo encerra.

Alerta após reprovação em massa

Um fluxo dispara manualmente após um aprovador reprovar vários itens. O nó envia notificação aos responsáveis informando que há itens aguardando correção.


Limitações conhecidas

Este nó não permite filtrar por status específico nem selecionar responsáveis individuais. O e-mail sempre inclui o resumo completo dos itens pendentes e é enviado a todos os responsáveis configurados na comparação.
  • Não é possível notificar apenas o aprovador — o destinatário é sempre o grupo de responsáveis.
  • Não é possível anexar relatórios específicos (divergências, comentários, alterações) — apenas o relatório final é anexado automaticamente.
  • Não é possível condicionar o envio à existência de pendentes — o e-mail é enviado mesmo que não haja itens pendentes.
  • O nó não retorna dados ou variáveis para os nós seguintes do fluxo.

Boas práticas

  • Utilize este nó em conjunto com um trigger Timer para cobranças periódicas automáticas.
  • Configure o assunto do e-mail de forma clara para que o responsável identifique rapidamente o propósito da notificação.
  • Use variáveis dinâmicas no corpo do e-mail para personalizar a mensagem com dados do fluxo.
  • Evite frequências muito altas no trigger Timer para não sobrecarregar os responsáveis com e-mails repetidos.
  • Monitore os logs do fluxo para verificar se os e-mails estão sendo enviados corretamente.
  • Lembre-se de que o relatório anexado reflete o status no momento da execução — se o responsável já tiver agido entre a programação e o envio, os dados podem estar desatualizados.