Rappels d'événements via webhooks dans Calendar

Ce guide explique comment créer un événement dans la partie Infomaniak Calendar (calendriers/agendas) de kMail avec un rappel d'événement via kChat. D'autres systèmes de discussion comme Slack peuvent être autorisés grâce au système de webhook, une méthode pour qu'une application ou un service envoie des informations à une autre application ou service en temps réel.

Cette fonction vous permettra d'être notifié dans le fil de discussion de votre choix lorsqu'un événement est proche. 

Configurer le webhook dans Calendar

Pour ajouter le webhook de votre système de discussion sur Calendar:

1. depuis un navigateur, se rendre sur la partie calendriers/agendas de kMail (calendar.infomaniak.com)
2. cliquer sur l'icône tout en haut à droite
3. dans la partie "Notifications personnalisées" cliquer sur le bouton Ajouter un webhook
   
   
4. définir:
   
   • (1) un nom pour facilement identifier le Webhook lorsque vous ajoutez des rappels
   • (2) l'URL du webhook (obtenu auprès de votre système de discussion - des exemples sont présentés plus bas dans la FAQ)
   • (3) les éléments (repris automatiquement de votre événement et/ou ajouté manuellement ici) et leur disposition dans le message qui sera envoyé:
     • insérer %subject% pour inclure le sujet de l'événement
     • insérer %date% pour inclure la date de l'événement
     • insérer %description% pour inclure la description de l'événement
     • insérer %location% pour inclure l'éventuelle localisation de l'événement
5. cliquer sur Valider

Créer un événement avec rappel par chat

Maintenant que kMail est lié à votre compte de système de discussion, vous pouvez choisir d'être notifié dans une discussion lorsque vous ajoutez un rappel à un événement:

1. depuis un navigateur, se rendre sur la partie calendriers/agendas de kMail (calendar.infomaniak.com)
2. créer un nouvel événement
3. cliquer en bas à droite pour afficher les champs supplémentaires
   
4. ajouter un rappel
   
5. dans le menu déroulant choisir le webhook configuré
6. valider les modifications

Vous recevrez désormais un rappel dans le chat correspondant au webhook.

Exemples pour l'obtention d'un webhook

kChat

1. ouvrir l'application kChat
2. se rendre dans la partie Intégrations
3. cliquer sur Webhooks entrants:
   
4. cliquer en haut à droite sur Ajouter
5. compléter les informations requises afin de créer le "bot" qui va poster les messages de relance dans kChat dans le canal de votre choix:
   
6. enregistrer pour obtenir l'URL du webhook:
   
7. créer la notification personnalisée dans Calendar (lire plus haut si nécessaire):
   
8. sélectionner votre notification personnalisée lors de l'ajout d'un rappel sur votre événement:
   

Slack

1. ouvrir cette page Slack et s'authentifier avec vos identifiants Slack
2. choisir le fil de discussion dans lequel vos rappels s'afficheront (par exemple @slackbot)
     
   
     
3. enregistrer pour obtenir l'URL du webhook

Créez d'autres webhooks pour définir des rappels dans d'autres fils de discussion.

Personnaliser les relances d'un rappel Slack

Vous pouvez librement utiliser les options de formatage de Slack dans vos notifications. Exemple:

Ne pas oublier de `%subject%` pour le %date%.
À prendre avec le jour J : %description%.
Lieu de l'événement :  `%location%`