Outils collaboratifs

Prérequis (auto-hébergé)

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

• 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.

• Allez sur configuration du webhook dans GLPI

Teams

• Depuis Teams, allez dans Applications

• Dans la barre de recherche, tapez Workflows

• Dans la liste des applications, cliquez sur Ajouter

• 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

• 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 sur l'utilisation du plugin, veuillez consulter notre FAQ