1. ProTop Knowledge Base
  2. Advanced Alerting Configuration

Set up the ProTop Portal to forward alerts to a Microsoft Teams Channel using webhook

Here are the steps to configure Teams and the ProTop Portal so that alerts are forwarded to your Teams channel

Office 365 - Power Automate

  1. Log into Power Automate in Office 365
  2. Click "+ New flow"
  3. Click Template
  4. Search Templates for webhook
  5. Select "Post to a channel when a webhook request is received."
  6. Click Continue
  7. Click Create
  8. You'll see:
  9. Click Got it
  10. Click Edit
  11. Click the top center box "When a Teams webhook request is received"
    .
  12. Copy the HTTP URL to the clipboard and paste it into a text document. You'll paste it into the ProTop Portal later.
  13. Click the box in the center of the screen titled "Post card in a chat or channel" to show its Parameters.
  14. Select your Team ID from the drop-down.
     
  15. Select your Channel ID from the drop-down
  16. Click Save (upper right)

ProTop Portal - Create the Webhook Alert Response Service

  1. Log into the ProTop Portal
  2. Select Alert Reponses Administration from the left nav.  Click the link to watch a video demonstrating how alert response services and alert responses are created in the ProTop Portal.
  3. Click Manage Alert Response Services
  4. Click Create Alert Response Service
  5. Select Webhook from the dropdown
  6. On the right side of your screen, you'll see the webhook form
  7. Select the Site this service is for
  8. Give the new service a name
  9. Paste the URL you copied earlier from Power Automate 
  10. Select the HTTP Method POST
  11. In Headers paste: 
    Content-Type=Application/JSON
  12. Copy and paste the following example JSON into the Payload Template:
    {"type": "Application/JSON","attachments": [{"contentType": "object","content": {"type": "AdaptiveCard","version": "1.4","body": [{"type": "TextBlock","text": "ProTop Test Alert","isSubtle": false,"wrap": false,"size": "Large","weight": "Bolder","spacing": "None"}, {"type": "TextBlock","text": "{notificationTitle}","isSubtle": false,"wrap": false,"spacing": "None"}, {"type": "TextBlock","text": "Created by: Me","isSubtle": false,"wrap": false,"spacing": "None"}, {"type": "TextBlock", "text": "{notificationText}","isSubtle": false,"wrap": false,"spacing": "None"}]}}]}
    This exact payload is not required.  You can do whatever you need here.  Just play within the boundaries set out in the AdaptiveCard Schema.

    While ProTop requires the JSON to be in one line, like the above, you can use the JSON Pretty Print tool to assist with editing.

    You can change the "text" lines in the above JSON to include whatever you want to share on your channel. 

    NOTE: The two ProTop variables, {notificationTitle} and {notificationText} must be included in a "text" field as these are the Alert subject and content variables filled in by ProTop.  These are the only variables available to include in the payload.

  13. Click Submit
  14. Click Test
  15. Check your Teams channel for the test message
  16. Rinse and repeat
  17. Once you are happy with the new Alert Response Service, you can create Alert Responses based on it.


If you have any issues, please don't hesitate to reach out using the options on this page.