Examples: Integration with MS Teams

There are two ways how Integration with MS Teams can be configured:

(Basic) [Using MS Teams Webhook] (doc:examples-integration-with-ms-teams#integration-using-ms-teams-webhook)
(Advanced) [Using MS Teams API] (doc:examples-integration-with-ms-teams#integration-using-ms-teams-api)

Integration Using MS Teams Webhook

🚧
Basic integration via webhook doesn't support mentions. For this purpose please check advanced option using MS Teams API

In a new or existing channel that will be used for alerts, open “Connectors”:

Create a new Incoming Webhook connector, call it “Targetprocess Notification Center”, upload a logo (feel free to use the below one)

As a result you will get the generated Webhook URL.

Copy MS Teams Webhook URL and paste it into the MSTeamsURL Custom field in Project Details

Create a text custom field MSTeamsID for Users
Open Graph Explorer, log in there with your Microsoft credentials and check needed User Ids with this query https://graph.microsoft.com/v1.0/users
Copy these Ids to MSTeamsID custom field in Targetprocess for your users. This should be done for all users for which mention will be sent in MS Teams

Open Graph Explorer, log in there with your Microsoft credentials and check your team id with the query https://graph.microsoft.com/v1.0/me/joinedTeams
Check your channel Id by using your team Id from previous step and query
https://graph.microsoft.com/v1.0/teams/{team-id}
The query which you should make POST to will be in the format
https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/messages

Open Graph Explorer, log in there with your Microsoft credentials and check Access Token tab as shown in the screenshot below

Updated over 2 years ago