1 000 FAQ, 500 tutoriels et vidéos explicatives. Ici, il n'y a que des solutions !
Rappel d'évènement via 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.
Cette fonction vous permettra d'être notifié dans le fil de discussion de votre choix lorsqu'un évènement est proche.
Qu'est-ce qu'un webhook ?
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.
Annoncer le webhook Ă Calendar
Pour ajouter le webhook de votre système de discussion sur Calendar:
- se connecter Ă Calendar (calendar.infomaniak.com), la partie calendriers/agendas d'Infomaniak Mail, depuis un navigateur Web comme Brave ou Firefox
- cliquer sur l'icĂ´ne en haut Ă droite de l'interface
- cliquer sur le bouton Ajouter un webhook (dans la partie Notifications personnalisées)
- définir:
- (A) un nom pour facilement identifier le Webhook lorsque vous ajoutez des rappels
- (B) l'URL du webhook (obtenu auprès de votre système de discussion - des exemples sont présentés plus bas dans la FAQ)
- (C) 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
- cliquer sur Valider
Créer 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:
- se connecter Ă Calendar (calendar.infomaniak.com) depuis un navigateur Web comme Brave ou Firefox
- créer un nouvel évènement
- cliquer en bas à droite pour afficher les champs supplémentaires
- ajouter un rappel
- dans le menu déroulant choisir le webhook configuré
- valider les modifications
Vous recevrez désormais un rappel dans le chat correspondant au webhook.
Exemples pour l'obtention d'un webhook
kChat
- ouvrir l'application kChat
- se rendre dans la partie Intégrations
- cliquer sur Webhooks entrants:
- cliquer en haut Ă droite sur Ajouter
- 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:
- enregistrer pour obtenir l'URL du webhook:
- créer la notification personnalisée dans Calendar (lire plus haut si nécessaire):
- sélectionner votre notification personnalisée lors de l'ajout d'un rappel sur votre évènement:
Slack
- ouvrir cette page Slack et s'authentifier avec vos identifiants Slack
- choisir le fil de discussion dans lequel vos rappels s'afficheront (par exemple @slackbot ou #general)
- enregistrer pour obtenir l'URL du webhook
Créer 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%`