Microsoft Teams

Kurt Wolf · October 24, 2018

We recently moved from Slack to Microsoft Teams. I would like to get our alert integration working. Does anyone have a writeup of doing this?

Kerry DeVilbiss · October 25, 2018

Hey @Kurt Wolf,

I'm actively working on documenting some internal efforts to get a Microsoft Teams webhook integration in place - I'll reach out within the next day or so with some instructions.

Best,

Kerry

Nicklas Karlsson · October 26, 2018

Great!! We're all in to Microsoft Teams, and this will be a great feature

Kerry DeVilbiss · October 26, 2018

I just sent out an email with some attached instructions for both of you - we're working on some more formal documentation, but I wanted to get it out there so you could use it!

Let me know how it goes - if others are interested, reply here and I can send over the same doc - and eventually I'll post a link to the official docs when they're ready.

Best,

Kerry

Chris Swanger · November 6, 2018

Kerry, if you still have the documentation for integrating teams alert notifications, I would love to try it.

Thanks!

fintanquinn · November 7, 2018

Also Interested here

Thanks

Nicklas Karlsson · November 17, 2018

I would really like to take a look at the documentation... Can't figure it out to work for me. so if you guys have a solution I will be glad to get the help I can to solve this

Gregb · November 18, 2018

I would be interested to see what this documentation looks like. We have the email to Teams integration configured. If there is a different way to do this, it would be very interested.

Nicklas Karlsson · November 19, 2018

Hi All!

I've tested this and it works. No reply options yet, but it's a start

Create a channel for webhooks in Teams copy that adress and use it in your Integration ( I copied a Slack integration)

And I've used the following JSON formatting

{
"@type": "MessageCard",
"@context": "http://schema.org/extensions",
"themeColor": "ff0000",
"title": "Company - LM Webhook Test",
"text":"Alerts!",
"sections": [{
"activityTitle": "Action Required!",
"activitySubtitle": "Here are the details",
"Facts": [{
"name": "Host:",
"value": "##HOST##"
}, {
"name": "Datasource",
"value": "##DATASOURCE##"
}, {
"name": "Displayname:",
"value": "##system.displayname##"
}, {
"name": "InstanceGroup:",
"value": "##INSTANCEGROUP##"
}, {
"name": "Datapoint:",
"value": "##DATAPOINT##"
}, {
"name": "Datapoint Description:",
"value": "##DPDESCRIPTION##"
}, {
"name": "Level:",
"value": "##LEVEL##"
}, {
"name": "Start:",
"value": "##START##"
}, {
"name": "Duration:",
"value": "##DURATION##"
}, {
"name": "Value:",
"value": "##VALUE##"
}, {
"name": "Threshold:",
"value": "##THRESHOLD##"
}, {
"name": "ClearValue:",
"value": "##CLEARVALUE##"
}, {
"name": "Reason:",
"value": "##DATAPOINT## ##THRESHOLD##"
}, {
"name": "Group:",
"value": "##GROUP##"
}],
"markdown": true
}]
}

Kerry DeVilbiss · November 19, 2018

Hey Guys,

Give me a couple hours to see if I can't make our instructions publicly accessible today - I can see now there's plenty of demand and we've had another go at cleaning them up so I will see what I can't get posted.

Have a couple meetings this morning but can follow up a bit later. Appreciate the patience ... !

Best,

Kerry

Kerry DeVilbiss · November 19, 2018

Issue

Microsoft Teams is Microsoft's offering in the collaboration tools/ group chat space. Much like Slack or other similar tools, they provide an API interface for posting alerts to a Microsoft Teams channel.

Resolution

Screenshots of some of these steps are available down below after the code blocks.

