Aller au contenu principal

Noeud notification

Le noeud notification envoie une notification selon le modèle d'événement sélectionné dans le module Events. Les canaux, langues et destinataires sont tirés des paramètres du modèle, et le noeud transmet les valeurs des variables au modèle.

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

Paramètres du noeud notification​

1. Nom​

Champ pour indiquer le nom du noeud.
Le nom s'affiche dans l'espace de travail et aide à identifier facilement le noeud.
S'il est laissé vide, le noeud sera nommé notification.

Exemple :

  • Nom du noeud : envoyer le code de commande

2. Modèle d'événement​

Section où le modèle d'événement est sélectionné et où les données sont définies pour celui-ci.

Modèle​

Liste déroulante des modèles. Elle affiche les événements du module Events qui sont marqués comme modèles pour le flux (case à cocher Utiliser comme modèle pour le flux dans les paramètres de l'événement), jusqu'à 100. Le nom est pris dans la langue actuelle de l'interface.

Tant qu'aucun modèle n'est sélectionné, le champ indique — sélectionner un modèle —. La sélection peut être réinitialisée avec la croix dans le champ.

info

Lors du changement de modèle, les valeurs des variables et le chemin vers les destinataires sont effacés — ils doivent être remplis à nouveau.

Informations sur le modèle​

Après la sélection, une carte du modèle apparaît sous la liste :

  • Nom du modèle — nom du modèle.
  • Canaux — canaux d'envoi inclus dans le modèle : Email, Push, WebSocket.
  • Destinataires — à qui le modèle envoie la notification.
  • Locales — langues dans lesquelles le modèle est rempli.

Valeurs possibles pour Destinataires :

ValeurQui recevra la notification
Tous les utilisateurstous les utilisateurs
Abonnésabonnés
Groupe d'utilisateursgroupe d'utilisateurs
Utilisateur cibleutilisateur cible
Enregistrésenregistrés
Tout le mondetous
Identifiants d'utilisateurs du fluxutilisateurs dont les identifiants sont transmis par le flux
Adresses e-mail du fluxadresses e-mail transmises par le flux

Si quelque chose ne va pas avec le modèle sélectionné, le formulaire avertit :

  • Échec du chargement de la liste des modèles. — la liste des modèles n'a pas été chargée.
  • Modèle non trouvé. Il a peut-être été supprimé. — modèle non trouvé, il a peut-être été supprimé.
  • L'événement sélectionné n'est plus un modèle. — l'événement sélectionné n'est plus marqué comme modèle.

3. Destinataires​

Le bloc apparaît uniquement si dans le modèle les destinataires sont Identifiants d'utilisateurs du flux ou Adresses e-mail du flux. Il contient un champ avec le chemin vers le tableau des destinataires dans le message du flux, au format Mustache :

  • Chemin vers les identifiants d'utilisateurs dans le message — pour Identifiants d'utilisateurs du flux, indice dans le champ : {{msg.payload.userIds}};
  • Chemin vers les adresses e-mail dans le message — pour Adresses e-mail du flux, indice dans le champ : {{msg.payload.emails}}.

Exemple :

{{msg.payload.userIds}}

4. Variables du modèle​

Le bloc apparaît si le modèle contient des variables personnalisées. Pour chaque variable, un champ distinct est étiqueté avec le nom de la variable (ou son marqueur, s'il n'y a pas de nom).

La valeur peut être une expression Mustache ou une chaîne ordinaire.

Exemple :

{{msg.payload.code}}

Si la variable a été retirée du modèle, mais qu'une valeur est conservée pour elle dans le noeud, le formulaire affiche un avertissement Ces variables ne sont plus utilisées dans le modèle : avec une 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 noeud sont stockés comme suit :

  • name (string) - nom du noeud
  • eventId (number | null) - identifiant du modèle d'événement sélectionné
  • variables (object) - valeurs des variables du modèle : clé — marqueur de la variable, valeur — expression Mustache ou 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 le code de commande à plusieurs utilisateurs, dont les identifiants sont calculés par le flux.

Flux :

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

Code du noeud function :

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

Paramètres du noeud notification :

  • Modèle : modèle d'événement dont les destinataires sont Identifiants d'utilisateurs du flux, et dans le texte, il y a une variable avec le marqueur code
  • Chemin vers les identifiants d'utilisateurs dans le message : {{msg.payload.userIds}}
  • Champ de la variable code dans Variables du modèle : {{msg.payload.code}}

Résultat :
La notification sera envoyée aux utilisateurs avec les identifiants 12 et 15 par les canaux inclus dans le modèle, et à la place de la variable code, le texte affichera A-1024.