LogoDocs

Le webhook pour vos apps de messagerie

👉Vous pouvez maintenant recevoir des notifications dans un canal Slack, Google Chat ou Microsoft Teams en temps rĂ©el depuis chacune de vos Vitres đŸ„ł

Quelles notifications ?

  • Les toc-tocs peuvent ĂȘtre signalĂ©s en parallĂšle sur un canal de messagerie
  • Un invitĂ© demande Ă  rejoindre une de vos Vitres ? Vous ĂȘtes instantanĂ©ment notifiĂ© sur le canal de votre choix en plus du message habituel sur la Vitre.

Pour qui ?

La configuration est faite par les administrateurs seulement, mais les canaux de rĂ©ception de ces notifications peuvent ĂȘtre accessibles Ă  tous.
C’est pratique si vous n’ĂȘtes pas en permanence devant la Vitre par exemple : une notification de toc toc en absence vous est envoyĂ©e et vous pouvez alors rejoindre votre interlocuteur sur la Vitre.

Comment ça marche ?
Vous avez besoin de gĂ©nĂ©rer un webhook depuis la plateforme de votre choix, puis de renseigner l’URL de ce webhook dans les paramĂštres avancĂ©s de la Vitre que vous souhaitez connecter.

Au sommaire de cette page :
A- Comment obtenir un webhook sur Google Chat ?
B- Comment obtenir un webhook sur Microsoft Teams ? (Ă  partir des workflows)
C- Comment obtenir un webhook sur Microsoft Teams ? (avec les connecteurs Microsoft 365)
D- Comment obtenir un webhook sur Slack?
E- Utiliser le webhook dans les paramÚtres avancés de la Vitre

A- Comment obtenir un webhook sur Google Chat ?

1- Ouvrez Google Chat

2- Ouvrez l'espace auquel vous souhaitez ajouter un webhook et qui sera dédié à ces notifications.

Illustration du menu déroulant Google Chat

3- À cĂŽtĂ© du titre de l'espace, cliquez sur la flĂšche vers le bas pour accĂ©der au menu, puis sur Applications et intĂ©grations

4- Cliquez sur le + Ajouter des webhooks

5- Dans le champ Name, saisissez un nom de votre choix par exemple “Webhook toc-tocs” ou “webhook guest”

6- Dans le champ URL de l'avatar, collez https://lavitre.fr/webclip.png

7- Cliquez sur Enregistrer

8- Pour copier l'URL de webhook, cliquez sur les 3 points au bout de la ligne puis sur Copier le lien

Voici le lien vers la page du centre d’aide Google Workspace pour plus d’informations.

B- Comment obtenir un webhook sur Microsoft Teams ? (Ă  partir des workflows)

1- Sélectionnez les trois points pour afficher plus d'applications et cliquez sur Workflows puis allez dans le menu pour en créer
2- Sous "Tous les modĂšles" allez dans les modĂšles de pour les notifications

3- SĂ©lectionnez le modĂšle "Publier sur un canal lorsqu’une demande de webhook est reçue".

4- Nommer votre flux, puis cliquez sur suivant

5- Choisissez la bonne équipe dans la liste déroulante, puis le canal voulu. Nous vous recommandons d'avoir un canal dédié à ces notifications. Cliquez ensuite sur le bouton pour créer un flux

6- Vous avez maintenant un webhook ! Il vous suffit de cliquer sur l’icĂŽne au bout Ă  droite du champ de l’URL pour le copier, puis le coller dans les paramĂštres avancĂ©s de la Vitre. Vous retrouvez ensuite ce flux sur la page d'accueil des workflows.

Voici le lien vers la page d’aide du centre d’aide Microsoft Teams pour plus d’informations.

C- Comment obtenir un webhook sur Microsoft Teams ? (avec les connecteurs Microsoft 365)

Note : septembre 2024, Les connecteurs Microsoft 365 (précédemment appelés connecteurs Office 365) sont presque obsolÚtes, et la création de nouveaux connecteurs Microsoft 365 sera bientÎt bloquée. Il faudra obligatoirement passer par les workflows Teams.

1- Sélectionnez Teams dans le volet de gauche, puis sélectionnez le canal requis dans l'équipe de votre choix pour créer un Webhook entrant.
2- SĂ©lectionnez Autres options ‱‱‱ Ă  droite du nom du canal.

