Microsoft Teams Workflow Setup

This guide walks you through setting up a Microsoft Teams workflow using Power Automate to receive real-time incident notifications from Pinghome directly in your Teams channels.

What you'll need:

Microsoft Teams account with channel access
Power Automate permissions
Pinghome account with notification channel setup access

1Open Power Automate 2Create Flow and Choose Webhook Trigger 3Add Parse JSON Action 4Configure Parse JSON 5Add Post to Channel Action 6Configure Teams Channel and Adaptive Card 7Add Security Validation (Optional but Recommended)8Configure Trigger Settings and Save Flow 9Add Webhook to Pinghome 10Test the Integration

Navigate to Power Automate and sign in with your Microsoft account.

Make sure you're signed in with the same account that has access to your Teams channels.

Click on + Create from the left sidebar, then:

Select Instant cloud flow
Enter flow name, e.g. "Pinghome Incident Alerts"
In the trigger list, select When a Teams webhook request is received
Click Create

Step 2: Create Flow and Choose Webhook Trigger

This trigger will automatically generate a webhook URL after you complete and save the flow.

Click +, search for Parse JSON and select it from the Data Operations category.

This step is essential to extract the incident data from Pinghome's webhook payload.

Configure the Parse JSON action:

Content: Click in the field and select Body from the dynamic content (from the webhook trigger)
Schema: Paste the following JSON schema

Adaptive Card Template

