Ce guide explique comment obtenir des rappels d'évènement de l'app Web Calendar Infomaniak (service en ligne ksuite.infomaniak.com/calendar) sur un système de discussion comme kChat afin d'être notifié dans le fil de discussion de votre choix lorsqu'un évènement est proche.

⚠  Disponible avec :

* limité à 1 webhook

Prérequis

• Créer sur l'app kChat un webhook entrant, afin d'obtenir une URL de type https://your-server-kchat.xyz/hooks/xxx-key-generated-xxx:
  

Lier le webhook kChat à Calendar

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

1. Cliquez ici afin d'accéder à l'app Web Calendar Infomaniak (service en ligne ksuite.infomaniak.com/calendar).
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).
   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 le bouton pour Ajouter l'élément configuré et le voir désormais créé:
   

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 Infomaniak (service en ligne ksuite.infomaniak.com/calendar).
2. Cliquez sur le bouton ‍ Créer en haut à gauche.
3. Cliquez sur Evènement:
   
   1. Vous pourriez aussi cliquer sur un évènement existant sur le calendrier pour le modifier.
4. Entrez les détails de l'évènement.
5. Affichez les champs supplémentaires:
   
6. Cliquez sur Ajouter un rappel pour le configurer:
   
7. Dans le menu déroulant des types de rappel, choisissez le webhook configuré (selon le nom donné au point 5a ci-dessus).
8. Sauvegardez l'évènement en bas de page:
   
9. Lorsque le moment du rappel arrive, un message (sous la forme configurée au point 5c ci-dessus) est bien envoyé sur kChat au sujet de l'évènement, sur le canal configuré dans le webhook de kChat (cf prérequis ci-dessus):
   

Et sur d'autres systèmes de discussion ?

Slack

1. Cliquez ici afin d'accéder aux WebHooks Slack.
2. Choisissez le fil de discussion dans lequel vos rappels s'afficheront (par exemple @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.

Vous pouvez librement utiliser les options de formatage de Slack dans vos notifications. Exemple en français :

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