Search Crosser Knowledge Base

Microsoft Teams Modules

Modules Covered

  • Microsoft Teams Send
  • Microsoft Teams List Chats
  • Microsoft Teams Send Chat

These modules can be used to send messages to Microsoft Teams channels or chats. 

Entra ID App

The Microsoft Teams modules use Oauth 2.0 for authentication and requires an enterprise app in Entra ID with the right permissions. If you don't already have such an app, follow these steps:

  1. Firstly visit Entra ID here   to create a new App:
  2. Once the app is registered you will see your client_id (called 'Application ID' in Entra ID). You will also need your tenantID, which can be found on the 'Overview' page. Copy both of these values.
  3. Navigate to the 'Certificates & secrets' tab and create a new secret_id: In 'Client secrets', select '+ New client secret'.). Save the value of your new secret.
  4. Now navigate to the 'API permissions' page. Click 'Add a permission'. For these modules to work you need Channel.ReadBasic.All, Team.ReadBasic.All and ChannelMessage.Send for the 'Microsoft Teams Send' module and ChatMessage.Send, Chat.ReadWrite permissions for the chat modules.

Create a credential in Control Center

Note: When you create a credential for use with these modules you do that as a specific user. This user will then be the 'sender' of these messages.

Follow these steps to create an OAuth 2.0 credential in Control Center for use with these modules:

  1. On the Credentials page, click on the '+' button to create a new credential. This will open up the below tool:

  2. Select the OAuth Authorization Code Grant credential type and enter the settings for your Entra ID app.
    The URLs have this format: https://login.microsoftonline.com/{YOUR_TENANT_ID}/oauth2/v2.0/[authorize|token]
  3. Set Scope to: 'offline_access ChatMessage.Send Chat.ReadWrite'.
  4. Click on 'Create Code Grant'
    You now need to login with your Microsoft account, if not already logged in, and accept the connection.
  5. If successful you will end up with a confirmation dialog and the final step is to add the credential to the library by clicking on 'Create Credential'.

Using the Chat modules

When sending chat messages you need to reference the destination chat by providing its ID. If you are using Microsoft Teams from your browser, you can find the chat ID in the URL when you open the relevant conversation. The URL will look something like this: https://teams.live.com/_#/conversations/{CHAT-ID}?ctx=chat. If you are using the Teams app these IDs need to be fetched through the API. By using the List Chats module you can make an API request to list all chats you have access to and find their corresponding IDs. The Send Chat module can then be used to send messages to this chat.

About the author

Goran Appelquist

Göran has 20 years experience in leading technology teams. He’s the lead architect of our end-to-end solution and is extremely focused in securing the lowest possible Total Cost of Ownership for our customers.

"Hidden Lifecycle (employee) cost can account for 5-10 times the purchase price of software. Our goal is to offer a solution that automates and removes most of the tasks that is costly over the lifecycle.

My career started in the academic world where I got a PhD in physics by researching large scale data acquisition systems for physics experiments, such as the LHC at CERN. After leaving academia I have been working in several tech startups in different management positions over the last 20 years.

In most of these positions I have stood with one foot in the R&D team and another in the product/business teams. My passion is learning new technologies, use it to develop innovative products and explain the solutions to end users, technical or non-technical."