Guides
/
Provider Configuration
/
Teams Notification Provider Configuration Guide

Teams Notification Provider Configuration Guide

This guide provides instructions on how to configure the Teams Notification provider,

1. For Public Webhooks

Teams can be configured to allow public webhooks. This means that anyone can send a message to a channel. To create a public webhook, follow the steps below.

1. Create a Webhook - Common steps for public and authenticated webhooks

  1. Log in to Entra ID with a user having write permissions to Power Automate ; Navigate to make.powerautomate.com.
  2. Click on Create -> Instant cloud flow.
  3. Give it a unuque flow name
  4. Click on When a Teams webhook request is received.
  5. Click on Create.
  6. Click on the block When a Teams webhook request is received.
  7. For Who can trigger the flow?, select Anyone.
  8. Click on the "+" icon below this step to add an action.
  9. Click on Add an action.
  10. Search for "Parse JSON". Under Data Operations click on Parse JSON.
  11. Click in the text box under Content, click on the blue bar to the right and select the spark like icon. Click on Body
  12. Under Schema click on "Use sample payload to generate schema".
  13. In the popup that appears, paste the following JSON payload:
    {
"message": "My Message",
"TeamID": "teamId",
"ChannelID": "channelId"
}
  14. Click on Done.
  15. Click on the "+" icon below Parse JSON to add an action.
  16. Click on Add an action.
  17. Click on Microsoft Teams under Add an action.
  18. Click on Post card in a chat or channel.
  19. Fill in the following details:
    • Post As: Flow bot (keep unchanged)
    • Post In: In drop down select Channel
    • Team: Click in the text box, and in the blue bar to the right, click on fx. In search box under "Function" search for "body". Select triggerBody(). In the text box above edit the text to triggerBody()?['TeamID']. Click on Add
    • Channel: Click in the text box, and in the blue bar to the right, click on "fx". In search box under "Function" search for "body". Select triggerBody(). In the text box above edit the text to triggerBody()?['ChannelID']. Click on Add
    • Adaptive Card: Click in text box , and in the blue bar to the right, click on "fx". Click on Dynamic content. Click on Body message. Click on Add.
  20. Click on Save.
  21. Click on When a Teams webhook request is received and copy the HTTP URL.

2. Get the Channel ID and Team ID to post to

  1. In Teams, navigate to the channel you want to post to on the list of channels
  2. Click on the three dots next to the channel name.
  3. Click on Get link to channel.
  4. Copy the URL. The channel ID is the last part of the URL. The team ID is the part of the URL before the channel ID.
  5. For example if the link is "https://teams.microsoft.com/l/channel/XXX17f4%40thread.tacv2/test?groupId=f47c4a46-XXX" then the team ID is "f47c4a46-XXX" and the channel ID is "XXX17f4%40thread.tacv2".

3. Configure your Integration

  1. Ensure you have the following items
    • Webhook URL: The URL copied from the "When a Teams webhook request is received" block.
    • Channel ID: The channel ID copied from Teams.
    • Team ID: The team ID copied from Teams.
  2. Create your integration by supplying the following values.
  • Credential / WebhookUrl : Paste the webhook URL.
  • ChannelId : Paste the channel ID.
  • TeamId : Paste the team ID.
  1. Do not set the following parameters: Credential / OAuthClient , TenantId or Endpoint.

2. For Authenticated Webhooks

Teams can be configured to allow authenticated webhooks. This means that only users with the correct credentials (Tenant ID, Client ID and Client Secret) can send a message to a channel. To create an authenticated webhook, follow the steps below.

