Notifications (facultatif)

Kuro envoie une notification quand quelque chose demande votre attention. Vous choisissez les événements, la portée et les canaux dans Paramètres › Notifications.

​

Événements

​

Canaux

• Webhook : un POST JSON vers l’URL de votre choix, en https://. Avec un secret, chaque envoi porte l’en-tête X-Kuro-Signature: sha256=<HMAC-SHA256 du corps> : vérifiez-le avant de faire confiance au message. X-Kuro-Event donne le type, X-Kuro-Delivery l’identifiant.
• Discord et Slack : collez l’URL du webhook entrant de votre salon ; le message est mis en forme (embed, blocks) dans la langue du canal.

L’URL et le secret sont chiffrés et ne sont jamais réaffichés. Le bouton Tester envoie un événement test et affiche la réponse du destinataire.

​

Par serveur

Sur la page d’un serveur, l’onglet Notifications tient ses abonnements : une destination (webhook, Discord ou Slack, propre à ce serveur) et les événements de ce serveur qu’elle reçoit. Tout se règle là, sans passer par les paramètres ; la destination disparaît avec le serveur. Avec le droit de voir les paramètres, un abonnement peut aussi viser un canal partagé de l’équipe. Les droits servers.notifications.read et servers.notifications.manage suffisent pour cette page.

​

Règles

Une règle lie des événements à des canaux, pour tout, un nœud ou un serveur. Un canal visé par plusieurs règles ne reçoit qu’un message par événement.

​

Journal des envois

Les envois sont gardés trente jours. Un envoi refusé est repris après 1, 5 puis 30 minutes, puis abandonné ; au-delà de trente envois par minute sur un canal, les suivants attendent la minute d’après.