3- SĂ©lectionnez GĂ©rer le canal

4- Dans la section des Connecteurs, cliquez sur Modifier

5- Dans la liste, retrouvez Webhook entrant et cliquez sur Ajouter (Si vous avez dĂ©jĂ  ajoutĂ© un webhook entrant, l’option Configurer s’affiche. SĂ©lectionnez Configurer pour crĂ©er un webhook entrant.)

6- Vous avez maintenant la possibilité de cliquer sur Configurer

7- Donnez un nom Ă  ce webhook entrant, par exemple “Webhook - la Vitre”, puis cliquez sur CrĂ©er Vous pouvez aussi personnaliser le logo en mettant celui de la Vitre dispo sur ce lien https://lavitre.fr/webclip.png

8- Une fois le webhook crĂ©Ă©, son URL est disponible. Il vous suffit de cliquer sur l’icĂŽne Ă  cĂŽtĂ© du champ de l’URL pour le copier.

Voici le lien vers la page d’aide du centre d’aide Microsoft Teams pour plus d’informations.

D- Comment obtenir un webhook sur Slack?

La procĂ©dure pour les webhooks sur Slack est un peu diffĂ©rente, il faut crĂ©er une app via Slack afin d’avoir accĂšs Ă  la crĂ©ation d’un URL webhook

1- Connectez-vous Ă  votre compte Slack

2- AccĂ©dez Ă  https://api.slack.com/apps : il y a peut-ĂȘtre des restrictions d’accĂšs selon votre organisation, voir alors avec votre administrateur

3- Cliquez sur le bouton vert Create an App, puis from Scratch dans la fenĂȘtre pop up

4- Choisissez un nom et un espace de travail auquel associer votre application : n’hĂ©sitez pas Ă  crĂ©er un canal dĂ©diĂ© pour ces notifications. Cliquez ensuite sur Create App.

5- Une fois crĂ©e, vous ĂȘtes dirigĂ© sur la page des paramĂštres de votre app. Descendez plus bas dans la page pour trouver la section Display Information Vous pouvez personnaliser l’app avec vos couleurs, un texte de description et le logo de la Vitre disponible sur ce lien https://lavitre.fr/webclip.png

6- Remontez ensuite en haut de page puis cliquez sur Incoming webhooks dans le menu Add features and functionality

7- Faites glisser le bouton sur On pour autoriser et activer les webhooks entrants

8- Un nouveau bouton est apparu en bas de page pour ajouter un nouveau webhook, cliquez dessus :)

9- Choisissez le canal dĂ©diĂ© que vous avez crĂ©Ă© normalement Ă  l’étape 4 dans la liste dĂ©roulante, puis Allow

10- Et voilĂ  ! Vous ĂȘtes redirigĂ© sur la page des paramĂštres et votre webhook vous attend en bas de page, prĂȘt Ă  ĂȘtre copiĂ©.

Voici le lien vers la page d’aide du centre d’aide Slack pour plus d’informations.

E- Utiliser le webhook dans les paramÚtres avancés de la Vitre

👉 Une fois votre webhook obtenu depuis la plateforme de votre choix, il faut le renseigner dans les paramĂštres avancĂ©s de chaque Vitre pour laquelle vous souhaitez recevoir des notifications.

1- Rendez-vous dans les paramÚtres avancés sur admin.lavitre.me et identifiez-vous comme administrateur avec vos identifiants habituels

2- Cliquez sur la Vitre que vous souhaitez paramétrer, puis cliquez sur Advanced parameters

3- Descendez jusqu’au menu des Apps puis dĂ©pliez Apps settings, la Vitre Core, IntĂ©grations avec vos applications

4- DĂ©pliez le menu selon la plateforme de messagerie que vous utilisez pour ensuite choisir la notification : le toc toc ou les demandes d’accĂšs

5- Coller dans le champ le webhook copiĂ© depuis votre plateforme, puis cochez “ActivĂ©â€. Le message est dĂ©jĂ  configurĂ© par dĂ©faut, mais vous pouvez bien sĂ»r le personnaliser ici

6- DerniĂšre Ă©tape : n’oubliez pas de sauvegarder les changements dans les paramĂštres avancĂ©s 😄