- Add a new Custom Webhook Integration into LogicMonitor.
- "Use different URLs or data formats to notify on various alert activity."
- Insert the relevant payloads from the code sections below into each of the custom webhook stages.
- Once you've setup the Integration, you'll need to get the webhook URLs from Microsoft Teams as follows:
- -- Right-Click on the channel you want to be the destination for alerts, and select 'Connectors'
- -- From the Connectors screen, select "Incoming Webhooks"
- -- Configure a name for the incoming webhooks (LogicMonitor Alerts isn't a bad one)
- -- At the end of this configuration, they'll provide you with a URL that looks something like this:
  - --- https://outlook.office.com/webhook/c23bf412-1ded-4d65-97c6-7187d4626894@b2770e96-450d-4a74-bf3b-f2b77eb337e9/IncomingWebhook/b99a46adc48745e19b9a3535f0be462a/48eb6267-4d62-4ebc-bc4a-33340fce7bcc
  - --- If you are setting up just one room in Teams - add the URL given by Teams to each of the webhook calls in LM.
- -- If you want to send alerts to different rooms you can use a tokenized version of the URL instead of setting up a new integration for each room. Use the following steps to create the tokens, or you are setting up just 1 room skip to the next step.
  - --- https://outlook.office.com/webhook/##TEAMS.WEBHOOK##/IncomingWebhook/##TEAMS.INCOMINGWEBHOOK## (This will be the URL endpoint for each of the webhook calls in LM)
  - --- You are going to need to extract (2) pieces of information from the URL given by Teams:
  - --- The value in between /webhook/ and /IncomingWebhook - in this case, c23bf412-1ded-4d65-97c6-7187d4626894@a2770e96-450d-4a74-bf3b-f2c77eb337e9 - this will be set as device/group property 'teams.webhook'
  - --- The value of everything AFTER /IncomingWebhook - in this case, b99a36adc48745e19b9a3535f0be462a/48eb6267-4d62-4ebc-bc4a-33340fce7bcc - this will be set as device/group property 'teams.incomingwebhook'
  - --- Set those properties at the root of the LogicMonitor account (or wherever appropriate,) so that all the devices can pull that token into the alert delivery.
That should be it! Setup an escalation chain with your Integration, and set up Alert Rules for your escalation chain.

Active Alerts:

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "summary": "LogicMonitor Alert",
    "themeColor": "ff0000",
    "sections": [
        {
            "startGroup": true,
            "title": "LogicMonitor Automated Alert Notification",
            "activityImage": "http://www.logicmonitor.com/wp-content/uploads/2015/07/LM_Logo_Circle_Indigo_300px.png",
            "activityTitle": "Group: **##GROUP##**",
            "activitySubtitle": "##LEVEL## Alert received: ##ALERTID##",
            "text": "LogicMonitor Alert Details",
            "facts": [
                {
                    "name": "Group",
                    "value": "##GROUP##"
                },
                {
                    "name": "Host",
                    "value": "##HOST##"
                },
                {
                    "name": "Datasource",
                    "value": "##DATASOURCE##"
                },
                {
                    "name": "Datapoint",
                    "value": "##DATAPOINT##"
                },
                {
                    "name": "Threshold",
                    "value": "##THRESHOLD##"
                },
                {
                    "name": "Value",
                    "value": "##VALUE##"
                },
                {
                    "name": "Duration",
                    "value": "##DURATION##"
                },
                {
                    "name": "Start",
                    "value": "##START##"
                },
                {
                    "name": "Alert URL",
                    "value": "##AlertDetailURL##"
                },
                {
                    "name": "Service URL",
                    "value": "##URL##"
                },
                {
                    "name": "Website Description",
                    "value": "##WEBSITEDESCRIPTION##"
                },
                {
                    "name": "Website Checkpoint",
                    "value": "##CHECKPOINT##"
                },               
                {
                    "name": "Website Group",
                    "value": "##WEBSITEGROUP##"
                }
            ],
            "potentialAction": [
                {
                    "@type": "OpenUri",
                    "name": "Open Alert",
                    "targets": [
                        { "os": "default", "uri": "##AlertDetailURL##" }
                    ]
                }
            ]
        }
    ]
}