1. Create a Webhook - Common steps for public and authenticated webhooks

  1. Log in to Entra ID with a user having write permissions to Power Automate ; Navigate to make.powerautomate.com.
  2. Click on Create -> Instant cloud flow.
  3. Give it a unuque flow name
  4. Click on When a Teams webhook request is received.
  5. Click on Create.
  6. Click on the block When a Teams webhook request is received.
  7. For Who can trigger the flow?, select Any user in my tenant.
  8. Click on the "+" icon below this step to add an action.
  9. Click on Add an action.
  10. Search for "Parse JSON". Under Data Operations click on Parse JSON.
  11. Click in the text box under Content, click on the blue bar to the right and select the spark like icon. Click on Body
  12. Under Schema click on "Use sample payload to generate schema".
  13. In the popup that appears, paste the following JSON payload:
    {
"message": "My Message",
"TeamID": "teamId",
"ChannelID": "channelId"
}
  14. Click on Done.
  15. Click on the "+" icon below Parse JSON to add an action.
  16. Click on Add an action.
  17. Click on Microsoft Teams under Add an action.
  18. Click on Post card in a chat or channel.
  19. Fill in the following details:
    • Post As: Flow bot (keep unchanged)
    • Post In: In drop down select Channel
    • Team: Click in the text box, and in the blue bar to the right, click on fx. In search box under "Function" search for "body". Select triggerBody(). In the text box above edit the text to triggerBody()?['TeamID']. Click on Add
    • Channel: Click in the text box, and in the blue bar to the right, click on "fx". In search box under "Function" search for "body". Select triggerBody(). In the text box above edit the text to triggerBody()?['ChannelID']. Click on Add
    • Adaptive Card: Click in text box , and in the blue bar to the right, click on "fx". Click on Dynamic content. Click on Body message. Click on Add.
  20. Click on Save.
  21. Click on When a Teams webhook request is received and copy the HTTP URL.

2. Get the Channel ID and Team ID to post to

  1. In Teams, navigate to the channel you want to post to on the list of channels
  2. Click on the three dots next to the channel name.
  3. Click on Get link to channel.
  4. Copy the URL. The channel ID is the last part of the URL. The team ID is the part of the URL before the channel ID.
  5. For example if the link is "https://teams.microsoft.com/l/channel/XXX17f4%40thread.tacv2/test?groupId=f47c4a46-XXX" then the team ID is "f47c4a46-XXX" and the channel ID is "XXX17f4%40thread.tacv2".

3. Create Azure AD App Registration

  1. Navigate to portal.azure.com and login with your Entra ID account having admin permissions.
  2. In search bar above, search for App registrations and click on it.
  3. Click on New registration.
  4. Fill in the following details:
    • Name: Enter a name for the app registration.
    • Supported account types: Select the appropriate account type. We suggest you use Accounts in any organizational directory (Any Microsoft Entra IO tenant - Multitenant).
    • Redirect URI: Do not enter
  5. Click on Register.
  6. In the left pane, click on Certificates & secrets.
  7. Click on New client secret. Click Add.
  8. Copy the Value of the client secret. This is the client secret. You will not be able to see this value again. Copy the Secret ID as well. Store in a secure location. This will be the client ID and client secret.
  9. In the left pane, click on API permissions.
  10. Click on Add a permission.
  11. Click on Power Automate ; Click on User under Other permissions. Click on Add permissions.
  12. Click on Overview and copy the Directory (tenant) ID. This is the tenant ID.

4. Configure your Integration

  1. Ensure you have the following items
    • Webhook URL: The URL copied from the "When a Teams webhook request is received" block.
    • Channel ID: The channel ID copied from Teams.
    • Team ID: The team ID copied from Teams.
    • Tenant ID: The tenant ID copied from Azure AD App Registration.
    • Client ID: The client ID copied from Azure AD App Registration.
    • Client Secret: The client secret copied from Azure AD App Registration.
  2. Create your integration by supplying the following values.
    • Endpoint : Paste the webhook URL.
    • TenantId : Paste the tenant ID.
    • Credential / OAuthClient / ClientId : Paste the client ID
    • Credential / OAuthClient / ClientSecret : Paste the client secret.
    • ChannelId : Paste the channel ID.
    • TeamId : Paste the team ID.
  3. Do not set the following parameters: Credential / WebhookUrl.
Previous page
Next page