Microsoft Teams Integration with Orion Alerts

Version 2

    With the new release of Microsoft Teams, I got a tad curious and went to see what integrations were available.

     

    Much like Slack, PagerDuty, and  a host of others; Teams gleefully accepts incoming webhooks as a native integration. Below is a summary of how to achieve this in your Teams environment.

     

    Step 1:

    As an administrator of your organization's Team software, login to your Teams desktop application and click on the Team that you wish to add your integration to, then select "Connectors"

     

    step 1.jpg

     

    Step 2:

    Search for "Incoming Webhook" and click "Add"

     

    step 2.jpg

     

    Step 3:

    Name your new Webhook, add an optional Icon, and click "Create"

     

    step 3.jpg

     

    Step 4:

    Copy your URL to be used with your alert action in a moment

     

    step 4.jpg

     

    Step 5:

    At this point, you should see that you have a newly configured Webhook in your Connectors list and you should also have a new message in your Team reflecting this addition as well

     

    step 5.jpg

     

    step 5a.jpg

     

    Step 6:

    Configure an alert action (Send a GET or POST Request To A Web Server) and include your Webhook URL and associated payload (example below)

     

    step 6.jpg

     

    Step 7:

    Enjoy your new feed of alerts!

     

    step 7.jpg

     

     

    Here's the payload snippet I am using in my action at present:

     

    {
      "title": "ALERT TRIGGER: ${N=SwisEntity;M=Caption} is currently ${N=SwisEntity;M=Status}",
      "text": "DEVICE: [${N=SwisEntity;M=Caption}](${N=SwisEntity;M=DetailsUrl})
      IP ADDRESS: ${N=SwisEntity;M=IP_Address}
      VENDOR: ${N=SwisEntity;M=Vendor}
      MODEL: ${N=SwisEntity;M=MachineType}
      [ALERT DETAILS](${N=Alerting;M=AlertDetailsUrl})
      [ACKNOWLEDGE THIS ALERT](${N=Alerting;M=AcknowledgeLink})"
    }
    

     

    Please note that there is some good information to be found in the API Reference as well: Office 365 Connectors API Reference - Outlook Dev Center

     

    Enjoy!

     

     

    -ZackM

    Loop1 Systems: SolarWinds Training and Professional Services