Escalated Alerts:

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "summary": "LogicMonitor Alert",
    "themeColor": "ffcc00",
    "sections": [
        {
            "startGroup": true,
            "title": "LogicMonitor Alert Update Notification",
            "activityImage": "http://www.logicmonitor.com/wp-content/uploads/2015/07/LM_Logo_Circle_Indigo_300px.png",
            "activityTitle": "Group: **##GROUP##**",
            "activitySubtitle": "##LEVEL## Alert received: ##ALERTID##",
            "text": "LogicMonitor Alert Details",
            "facts": [
                {
                    "name": "Group",
                    "value": "##GROUP##"
                },
                {
                    "name": "Host",
                    "value": "##HOST##"
                },
                {
                    "name": "Datasource",
                    "value": "##DATASOURCE##"
                },
                {
                    "name": "Datapoint",
                    "value": "##DATAPOINT##"
                },
                {
                    "name": "Threshold",
                    "value": "##THRESHOLD##"
                },
                {
                    "name": "Value",
                    "value": "##VALUE##"
                },
                {
                    "name": "Duration",
                    "value": "##DURATION##"
                },
                {
                    "name": "Start",
                    "value": "##START##"
                },
                {
                    "name": "Alert URL",
                    "value": "##AlertDetailURL##"
                },
                {
                    "name": "Service URL",
                    "value": "##URL##"
                },
                {
                    "name": "Website Description",
                    "value": "##WEBSITEDESCRIPTION##"
                },
                {
                    "name": "Website Checkpoint",
                    "value": "##CHECKPOINT##"
                },               
                {
                    "name": "Website Group",
                    "value": "##WEBSITEGROUP##"
                }
            ],
            "potentialAction": [
                {
                    "@type": "OpenUri",
                    "name": "Open Alert",
                    "targets": [
                        { "os": "default", "uri": "##AlertDetailURL##" }
                    ]
                }
            ]
        }
    ]
}

Acknowledged Alerts:

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "summary": "LogicMonitor Alert",
    "themeColor": "003366",
    "sections": [
        {
            "startGroup": true,
            "title": "LogicMonitor Acknowledgement Notification",
            "activityImage": "http://www.logicmonitor.com/wp-content/uploads/2015/07/LM_Logo_Circle_Indigo_300px.png",
            "activityTitle": "Group: **##GROUP##**",
            "activitySubtitle": "##LEVEL## Alert received: ##ALERTID##",
            "text": "LogicMonitor Alert Details",
            "facts": [
                {
                    "name": "Group",
                    "value": "##GROUP##"
                },
                {
                    "name": "Host",
                    "value": "##HOST##"
                },
                {
                    "name": "Datasource",
                    "value": "##DATASOURCE##"
                },
                {
                    "name": "Datapoint",
                    "value": "##DATAPOINT##"
                },
                {
                    "name": "Threshold",
                    "value": "##THRESHOLD##"
                },
                {
                    "name": "Value",
                    "value": "##VALUE##"
                },
                {
                    "name": "Duration",
                    "value": "##DURATION##"
                },
                {
                    "name": "Start",
                    "value": "##START##"
                },
                {
                    "name": "Alert URL",
                    "value": "##AlertDetailURL##"
                },
                {
                    "name": "Service URL",
                    "value": "##URL##"
                },
                {
                    "name": "Website Description",
                    "value": "##WEBSITEDESCRIPTION##"
                },
                {
                    "name": "Website Checkpoint",
                    "value": "##CHECKPOINT##"
                },               
                {
                    "name": "Website Group",
                    "value": "##WEBSITEGROUP##"
                }
            ],
            "potentialAction": [
                {
                    "@type": "OpenUri",
                    "name": "Open Alert",
                    "targets": [
                        { "os": "default", "uri": "##AlertDetailURL##" }
                    ]
                }
            ]
        }
    ]
}

Cleared Alerts:

{
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "summary": "LogicMonitor Alert",
    "themeColor": "33f449",
    "sections": [
        {
            "startGroup": true,
            "title": "LogicMonitor Alert Clear Notification",
            "activityImage": "http://www.logicmonitor.com/wp-content/uploads/2015/07/LM_Logo_Circle_Indigo_300px.png",
            "activityTitle": "Group: **##GROUP##**",
            "activitySubtitle": "##LEVEL## Alert received: ##ALERTID##",
            "text": "LogicMonitor Alert Details",
            "facts": [
                {
                    "name": "Group",
                    "value": "##GROUP##"
                },
                {
                    "name": "Host",
                    "value": "##HOST##"
                },
                {
                    "name": "Datasource",
                    "value": "##DATASOURCE##"
                },
                {
                    "name": "Datapoint",
                    "value": "##DATAPOINT##"
                },
                {
                    "name": "Threshold",
                    "value": "##THRESHOLD##"
                },
                {
                    "name": "Value",
                    "value": "##VALUE##"
                },
                {
                    "name": "Duration",
                    "value": "##DURATION##"
                },
                {
                    "name": "Start",
                    "value": "##START##"
                },
                {
                    "name": "Alert URL",
                    "value": "##AlertDetailURL##"
                },
                {
                    "name": "Service URL",
                    "value": "##URL##"
                },
                {
                    "name": "Website Description",
                    "value": "##WEBSITEDESCRIPTION##"
                },
                {
                    "name": "Website Checkpoint",
                    "value": "##CHECKPOINT##"
                },               
                {
                    "name": "Website Group",
                    "value": "##WEBSITEGROUP##"
                }
            ],
            "potentialAction": [
                {
                    "@type": "OpenUri",
                    "name": "Open Alert",
                    "targets": [
                        { "os": "default", "uri": "##AlertDetailURL##" }
                    ]
                }
            ]
        }
    ]
}

