A plugin to send messages to MicrosoftTeams channel or user. This plugin allows you to send notifications to MicrosoftTeams from FlexDeploy workflows. Users have the freedom to create messages as complex or as simple as they desire.

This plugin uses Teams Messaging Accounts in FlexDeploy which can be managed from Topology->Integrations->Messaging.

Teams Messaging Accounts

This plugin uses a Teams Messaging Account which contains all relevant credentials to connect to the Teams workspace. Navigate to Topology->Integrations→Messaging and create a new Account with the Provider set to MicrosoftTeams.

Image Removed

Create an Application in the Azure portal

You must create an application in the Azure portal so the Microsoft identity platform can provide authentication and authorization services for your application.

Follow these steps to create the app registration:

...

Image Removed

Create a new client secret and capture client secret.

...

Select API permissions > Add a permission > Microsoft Graph

...

Select delegated permissions.  You can type the names of these permissions in to filter and find the necessary permissions quickly. The 7 or 8 permissions you need are:

• Channel.ReadBasic.All
• ChannelMessage.Send
• Chat.ReadBasic
• ChatMessage.Send
• Team.ReadBasic.All
• User.ReadBasic.All
• Chat.ReadWrite - This permission is a new requirement in 5.5.0.2. It is only needed when chatting to individual users, the first time that a message is send to that user.
• Group.ReadWrite.All - Only needed if the user is not a member of the team(s) to which they are sending messages. This permission is optional, and was added in the 5.5.0.2 release.

Image Removed

...

Setting up Certificates

You may need to install the certificate for https://graph.microsoft.com/.default into your Java keystore if you get an error about building a certificate path.There are 4 operations in this plugin, which work in two separate ways. Please take note of their differences, and then look at the additional documentation as needed.

Operations that use Incoming Webhooks to send messages to Teams Channels

To set up these operations, view the page Configuring the MicrosoftTeams Plugin for sending messages with Webhooks

teamSendWebhookTextNotification

teamSendWebhookJsonNotification

Operations that use User Credentials to send messages to Teams Channels or Individual Users

To set up these operations, view the page Configuring the MicrosoftTeams Plugin for sending messages to users and channels without webhooks for more information.

teamSendNotification

userSendNotification

Supported Versions

• All Microsoft Teams versions are supported.

Key Features

• Send messages to a Microsoft Teams channel or user.

Plugin Operations

...