Créer un rappel d'évènement par webhooks avec Calendar

Ce guide explique comment obtenir des rappels d'évènement Infomaniak Calendar sur un système de discussion comme kChat ou Slack.

Préambule

• Cette fonctionnalité vous permettra d'être notifié dans le fil de discussion de votre choix lorsqu'un évènement est proche.
• Le système de webhook est une méthode pour qu'une application ou un service envoie des informations à une autre application ou service en temps réel, de façon sécurisée et authentifiée.

Annoncez le webhook à Calendar

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

1. Cliquez ici afin d'accéder à l'app Web Calendar (service en ligne calendar.infomaniak.com).
2. Cliquez sur l'icône Paramètres ‍ en haut à droite.
3. Cliquez sur Intégrations dans le menu latéral gauche.
4. Cliquez sur le bouton Ajouter un webhook:
   
    
5. Définissez :
   
   1. Un nom pour identifier facilement le Webhook lorsque vous ajoutez des rappels.
   2. L'URL du webhook (obtenue 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és manuellement ici) et leur disposition dans le message qui sera envoyé :
      • Insérez %subject% pour inclure le sujet de l'évènement.
      • Insérez %date% pour inclure la date de l'évènement.
      • Insérez %description% pour inclure la description de l'évènement.
      • Insérez %location% pour inclure l'éventuelle localisation de l'évènement.
6. Cliquez sur Ajoutez.

Créez un évènement avec rappel par chat

Maintenant que Calendar 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. Cliquez ici afin d'accéder à l'app Web Calendar (service en ligne calendar.infomaniak.com).
2. Créez un nouvel évènement.
3. Cliquez en bas à droite pour afficher les champs supplémentaires:
   
4. Ajoutez un rappel:
   
5. Dans le menu déroulant, choisissez le webhook configuré.
6. Validez les modifications.

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

Exemples pour l'obtention d'un webhook

kChat

1. Cliquez ici afin d'accéder à l'app Web kChat (service en ligne kchat.infomaniak.com) ou ouvrez l'app desktop kChat (application de bureau sur macOS / Windows / Linux).
2. Rendez-vous dans la partie Intégrations.
3. Cliquez sur Webhooks entrants :
   
4. Cliquez en haut à droite sur Ajouter.
5. Complétez 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. Enregistrez pour obtenir l'URL du webhook:
   
7. Créez la notification personnalisée dans Calendar (lire plus haut si nécessaire):
   
8. Sélectionnez votre notification personnalisée lors de l'ajout d'un rappel sur votre évènement:
   

Slack
 

1. Cliquez ici afin d'accéder aux WebHooks Slack.
2. Choisissez le fil de discussion dans lequel vos rappels s'afficheront (p. ex. @slackbot ou #general):
   
3. Enregistrez pour obtenir l'URL du webhook.

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

Personnalisez les relances d'un rappel Slack

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

N'oubliez pas de %subject% pour le %date%.
À prendre avec le jour J : %description%.
Lieu de l'évènement : %location%