Pular para o conteúdo principal

Nó notification

O nó notification envia uma notificação usando o modelo de evento selecionado no módulo Events (abre em uma nova aba). Os canais, os idiomas e os destinatários vêm das configurações do modelo, e o nó passa ao modelo os valores das variáveis.

O nó fica no painel esquerdo, ao lado dos nós telegram e whatsapp. Ele tem uma entrada e uma saída.

Configurações do nó notification​

1. Name​

Nome do nó.
O nome aparece na área de trabalho e ajuda a identificar o nó.
Se você deixar o campo vazio, o nó se chamará notification.

Exemplo:

  • Nome do nó: send order code

2. Event template​

Aqui você seleciona o modelo de evento e define os dados para ele.

Template​

Lista suspensa de modelos. Ela mostra até 100 eventos do módulo Events marcados como modelos para o fluxo (caixa de seleção Use as a template for workflow nas configurações do evento). Os nomes aparecem no idioma atual da interface.

Enquanto nenhum modelo estiver selecionado, o campo exibe — select template —. Para limpar a seleção, clique no X do campo.

info

Ao trocar de modelo, os valores das variáveis e o caminho para os destinatários são apagados, e é preciso preenchê-los de novo.

Informações sobre o modelo​

Depois que você seleciona um modelo, aparece abaixo da lista um cartão do modelo:

  • Template name: nome do modelo.
  • Channels: canais de envio ativados no modelo (Email, Push, WebSocket).
  • Recipients: a quem o modelo envia a notificação.
  • Locales: idiomas em que o modelo está preenchido.

Valores possíveis de Recipients:

ValorQuem recebe a notificação
All userstodos os usuários
Subscribersassinantes
User groupum grupo de usuários
Target usero usuário-alvo
Registeredusuários registrados
Everyonetodos
User IDs from workflowusuários cujos IDs o fluxo passa
Email addresses from workflowendereços de email que o fluxo passa

Se houver algum problema com o modelo selecionado, o formulário exibe um aviso:

  • Failed to load the list of templates. Não foi possível carregar a lista de modelos.
  • Template not found. It may have been deleted. O modelo não foi encontrado; talvez tenha sido excluído.
  • The selected event is no longer a template. O evento selecionado deixou de estar marcado como modelo.

3. Recipients​

Este bloco só aparece se os destinatários do modelo forem User IDs from workflow ou Email addresses from workflow. Ele tem um único campo: o caminho, no formato Mustache, para o array de destinatários na mensagem do fluxo.

  • Path to user IDs in the message: para User IDs from workflow. Texto de ajuda no campo: {{msg.payload.userIds}}.
  • Path to email addresses in the message: para Email addresses from workflow. Texto de ajuda no campo: {{msg.payload.emails}}.

Exemplo:

{{msg.payload.userIds}}

4. Template variables​

Este bloco aparece se o modelo tiver variáveis personalizadas. Cada variável tem um campo próprio, identificado pelo nome da variável (ou pelo marcador, se ela não tiver nome).

O valor é uma expressão Mustache ou uma string comum.

Exemplo:

{{msg.payload.code}}

Se uma variável for removida do modelo, mas o nó ainda tiver um valor salvo para ela, o formulário exibe o aviso These variables are no longer used in the template: com a lista dessas variáveis e de seus valores.

Parâmetros no esquema JSON​

No esquema JSON do fluxo, as configurações do nó ficam armazenadas assim:

  • name (string) - nome do nó
  • eventId (number | null) - ID do modelo de evento selecionado
  • variables (object) - valores das variáveis do modelo: a chave é o marcador da variável, e o valor é uma expressão Mustache ou uma string
  • recipientsPath (string) - caminho para o array de destinatários na mensagem

Exemplo de uso​

Exemplo 1: notificação para usuários passados pelo fluxo​

Tarefa:
Enviar o código do pedido a vários usuários cujos IDs são calculados pelo fluxo.

Fluxo:

[inject] ---> [function] ---> [notification]

Código do nó function:

msg.payload = {
  userIds: [12, 15],
  code: "A-1024"
};
return msg;

Configurações do nó notification:

  • Template: um modelo de evento cujos destinatários são User IDs from workflow e cujo texto contém uma variável com o marcador code
  • Path to user IDs in the message: {{msg.payload.userIds}}
  • Campo da variável code em Template variables: {{msg.payload.code}}

Resultado:
A notificação será enviada aos usuários com IDs 12 e 15 pelos canais ativados no modelo, e o texto receberá A-1024 no lugar da variável code.

Última atualização a