Fonctionnalités

Notifications

Envoyer un e-mail, un SMS ou une notification système quand un document est créé, modifié, validé ou arrive à échéance.

1. Généralités

La cloche des notifications se trouve dans la barre d'icônes à gauche de l'écran, sous l'icône de recherche. Cliquez dessus pour ouvrir le panneau Notifications. Il contient les onglets Tous et Événements. Les icônes en haut du panneau ouvrent les Paramètres des notifications, marquent tout comme lu et ferment le panneau.

Un point rouge sur la cloche signale une notification non lue. Une notification lue reste dans l'historique.

2. Paramètres des notifications

Consultez les paramètres des notifications dans la démo

Chaque utilisateur règle ici ce qu'il reçoit par e-mail : assignations, mentions, partages de documents, rappels d'événements. Il peut aussi couper toutes les notifications.

3. Créer une notification

Une Notification est une règle : quand tel événement arrive sur tel type de document, Dokos envoie un message. Il faut le rôle Gestionnaire système.

Créer une notification dans la démo

  1. Ouvrez la recherche (Ctrl+K), saisissez Notification, puis cliquez sur Créer un·e Notification.
  2. Indiquez le Nom de la notification.
  3. Dépliez la section Canal d'envoi et sélectionnez le Canal : E-mail, Outil de collaboration externe (Slack, Rocket.Chat…), Notification système ou SMS.
  4. Dépliez la section Événement déclencheur.

  1. Sélectionnez le Type de document, puis l'événement dans Envoyer une alerte lors de l'événement.
ÉvénementDéclenchement
Nouveauà la création d'un document.
Enregistrer / Valider / Annulerà l'enregistrement, à la validation ou à l'annulation.
Jours suivants / Jours précedentsun nombre de jours après ou avant une Date de référence du document (champ Jours précédents ou suivants). Contrôle quotidien. Pour répéter l'envoi, voir Répéter une notification « Jours suivants ».
Minutes Après / Minutes Avantun nombre de minutes après ou avant une Date et heure de référence.
Modification de valeurquand le champ choisi dans Valeur modifiée change.
Méthodequand la méthode saisie dans Méthode de déclenchement s'exécute, par exemple on_payment_authorized.
Automatisationseulement quand un flux d'automatisation l'envoie avec l'étape Trigger Notification.
  1. Ajoutez une condition si besoin. Le Type de condition vaut « Python » (champ Condition, par exemple doc.grand_total > 1000) ou « Filtres » (un éditeur de filtres).
  2. Dans Destinataires, ajoutez une ligne par destinataire : un champ du document qui contient une adresse (par exemple owner), un rôle, ou des adresses fixes en copie (CC, une adresse par ligne). La case Envoyer à tous les utilisateurs assignés au document ajoute les utilisateurs assignés.

  1. Dans la section Message, renseignez le Sujet et le Message. L'Editeur définit le format du message (Markdown par défaut). Utilisez Jinja pour les données du document, par exemple {{ doc.name }} ou {{ doc.grand_total }}.
  2. Enregistrez.

Options utiles :

  • Joindre une impression de document : joint le PDF du document, avec le Format d'impression choisi.
  • Joindre des fichiers : joint les fichiers du document, tous ou ceux d'un champ.
  • Modifier une propriété après la notification : écrit une Valeur à définir dans un champ du document après l'envoi.
  • Envoyer une notification système : ajoute une notification dans la cloche, en plus de l'e-mail.

Répéter une notification « Jours suivants »

Avec l'événement « Jours suivants », une notification est envoyée une seule fois par document, le jour de la Date de référence décalé du nombre de jours indiqué. Pour un rappel répété, utilisez un flux d'automatisation :

  1. Dans la notification, choisissez l'événement Automatisation. La notification n'est alors envoyée que par un flux. Gardez le canal, les destinataires, le contenu et la condition.
  2. Créez un flux avec le déclencheur Basé sur une date et une Récurrence. Voir Répéter le déclenchement.
  3. Ajoutez au flux une étape Trigger Notification (libellé non traduit) qui envoie cette notification. Voir Trigger Notification.

La condition de la notification est toujours vérifiée à chaque envoi. Dans le modèle, automation.payload.occurrence donne le numéro de l'envoi, à partir de 0.

Exemple fictif : vous voulez relancer chaque semaine, 4 fois, un ToDo resté ouvert, à partir de 2 jours après sa date.

  1. La notification « Relance ToDo ouverte » porte sur le type de document ToDo, avec l'événement Automatisation et la condition Python doc.status == "Open". Son sujet est Relance {{ automation.payload.occurrence }}.
  2. Le flux porte sur ToDo, avec le déclencheur Basé sur une date, un Décalage de date (jours) de 2, le Sens de la date « Après » et la Récurrence « chaque semaine, 4 fois » (fréquence Hebdomadaire, Repeat count à 4).
  3. Le flux a une étape Trigger Notification avec {"notification": "Relance ToDo ouverte"}.
Les champs de répétition de la notification (répétition, intervalle, unité, nombre maximal d'envois) n'existent plus. À la mise à jour (bench migrate), Dokos crée un flux pour chaque notification « Jours suivants » qui se répétait, avec la même date, le même décalage, la même règle et la même condition. La notification passe à l'événement Automatisation : elle n'est pas envoyée deux fois.

Utiliser un modèle d'e-mail

Avec le canal E-mail, vous pouvez choisir un Modèle d'e-mail. Le sujet et le message viennent alors du modèle, et les champs Sujet et Message sont masqués. Une modification du modèle s'applique à toutes les notifications qui l'utilisent, au prochain envoi.

  • Dans le modèle, les champs du document s'écrivent sans le préfixe doc., par exemple {{ grand_total }}.
  • Le modèle n'est accepté qu'avec le canal E-mail, et il doit avoir un contenu.

Exemple fictif : la notification « Confirmation de commande client » (Type de document : Commande client, Événement : Valider) utilise le modèle « Confirmation de commande ». L'objet du modèle est Votre commande {{ name }} est confirmée.

4. Canal d'envoi

4.1. Notifications des outils collaboratifs

Le canal Outil de collaboration externe envoie le Sujet et le Message vers un outil comme Slack ou Rocket.Chat. Choisissez l'adresse dans le champ URL de webhook entrant de l'outil de collaboration. La section Destinataires est masquée pour ce canal.

4.2. Notifications système

Le canal Notification système ajoute la notification dans le panneau de la cloche des destinataires, sans e-mail.

4.3. SMS

Pour utiliser ce canal, configurez d'abord les Paramètres des SMS.

5. Tester

Enregistrez la notification, puis cliquez sur Actions > Tester cette notification. Choisissez un document : Dokos envoie la notification pour ce document. Le bouton Aperçu montre, pour un document, si la condition est remplie, le sujet et le message.