Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Sending teams messages without setting up an Office 365 connector requires an authenticated user to send the messages. This user (or users) is stored in a Teams Messaging Account in FlexDeploy which can be managed at Topology->Integrations->Messaging.

The required prerequisites for sending messages this way are explained below.

This setup method is also required for approving tasks from Microsoft Teams. So, to approve tasks from Microsoft Teams (available in the 5.5.0.2 release), you must configure BOTH webhooks and a Teams Messaging Integration.

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->Integrations→Messaging >Messaging and create a new Account with the Provider set to MicrosoftTeams.

Image Modified

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.

...

  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.
    Image RemovedImage Added
  5. Enter a Name for your application and specify who can use the application.
     Image RemovedImage Added
  6. Select register to complete the initial app registration.
  7. Open application capture application (client) ID and directory (tenant) ID from app registration.

    Image RemovedImage Added

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

    Info
    titleNote

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



    Image Modified

  9. Create API permissions

    Select API permissions > Add a permission > Microsoft Graph

    Image Removed



    Image Added


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 - This permissions is required to approve tasks through Microsoft Teams.
  • 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 RemovedImage Added

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.
Image Removed
Image Added

Setting up Certificates

You may need to install the certificate for https://graph.microsoft.com/.default into your Java keystore if you . If this is the case, you will 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

...