Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

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.

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:

  1. Sign in to the Azure portal
  2. If you have access to multiple tenants, use the directory + subscription filter in the top menu to select the tenant in which you want to register an application.
  3. Search for and select Azure active directory.
  4. Under Manage, select app registrations, then new registration.
  5. Enter a Name for your application and specify who can use the application.
     
  6. Select register to complete the initial app registration.
  7. Open application capture application (client) ID and directory (tenant) ID from app registration.

  8. Create a new client secret and capture client secret.

    Note

    Record the secret's value for use in your client application code - it's never displayed again after you leave this page.



  9. Create API permissions

    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.


The following image shows the minimum permissions required to send messages to teams and users.
After adding them all, click the Grant admin consent button. You should see checkmarks by each permission in the status column.

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.

Supported Versions

  • All Microsoft Teams versions are supported.

Key Features

  • Send messages to a Microsoft Teams channel or user.

Plugin Operations



  • No labels