Custom Webhook Overview

image2018-10-25_16-40-52.png?version=1&modificationDate=1540510852000&api=v2

Teams Channel Connectors

image2018-10-25_16-42-10.png?version=1&modificationDate=1540510931000&api=v2

Incoming Webhook Connector

Edited November 19, 2018 by Kerry DeVilbiss
formatting clarity

iknowcoolin · November 20, 2018

I appreciate the steps for MS teams webhook.

I cannot see the pictures/screenshot.

Herin · January 10, 2019

Hi,

Interested to try this integration piece with our Microsoft Teams. I cannot see the pictures as well. Is there a possibility you can provide the information.

Thanks

Adam Gent · January 18, 2019

Are there any plans to add this as an official integration option?

Kerry DeVilbiss · August 29, 2019

For anyone else who might be interested, you can now download this integration from the following location:

https://github.com/kdevilbiss/Integrations/blob/master/Microsoft_Teams_v1.json

Cheers,

Kerry

Cole McDonald · August 29, 2019

Address doesn't seem to want to resolve. Chunked it backwards as well and nothing resolves until github's main page.

Cole McDonald · October 1, 2019

I've added the JSON to our integration with teams. Looks good, thank you. The Facts sections seem to look great on my iPhone, but are very narrow under windows. I'm going to see if there's a way to nudge them wider.

Tom Merkel · May 12, 2020

Hello. I see that this is an old topic, but could I ask for those screenshots, please? They are not loading. Thanks.

stockholm · July 30, 2020

Hello, I'm trying to follow the instructions but looks like they are outdated. Does anyone have this working in their tenant, and willing to share how it's set up? We are in the trial phase with LM right now and one of the big selling points was that it had integrations with Microsoft Teams. It's a bit disappointing to find out there isn't an official integration (seems to be a bit of a disconnect with the sales team) but as long as I can get this working my boss and team will be happy. I asked support about it but since there isn't an officially supported method they pointed me to the community.

stockholm · July 30, 2020

Scratch that. I found and added the json file, and this is making a bit more sense. Only question I've got is, what permissions/licensing does the O365 account being used for the integration need?

Maurice Vigil · November 18, 2020

Hello,

Has anyone figured out how to add an action to the MS Teams card to ACK or SDT the Alert from the MS Teams Channel Card? Slack has this capability, but I can't figure out what URI is needed to perform the action. ITs great to see the "Open Alert" action, but would love to ACK and SDT right next to the OPEN Alert action button in Teams. Thanks!

stockholm · November 18, 2020

I talked with support when I was setting this up and the answer right now is that this is not an "official" integration like Slack. So it's very limited, which is why there's no ACK or SDT at the moment. They did say an official integration is in the works but couldn't provide any more info like an eta.

Maurice Vigil · December 1, 2020

Heard from LM on this one. I'm surprised there isn't more push for this as I do believe Teams has surpassed Slack since Covid started.

Hi Maurice-

I spoke to one of our product managers this morning and as of now we do not have any formal integration with Teams on our product roadmap. We do have plans to roll out additional monitoring via API authentication in Q1, and that could help pave the way for two-way comms between LM and Teams at some point later in 2021.

Regards,

Drew

Jim C · March 10, 2021

Just wondering if theres any update on the formal Intergration with Teams or the API Authenticaion? we are looking at using Teams for some ChatOps stuff and it 2 way comms would be amazing

Brian Gladden · March 25, 2021

Keep your eyes posted. More news coming in April.

Microsoft Teams

Recommended Posts

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Issue

Resolution

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Link to comment

Share on other sites

Join the conversation