Aller au contenu principal

Nœud notification

Le nœud notification envoie une notification à partir d'un modèle d'événement choisi dans le module Events (s'ouvre dans un nouvel onglet). Les canaux, les langues et les destinataires viennent des paramètres du modèle, et le nœud transmet au modèle les valeurs des variables.

Le nœud se trouve dans le panneau de gauche, à côté des nœuds telegram et whatsapp. Il a une entrée et une sortie.

Paramètres du nœud notification​

1. Name​

Nom du nœud.
Il s'affiche dans l'espace de travail et vous aide à identifier le nœud.
Si vous laissez le champ vide, le nœud s'appelle notification.

Exemple :

  • Nom du nœud : send order code

2. Event template​

Ici, vous choisissez le modèle d'événement et définissez ses données.

Template​

Liste déroulante des modèles. Elle affiche jusqu'à 100 événements du module Events marqués comme modèles pour le flux (case Use as a template for workflow dans les paramètres de l'événement). Les noms s'affichent dans la langue actuelle de l'interface.

Tant qu'aucun modèle n'est choisi, le champ affiche — select template —. Pour annuler la sélection, cliquez sur la croix dans le champ.

info

Lorsque vous changez de modèle, les valeurs des variables et le chemin vers les destinataires sont effacés. Vous devez les renseigner à nouveau.

Informations sur le modèle​

Une fois le modèle choisi, sa fiche apparaît sous la liste :

  • Template name : nom du modèle.
  • Channels : canaux d'envoi activés dans le modèle (Email, Push, WebSocket).
  • Recipients : destinataires auxquels le modèle envoie la notification.
  • Locales : langues dans lesquelles le modèle est rempli.

Valeurs possibles de Recipients :

ValeurQui reçoit la notification
All userstous les utilisateurs
Subscribersles abonnés
User groupun groupe d'utilisateurs
Target userl'utilisateur cible
Registeredles utilisateurs inscrits
Everyonetout le monde
User IDs from workflowles utilisateurs dont le flux transmet les identifiants
Email addresses from workflowles adresses e-mail transmises par le flux

Si le modèle choisi pose problème, le formulaire affiche un avertissement :

  • Failed to load the list of templates. : la liste des modèles n'a pas pu être chargée.
  • Template not found. It may have been deleted. : le modèle est introuvable, il a peut-être été supprimé.
  • The selected event is no longer a template. : l'événement choisi n'est plus marqué comme modèle.

3. Recipients​

Ce bloc n'apparaît que si les destinataires du modèle sont User IDs from workflow ou Email addresses from workflow. Il contient un seul champ : le chemin, au format Mustache, vers le tableau des destinataires dans le message du flux.

  • Path to user IDs in the message : pour User IDs from workflow ; texte indicatif du champ : {{msg.payload.userIds}} ;
  • Path to email addresses in the message : pour Email addresses from workflow ; texte indicatif du champ : {{msg.payload.emails}}.

Exemple :

{{msg.payload.userIds}}

4. Template variables​

Ce bloc apparaît si le modèle contient des variables personnalisées. Chaque variable a son propre champ, intitulé du nom de la variable (ou de son marqueur si elle n'a pas de nom).

La valeur est une expression Mustache ou une simple chaîne.

Exemple :

{{msg.payload.code}}

Si une variable a été retirée du modèle alors que le nœud conserve une valeur pour elle, le formulaire affiche l'avertissement These variables are no longer used in the template: avec la liste de ces variables et de leurs valeurs.

Paramètres dans le schéma JSON​

Dans le schéma JSON du flux, les paramètres du nœud sont stockés ainsi :

  • name (string) - nom du nœud
  • eventId (number | null) - identifiant du modèle d'événement choisi
  • variables (object) - valeurs des variables du modèle : la clé est le marqueur de la variable, la valeur est une expression Mustache ou une chaîne
  • recipientsPath (string) - chemin vers le tableau des destinataires dans le message

Exemple d'utilisation​

Exemple 1 : notification aux utilisateurs transmis par le flux​

Tâche :
Envoyer un code de commande à plusieurs utilisateurs dont le flux calcule les identifiants.

Flux :

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

Code du nœud function :

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

Paramètres du nœud notification :

  • Template : un modèle d'événement dont les destinataires sont User IDs from workflow et dont le texte contient une variable avec le marqueur code
  • Path to user IDs in the message : {{msg.payload.userIds}}
  • Champ de la variable code dans Template variables : {{msg.payload.code}}

Résultat :
La notification est envoyée aux utilisateurs dont les identifiants sont 12 et 15, par les canaux activés dans le modèle, et A-1024 remplace la variable code dans le texte.

Dernière mise à jour le