Bercail · Documentation

Notifications

Bercail peut prévenir le foyer sans qu’on ouvre l’application : un produit qui périme, un article à racheter, une garantie qui se termine. Les rappels partent vers Discord ou Telegram, et se règlent dans Paramètres du foyer → Notifications.

Les canaux

Un canal est une destination : un salon Discord (par son adresse de webhook) ou une conversation Telegram (par le jeton d’un bot et l’identifiant de la conversation). Un foyer peut avoir plusieurs canaux, et chacun reçoit les rappels qui le concernent.

Aucun envoi n’a lieu tant qu’aucun canal n’est configuré : les règles peuvent exister sans canal, elles ne produisent simplement rien.

Les règles

Une règle décide de ce qui déclenche un rappel, et sur quels canaux. Les règles proposées :

RègleCe qu’elle annonceDélai par défaut
Bernard : bientôt périméLes produits qui arrivent à péremption3 jours avant
Bernard : périméLes produits périmés—
Bernard : produit entaméUn produit ouvert depuis un moment5 jours après l’ouverture
Léon : à racheterLes articles passés sous leur seuil de rachat—
Annie : fin de garantieLes garanties qui se terminent30 jours avant

Chaque règle a son propre délai : par exemple « 3 jours avant la péremption », « 7 jours avant la fin de garantie ». Les rappels de Bernard et de Léon partent dans le récapitulatif, ceux d’Annie partent dès que le seuil est franchi.

Le récapitulatif

Plutôt que d’envoyer un message par produit, Bercail peut envoyer un récapitulatif : un seul message, à l’heure choisie, qui liste ce qui compte. Les jours de la semaine et l’heure se règlent (tous les jours à 8 h par défaut), avec la possibilité de ne rien envoyer quand rien n’a changé. C’est le réglage conseillé pour un foyer actif.

Foyers de démonstration

Un foyer de démonstration n’envoie aucune notification : la démo publique ne peut donc pas inonder un canal Discord ou Telegram.

Bon à savoir

  • Un webhook Discord ou un jeton de bot est un secret : il donne le droit d’écrire dans le salon. Traitez-le

comme un mot de passe, et révoquez-le côté Discord ou Telegram s’il fuite.

  • Les notifications ne remplacent pas l’application : elles signalent, l’application permet d’agir.