Notification

À quoi sert une notification

On configure des notifications pour rappeler des activités. Exemples de la page :

1. La date de fin d'une tâche.
2. La date de livraison prévue d'une commande client.
3. La date de paiement prévue.
4. Un rappel de relance.
5. Une commande reçue ou envoyée au-dessus d'un montant.
6. L'expiration d'un contrat.
7. La fin ou le changement de statut d'une tâche.

La liste est dans Accueil > Paramètres > Notification.

Poser une alerte

1. Choisissez l'événement dans Envoyer l'alerte lors de (Send Alert On) :
   1. Nouveau. Un nouveau document du type choisi est créé.
   2. Enregistrer, valider, annuler.
   3. Jours avant ou jours après. L'alerte part quelques jours avant ou après la date de référence. Le nombre de jours se règle dans Jours avant ou après. Utile pour une échéance ou une relance de devis.
   4. Changement de valeur. Une valeur précise du type change.
   5. Méthode. Une méthode précise est appelée, par exemple before_insert.
   6. Personnalisé. Notification vers un compte e-mail choisi.
2. Choisissez le type de document. Depuis la version 16, un type enfant est possible si l'événement est Jours avant ou Jours après.
3. Posez des conditions si besoin.
4. Indiquez les destinataires : un champ du document, ou une liste d'adresses fixes.
5. Rédigez le message.
6. Enregistrez.

Objet

On lit un champ avec doc.[field_name], entouré de {{ }}. Ce sont des balises Jinja. Le nom du document est {{ doc.name }}. L'exemple envoie un e-mail à l'enregistrement d'une tâche, avec l'objet « TASK#### has been created ».

Conditions

La condition porte sur les champs du document. Pour un e-mail quand un prospect est enregistré avec le statut Interested : doc.status == "Interested". On combine avec and ou or.

L'exemple illustré envoie une notification quand une tâche est enregistrée au statut Open et que la date de fin prévue est le jour de l'enregistrement ou avant.

Message

Le corps accepte les balises Jinja ({{ doc.[field_name] }}) et le HTML. L'exemple de la source, pour une commande en retard :

<h3>Order Overdue</h3>
Transaction {{ doc.name }} has exceeded Due Date. Please take necessary action.
{% if comments %}
Last comment: {{ comments[-1].comment }} by {{ comments[-1].by }}
{% endif %}
<h4>Details</h4>
* Customer: {{ doc.customer }}
* Amount: {{ doc.total_amount }}

Éviter les envois en double

On peut créer, via Personnaliser le formulaire, une propriété du type « Notification envoyée », puis la renseigner dans Définir la propriété après l'alerte (Set Property After Alert). Cette propriété sert ensuite de condition pour ne plus renvoyer le message.

L'exemple de la page montre d'abord les critères, puis les destinataires et le message.

Slack

Dans le canal, choisissez Slack et l'URL de webhook Slack.

Une URL de webhook pointe vers un canal Slack. Pour la créer :

1. Allez sur https://api.slack.com/slack-apps.
2. Créez une application Slack.
3. Donnez-lui un nom et choisissez l'espace de travail. Dans Incoming Webhooks, ajoutez un webhook à l'espace.
4. Copiez le lien. Dans ERPNext, créez une URL de webhook Slack dans Intégrations > URL de webhook Slack.
5. Dans la notification, choisissez Slack et le canal.

Slack n'accepte pas le HTML. Le formatage est en markdown. La page renvoie à la documentation Slack. Exemple :

*Order Overdue*
Transaction {{ doc.name }} has exceeded Due Date. Please take the necessary action.
{% if comments %}
Last comment: {{ comments[-1].comment }} by {{ comments[-1].by }}
{% endif %}
*Details*
• Customer: {{ doc.customer }}
• Amount: {{ doc.grand_total }}

Notifications système

En version 12, des notifications système couvrent les assignations, les mentions, les documents partagés et les points d'énergie. Elles apparaissent dans le menu de notifications, en haut à droite.

En version 13, le canal Notifications système envoie une notification dans ce menu au lieu d'un e-mail ou d'un message Slack. Un clic ouvre le journal de notification (Notification Log) : objet, message, et fichier joint si Joindre l'impression est coché.

Si l'on veut à la fois l'e-mail ou Slack et la notification système, le canal principal reste E-mail ou Slack, et l'option de notification système se coche en plus.

WhatsApp

En version 13, le canal WhatsApp envoie vers un numéro WhatsApp. Choisissez WhatsApp et le numéro Twilio. Les numéros Twilio se ajoutent dans les réglages Twilio de Frappe. Les messages ne partent que vers des numéros qui portent un indicatif de pays.

Les identifiants Twilio se lisent dans les paramètres du compte Twilio. On ne peut ajouter que les numéros activés sur ce compte avec l'accès WhatsApp.

WhatsApp n'autorise que les modèles de message préapprouvés. Ne pas les respecter peut restreindre le compte Twilio.

SMS

En version 13, le canal SMS exige les réglages SMS.

Rappel ponctuel

> [!NOTE] > La page indique que les rappels ponctuels ne sont disponibles, pour l'instant, que dans la version nightly.

Le framework permet un rappel isolé, par exemple « Rappelle-moi de relancer ce prospect dans 4 heures », sans monter une notification complète.

1. Ouvrez le document.
2. Menu (trois points) > Me le rappeler (Remind Me).
3. Choisissez l'heure, ajoutez une description, puis Créer.
4. Le système envoie une notification système autour de l'heure choisie, avec cette description comme objet.

Pages liées

• Suivi de document