Collaborative tools

Requirements (on-premise)

Install the plugin

• Go to the marketplace. Download and install the plugin Collaborative tools.

Activate webhooks

• In the tab Setup > Notifications activate Webhooks notifications

Mattermost

• From a Mattermost administrator account, go to the menu at the top left,

• Then Integrations

• Select Incoming Webhooks

• Then Add a new incoming webhook.

• Fill in the necessary fields and select the channel that will receive the notifications

• Then click on Save.

• You will then be sent the link to your Webhook:

• Go to setup the webhook in GLPI <setup_glpi>{.interpreted-text role="doc"}

Telegram

• From Telegram, start a new chat with the bot @BotFather and run the following command /newbot

• Answer the few questions you will be asked to set up your bot

• Once finished, a token will be sent to you:

• If you have already created a dedicated channel to receive GLPI notifications, add your bot to it.

• Otherwise, create your own channel

• add the newly created bot

• Send a message in the channel created to initiate a conversation and generate the various IDs we will need.

• From your browser, enter the following URL:

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

Replace mytoken with the value of the token generated above

• You should see a similar result:

"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"

• In the my_chat_member copy the ID value of the chat.

• Go to setup the webhook in GLPI

Teams

• From Teams, go to Apps

• In the search box, enter Workflows

• In the list of applications, click on Add

• From the desired Teams channel, click on the ··· menu

• Click on Workflows

• Choose "Post to a channel when a webhook request is received"

• In the new window, make sure that the current account has a sufficient licence to send webhooks

• Teams will give you a summary of the selected channel. If you've got it right, click on Add Workflows

• The URL of your workflow appears. Copy it and keep it, it will be used to configure GLPI.

• Go to setup the webhook in GLPI

Rocket

• You need to add an application to your team (the link is present in the bottom of the left sidebar) and select incoming-webhook

• Add a new configuration, select the channel where you want notifications and you will get the webhook url.

• You can optionally setup a name and a logo for your hook.

• Go to setup the webhook in GLPI

Slack

• As a logged team administrator, go to the administration menu

• click on Integrations menu item

• Click on the New integration button

• Select incoming webhooks, and define webhook parameters

• After save, you will get the url of the webhook.

• Go to setup the webhook in GLPI

Set up the webhook in GLPI

• Fill in the requested information and select the channel on which you want the notifications to be sent.

• Once registered, a link will be sent to you. Copy this link and transfer it to Setup > Notifications > Configuration of notifications by webhooks

• Click on + and enter :

  • Webhook name,

  • the type,

  • the URL.

• Click on Add

• You can test how it works by selecting your webhook and clicking on Send notification

Recipients

• You now need to determine which notifications will be affected by the sending of a Webhook and assign them a template.

• Go to Setup > Notifications > Notifications

• Select the 1st notification concerned by Webhooks (here New ticket)

• In the Recipients tab, add your Webhook then Update.

Templates

• In the tab Templates click Add a template

• Choose Webook in the Notification method and New in the Notification template

Your Webhook is ready to use. You can customise the template by clicking on New so that it matches your requirements.

FAQ

If you have any questions about using the plugin, please consult our FAQ