Nó notification

O nó notification envia uma notificação com base no modelo de evento selecionado do módulo Events. Os canais, idiomas e destinatários são retirados das configurações do modelo, e o nó passa os valores das variáveis para o modelo.

O nó está localizado no painel esquerdo, ao lado dos nós telegram e whatsapp. Ele possui uma entrada e uma saída.

---

Configurações do nó notification

1. Nome

Campo para especificar o nome do nó.
O nome é exibido na área de trabalho e ajuda a identificar facilmente o nó.
Se deixado em branco, o nó será chamado de notification.

Exemplo:

• Nome do nó: enviar código do pedido

---

2. Modelo de evento

Seção onde o modelo de evento é selecionado e os dados para ele são definidos.

Modelo

Lista suspensa de modelos. Nela são exibidos os eventos do módulo Events que estão marcados como modelos para o fluxo (caixa de seleção Usar como modelo para fluxo nas configurações do evento) — até 100 itens. O nome é exibido no idioma atual da interface.

Enquanto o modelo não for selecionado, o campo exibe — selecione o modelo —. A seleção pode ser redefinida clicando no "X" no campo.

info

Ao mudar o modelo, os valores das variáveis e o caminho para os destinatários são limpos — eles precisam ser preenchidos novamente.

Informações sobre o modelo

Após a seleção, um cartão do modelo aparece abaixo da lista:

• Nome do modelo — nome do modelo.
• Canais — canais de envio incluídos no modelo: Email, Push, WebSocket.
• Destinatários — para quem o modelo envia a notificação.
• Idiomas — idiomas nos quais o modelo está preenchido.

Possíveis valores para Destinatários:

Valor	Quem receberá a notificação
Todos os usuários	todos os usuários
Assinantes	assinantes
Grupo de usuários	grupo de usuários
Usuário alvo	usuário alvo
Registrados	registrados
Todos	todos
IDs de usuários do fluxo	usuários cujos identificadores são passados pelo fluxo
Endereços de email do fluxo	endereços de email que são passados pelo fluxo

Se algo estiver errado com o modelo selecionado, o formulário avisa:

• Falha ao carregar a lista de modelos. — a lista de modelos não foi carregada.
• Modelo não encontrado. Pode ter sido excluído. — modelo não encontrado, pode ter sido excluído.
• O evento selecionado não é mais um modelo. — a marcação de modelo foi removida do evento selecionado.

---

3. Destinatários

O bloco aparece apenas se no modelo os destinatários forem IDs de usuários do fluxo ou Endereços de email do fluxo. Ele contém um campo com o caminho para o array de destinatários na mensagem do fluxo, no formato Mustache:

• Caminho para IDs de usuários na mensagem — para IDs de usuários do fluxo, dica no campo: {{msg.payload.userIds}};
• Caminho para endereços de email na mensagem — para Endereços de email do fluxo, dica no campo: {{msg.payload.emails}}.

Exemplo:

{{msg.payload.userIds}}

---

4. Variáveis do modelo

O bloco aparece se o modelo tiver variáveis personalizadas. Para cada variável, há um campo separado, rotulado com o nome da variável (ou seu marcador, se não houver nome).

O valor pode ser uma expressão Mustache ou uma string comum.

Exemplo:

{{msg.payload.code}}

Se a variável for removida do modelo, mas um valor para ela for mantido no nó, o formulário exibirá um aviso Essas variáveis não são mais usadas no modelo: com uma lista dessas variáveis e seus valores.

---

Parâmetros no esquema JSON

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

• name (string) - nome do nó
• eventId (number | null) - identificador do modelo de evento selecionado
• variables (object) - valores das variáveis do modelo: chave — marcador da variável, valor — expressão Mustache ou 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 para vários usuários, cujos identificadores 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:

• Modelo: modelo de evento, cujo destinatários são IDs de usuários do fluxo, e no texto há uma variável com o marcador code
• Caminho para IDs de usuários na mensagem: {{msg.payload.userIds}}
• Campo da variável code em Variáveis do modelo: {{msg.payload.code}}

Resultado:
A notificação será enviada para os usuários com identificadores 12 e 15 pelos canais incluídos no modelo, e no lugar da variável code, o texto será substituído por A-1024.