Outils collaboratifs

Prérequis (auto-hébergé)

Version GLPI	PHP minimum	Recommandé
10.0.x	8.1	8.2
11.0.x	8.2	8.4

Une souscription GLPI Network BASIC (ou supérieur) est requis. Ce plugin est également disponible pour toutes les instances GLPI Network Cloud.

Installer le plugin

• Allez sur le marketplace. Téléchargez et installez le plugin Outils collaboratifs.

Activer les webhooks

• Dans l'onglet Configuration > Notifications activez les notifications Webhooks

Mattermost

• Depuis un compte administrateur Mattermost, allez dans le menu en haut à gauche,

• Puis Intégrations

• Sélectionnez Incoming Webhooks

• Puis Add a new incoming webhook.

• Remplissez les champs nécessaires et sélectionnez le canal qui recevra les notifications

• Puis cliquez sur Save.

• Vous serez alors envoyé le lien de votre Webhook :

• Allez sur configuration du webhook dans GLPI <setup_glpi>{.interpreted-text role="doc"}

Telegram

• Depuis Telegram, démarrez une nouvelle conversation avec le bot @BotFather et lancez la commande suivante /newbot

• Répondez aux quelques questions qui vous seront posées pour configurer votre bot

• Une fois terminé, un token vous sera envoyé :

• Si vous avez déjà créé un canal dédié pour recevoir les notifications GLPI, ajoutez-y votre bot.

• Sinon, créez votre propre canal

• ajoutez le bot nouvellement créé

• Envoyez un message dans le canal créé pour initier une conversation et générer les différents ID dont nous aurons besoin.

• Depuis votre navigateur, entrez l'URL suivante :

  [https://api.telegram.org/botmonjeton/getupdates\](https://api.telegram.org/botmonjeton/getupdates)

Remplacez monjeton par la valeur du token généré ci-dessus

Les URL des bots Telegram prennent la forme https://api.telegram.org/bot{monjeton}

• Vous devriez voir un résultat similaire :

"ok": true,
"result": [
    {
        "update_id": 816584684,
        "my_chat_member": {
            "chat": {
                "id": -541684658463,
                "title": "GLPI Ticket",
                "type": "channel"
            },
            "from": {
                "id": 1546610935,
                "is_bot": false,
                "first_name": "xxxxxxx",
                "last_name": "xxxxxxx"


           },
            "new_chat_member": {
                "user": {
                    "id": 7468746847,
                    "is_bot": true,
                    "first_name": "glpi",
                    "username": "xxxxxx_bot"

• Dans le my_chat_member copiez la valeur ID du chat.

Le signe négatif - doit également être copié

• Allez sur configuration du webhook dans GLPI

Teams

Suite à la fin des connecteurs O365, Microsoft impose une nouvelle méthode de configuration de vos webhooks via les workflows. Cette procédure doit être mise en place avant le 15 août. Passé cette date, vos webhooks ne fonctionneront plus. Vos webhooks utilisés par les Webhooks entrants (ancienne méthode) ne seront plus disponibles.

Le canal utilisé doit être public. Microsoft n'autorise pas actuellement les webhooks avec les Workflows depuis un canal privé.

• Depuis Teams, allez dans Applications

• Dans la barre de recherche, tapez Workflows

• Dans la liste des applications, cliquez sur Ajouter

Certaines informations peuvent prendre un certain temps à apparaître, soyez donc patient entre chaque étape et attendez que les informations apparaissent à l'écran avant de passer à l'étape suivante.

• Depuis le canal Teams désiré, cliquez sur le menu ···

• Cliquez sur Workflows

• Choisissez "Poster dans un canal lorsqu'une requête webhook est reçue"

• Dans la nouvelle fenêtre, assurez-vous que le compte actuel dispose d'une licence suffisante pour envoyer des webhooks

• Teams vous donnera un résumé du canal sélectionné. Si vous avez bien choisi, cliquez sur Ajouter des Workflows

• L'URL de votre workflow apparaît. Copiez-la et conservez-la, elle servira à la configuration de GLPI.

• Allez sur configuration du webhook dans GLPI

Rocket

• Vous devez ajouter une application à votre équipe (le lien est présent en bas de la barre latérale gauche) et sélectionner incoming-webhook

• Ajoutez une nouvelle configuration, sélectionnez le canal où vous souhaitez recevoir les notifications et vous obtiendrez l'URL du webhook.

• Vous pouvez éventuellement configurer un nom et un logo pour votre hook.

• Allez sur configuration du webhook dans GLPI

Slack

• En tant qu'administrateur d'équipe connecté, allez dans le menu d'administration

• cliquez sur l'élément de menu Intégrations

• Cliquez sur le bouton Nouvelle intégration

• Sélectionnez les webhooks entrants, et définissez les paramètres du webhook

• Après enregistrement, vous obtiendrez l'URL du webhook.

• Allez sur configuration du webhook dans GLPI

Configuration du webhook dans GLPI

• Remplissez les informations demandées et sélectionnez le canal sur lequel vous souhaitez que les notifications soient envoyées.

• Une fois enregistré, un lien vous sera envoyé. Copiez ce lien et transférez-le dans Configuration > Notifications > Configuration des notifications par webhooks

• Cliquez sur + et entrez :

  • Nom du Webhook,

  • le type,

  • l'URL.

• Cliquez sur Ajouter

Pour Telegram, vous devrez réentrer le webhook et ajouter le chat_id que vous avez sélectionné précédemment

• Vous pouvez tester son fonctionnement en sélectionnant votre webhook et en cliquant sur Envoyer une notification

Destinataires

• Vous devez maintenant déterminer quelles notifications seront affectées par l'envoi d'un Webhook et leur assigner un template.

• Allez sur Configuration > Notifications > Notifications

• Sélectionnez la 1ère notification concernée par les Webhooks (ici Nouveau ticket)

• Dans l'onglet Destinataires, ajoutez votre Webhook puis Mettre à jour.

Templates

• Dans l'onglet Templates cliquez sur Ajouter un template

• Choisissez Webook dans la Méthode de notification et Nouveau dans le Template de notification

Votre Webhook est prêt à l'emploi. Vous pouvez personnaliser le modèle en cliquant sur Nouveau afin qu'il corresponde à vos besoins.

---

FAQ

Si vous avez des questions concernant l'utilisation du plugin, n'hésitez pas à consulter notre FAQ

Aller à la FAQ