{
    "type": "object",
    "properties": {
        "type": {
            "type": "string"
        },
        "properties": {
            "type": "object",
            "properties": {
                "@@type": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "@@context": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "summary": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "themeColor": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "sections": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "properties": {
                                    "type": "object",
                                    "properties": {
                                        "activityTitle": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "activitySubtitle": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "activityImage": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "facts": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "object",
                                                    "properties": {
                                                        "type": {
                                                            "type": "string"
                                                        },
                                                        "properties": {
                                                            "type": "object",
                                                            "properties": {
                                                                "name": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                },
                                                                "value": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    }
                                                }
                                            }
                                        },
                                        "text": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "potentialAction": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "properties": {
                                    "type": "object",
                                    "properties": {
                                        "@@type": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "name": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "targets": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "object",
                                                    "properties": {
                                                        "type": {
                                                            "type": "string"
                                                        },
                                                        "properties": {
                                                            "type": "object",
                                                            "properties": {
                                                                "os": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                },
                                                                "uri": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

This schema matches the structure of Pinghome's incident notification payload.

Click +, search for Post card in a chat or channel and select it.

If you added security validation, make sure to add this action inside the 'If yes' branch of your Condition.

Configure the action:

Post as:Flow bot
Post in:Channel
Team: Select your team
Channel: Select the channel for notifications
In the Adaptive Card field, paste the following JSON template

Step 6: Configure Teams Channel and Adaptive Card

Adaptive Card Template

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.4",
  "body": [
    {
      "type": "Container",
      "style": "@{if(equals(body('Parse_JSON')?['themeColor'], '#00FF00'), 'good', 'attention')}",
      "bleed": true,
      "items": [
        {
          "type": "ColumnSet",
          "columns": [
            {
              "type": "Column",
              "width": "auto",
              "items": [
                {
                  "type": "Image",
                  "url": "@{body('Parse_JSON')['sections'][0]['activityImage']}",
                  "size": "small"
                }
              ]
            },
            {
              "type": "Column",
              "width": "stretch",
              "items": [
                {
                  "type": "TextBlock",
                  "text": "@{body('Parse_JSON')['sections'][0]['activityTitle']}",
                  "weight": "bolder",
                  "size": "large",
                  "color": "white"
                },
                {
                  "type": "TextBlock",
                  "text": "@{body('Parse_JSON')['summary']}",
                  "wrap": true
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "type": "FactSet",
      "facts": [
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][0]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][0]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][1]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][1]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][2]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][2]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][3]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][3]['value']}"
        },
        {
          "title": "@{if(greater(length(body('Parse_JSON')?['sections'][0]?['facts']), 4), body('Parse_JSON')['sections'][0]['facts'][4]['name'], '')}",
          "value": "@{if(greater(length(body('Parse_JSON')?['sections'][0]?['facts']), 4), body('Parse_JSON')['sections'][0]['facts'][4]['value'], '')}"
        }
      ]
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "@{body('Parse_JSON')['potentialAction'][0]['name']}",
      "url": "@{body('Parse_JSON')['potentialAction'][0]['targets'][0]['uri']}"
    }
  ]
}

The adaptive card now references the parsed JSON data from the previous step using dynamic content.

Basic setup complete! If you didn't add security validation, you can proceed to Step 8 to save and get your webhook URL. Step 7 adds optional security - skip if not needed.

To secure your webhook, add access_key validation.

Click + after When a Teams webhook request is received, search for Initialize variable
- Name: accessKey
- Type: String
- Value: triggerOutputs()['queries']?['access_key'] (Insert expression)
Click + after Initialize variable, search for Condition
- Left: accessKey (Insert dynamic content)
- Operator: is equal to
- Right: Your generated access_key
Move remaining actions to If yes branch
In If no branch, add Terminate (Status: Failed)

Step 7: Add Security Validation (Optional but Recommended)

Without this step, anyone with the webhook URL can send alerts to your Teams channel.

Before saving, configure the HTTP trigger settings:

Open the When a Teams webhook request is received trigger
In trigger settings, set Who can trigger the flow to Anyone
Click Save in the top right corner
After saving, open the trigger again and copy the HTTP POST URL

If you added security validation:
Add &access_key=YOUR_ACCESS_KEY to the end of the URL.

Example:
https://prod-xx.azure.com/.../invoke?sig=ABC123&access_key=YOUR_ACCESS_KEY

The Anyone setting allows external services like Pinghome to trigger the flow. Combined with access_key validation (if added), this remains secure.

Make sure 'Who can trigger the flow' is set to 'Anyone' before saving, otherwise Pinghome won't be able to send requests.

Go to your Pinghome dashboard:

Navigate to Notifications → Team Channels
Click + New
Select Microsoft Teams
Paste the webhook URL from step 8 (with access_key parameter if you added security)
Click Submit

See Create Personal Notification Channel for API setup.

Test your setup by clicking Test alert in Pinghome. You should receive a test message in your Teams channel within a few seconds.

If you see the test message in Teams, your integration is working correctly! You're now ready to receive real-time incident notifications.

Common Issues

⚠️Receiving 401 Unauthorized errors

Check that Who can trigger the flow is set to Anyone in the HTTP trigger settings. If set to 'Specific users', Pinghome cannot authenticate and the flow will reject requests.

⚠️Not receiving notifications

Verify that:

The workflow is turned ON in Power Automate
The webhook URL in Pinghome matches the one from your workflow
You have proper permissions in the Teams channel
Check the workflow run history in Power Automate for errors

⚠️Flow terminates (if security enabled)

Check that access_key parameter in URL matches the access_key in your Condition. Verify format: &access_key=.

⚠️Parse JSON action fails

Ensure the schema matches Pinghome's payload structure. Check the run history in Power Automate to see the actual payload received and adjust the schema if needed.

⚠️Adaptive card not displaying correctly

Ensure you're using the exact JSON template provided and that the Parse JSON step completed successfully.

⚠️Dynamic content not showing data

Make sure the Parse JSON action is named exactly 'Parse_JSON'. If you renamed it, update all references in the Adaptive Card template to match the new name.

Additional Information

Customization:

You can customize the Adaptive Card template to match your team's preferences. Visit Adaptive Cards Designer to create custom layouts.

Security:

Adding access_key validation is optional but recommended. Without it, anyone with your webhook URL can send alerts. Generate an access_key and add it as a URL parameter. Keep the complete URL (with access_key) private and secure.

Limitations:

Power Automate has rate limits. For high-volume notifications, consider upgrading your Microsoft 365 plan.

Microsoft Teams Workflow Setup

Microsoft Teams account with channel access
Power Automate permissions
Pinghome account with notification channel setup access

Navigate to Power Automate and sign in with your Microsoft account.

Make sure you're signed in with the same account that has access to your Teams channels.

Click on + Create from the left sidebar, then:

Select Instant cloud flow
Enter flow name, e.g. "Pinghome Incident Alerts"
In the trigger list, select When a Teams webhook request is received
Click Create

This trigger will automatically generate a webhook URL after you complete and save the flow.

Click +, search for Parse JSON and select it from the Data Operations category.

This step is essential to extract the incident data from Pinghome's webhook payload.

Configure the Parse JSON action:

Content: Click in the field and select Body from the dynamic content (from the webhook trigger)
Schema: Paste the following JSON schema

Adaptive Card Template

{
    "type": "object",
    "properties": {
        "type": {
            "type": "string"
        },
        "properties": {
            "type": "object",
            "properties": {
                "@@type": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "@@context": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "summary": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "themeColor": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        }
                    }
                },
                "sections": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "properties": {
                                    "type": "object",
                                    "properties": {
                                        "activityTitle": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "activitySubtitle": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "activityImage": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "facts": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "object",
                                                    "properties": {
                                                        "type": {
                                                            "type": "string"
                                                        },
                                                        "properties": {
                                                            "type": "object",
                                                            "properties": {
                                                                "name": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                },
                                                                "value": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    }
                                                }
                                            }
                                        },
                                        "text": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "potentialAction": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string"
                        },
                        "items": {
                            "type": "object",
                            "properties": {
                                "type": {
                                    "type": "string"
                                },
                                "properties": {
                                    "type": "object",
                                    "properties": {
                                        "@@type": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "name": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                }
                                            }
                                        },
                                        "targets": {
                                            "type": "object",
                                            "properties": {
                                                "type": {
                                                    "type": "string"
                                                },
                                                "items": {
                                                    "type": "object",
                                                    "properties": {
                                                        "type": {
                                                            "type": "string"
                                                        },
                                                        "properties": {
                                                            "type": "object",
                                                            "properties": {
                                                                "os": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                },
                                                                "uri": {
                                                                    "type": "object",
                                                                    "properties": {
                                                                        "type": {
                                                                            "type": "string"
                                                                        }
                                                                    }
                                                                }
                                                            }
                                                        }
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

This schema matches the structure of Pinghome's incident notification payload.

Click +, search for Post card in a chat or channel and select it.

If you added security validation, make sure to add this action inside the 'If yes' branch of your Condition.

Configure the action:

Post as:Flow bot
Post in:Channel
Team: Select your team
Channel: Select the channel for notifications
In the Adaptive Card field, paste the following JSON template

Adaptive Card Template

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.4",
  "body": [
    {
      "type": "Container",
      "style": "@{if(equals(body('Parse_JSON')?['themeColor'], '#00FF00'), 'good', 'attention')}",
      "bleed": true,
      "items": [
        {
          "type": "ColumnSet",
          "columns": [
            {
              "type": "Column",
              "width": "auto",
              "items": [
                {
                  "type": "Image",
                  "url": "@{body('Parse_JSON')['sections'][0]['activityImage']}",
                  "size": "small"
                }
              ]
            },
            {
              "type": "Column",
              "width": "stretch",
              "items": [
                {
                  "type": "TextBlock",
                  "text": "@{body('Parse_JSON')['sections'][0]['activityTitle']}",
                  "weight": "bolder",
                  "size": "large",
                  "color": "white"
                },
                {
                  "type": "TextBlock",
                  "text": "@{body('Parse_JSON')['summary']}",
                  "wrap": true
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "type": "FactSet",
      "facts": [
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][0]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][0]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][1]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][1]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][2]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][2]['value']}"
        },
        {
          "title": "@{body('Parse_JSON')['sections'][0]['facts'][3]['name']}",
          "value": "@{body('Parse_JSON')['sections'][0]['facts'][3]['value']}"
        },
        {
          "title": "@{if(greater(length(body('Parse_JSON')?['sections'][0]?['facts']), 4), body('Parse_JSON')['sections'][0]['facts'][4]['name'], '')}",
          "value": "@{if(greater(length(body('Parse_JSON')?['sections'][0]?['facts']), 4), body('Parse_JSON')['sections'][0]['facts'][4]['value'], '')}"
        }
      ]
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "@{body('Parse_JSON')['potentialAction'][0]['name']}",
      "url": "@{body('Parse_JSON')['potentialAction'][0]['targets'][0]['uri']}"
    }
  ]
}

The adaptive card now references the parsed JSON data from the previous step using dynamic content.

Basic setup complete! If you didn't add security validation, you can proceed to Step 8 to save and get your webhook URL. Step 7 adds optional security - skip if not needed.

To secure your webhook, add access_key validation.

Click + after When a Teams webhook request is received, search for Initialize variable
- Name: accessKey
- Type: String
- Value: triggerOutputs()['queries']?['access_key'] (Insert expression)
Click + after Initialize variable, search for Condition
- Left: accessKey (Insert dynamic content)
- Operator: is equal to
- Right: Your generated access_key
Move remaining actions to If yes branch
In If no branch, add Terminate (Status: Failed)

Without this step, anyone with the webhook URL can send alerts to your Teams channel.

Before saving, configure the HTTP trigger settings:

Open the When a Teams webhook request is received trigger
In trigger settings, set Who can trigger the flow to Anyone
Click Save in the top right corner
After saving, open the trigger again and copy the HTTP POST URL

If you added security validation:
Add &access_key=YOUR_ACCESS_KEY to the end of the URL.

Example:
https://prod-xx.azure.com/.../invoke?sig=ABC123&access_key=YOUR_ACCESS_KEY

The Anyone setting allows external services like Pinghome to trigger the flow. Combined with access_key validation (if added), this remains secure.

Make sure 'Who can trigger the flow' is set to 'Anyone' before saving, otherwise Pinghome won't be able to send requests.

Go to your Pinghome dashboard:

Navigate to Notifications → Team Channels
Click + New
Select Microsoft Teams
Paste the webhook URL from step 8 (with access_key parameter if you added security)
Click Submit

See Create Personal Notification Channel for API setup.

Test your setup by clicking Test alert in Pinghome. You should receive a test message in your Teams channel within a few seconds.

If you see the test message in Teams, your integration is working correctly! You're now ready to receive real-time incident notifications.

Common Issues

⚠️Receiving 401 Unauthorized errors

Check that Who can trigger the flow is set to Anyone in the HTTP trigger settings. If set to 'Specific users', Pinghome cannot authenticate and the flow will reject requests.

⚠️Not receiving notifications

Verify that:

The workflow is turned ON in Power Automate
The webhook URL in Pinghome matches the one from your workflow
You have proper permissions in the Teams channel
Check the workflow run history in Power Automate for errors

⚠️Flow terminates (if security enabled)

Check that access_key parameter in URL matches the access_key in your Condition. Verify format: &access_key=.

⚠️Parse JSON action fails

Ensure the schema matches Pinghome's payload structure. Check the run history in Power Automate to see the actual payload received and adjust the schema if needed.

⚠️Adaptive card not displaying correctly

Ensure you're using the exact JSON template provided and that the Parse JSON step completed successfully.

⚠️Dynamic content not showing data

Make sure the Parse JSON action is named exactly 'Parse_JSON'. If you renamed it, update all references in the Adaptive Card template to match the new name.

Additional Information

Customization:

You can customize the Adaptive Card template to match your team's preferences. Visit Adaptive Cards Designer to create custom layouts.

Security:

Limitations:

Power Automate has rate limits. For high-volume notifications, consider upgrading your Microsoft 365 plan.