This article explains how to connect the Microsoft Teams widget to your Teams channel, allowing you to display its content on your screen.
Create a Microsoft Teams widget
- Go to https://portal.azure.com/#home.
Login using an admin account for your organisation - Click "App registrations".
- Click "New Registration".
- You will be redirected to the created application.
- Copy the value next to "Application (client) ID" and save it.
-
Create a client secret by navigating to "Manage > Certificates & secrets" in the left-hand menu.
- Create a "New Client Secret".
- For the description, enter any value, such as "Signage Widget."
- Set the expiration to a maximum of 730 days, or choose a shorter duration if preferred.
- Click "Add".
-
In the row under the "Value" column, click the copy icon to save the Client Secret. Be sure to store it in a text file for later use.
Important: You cannot view this value again! If you don't copy it now, you'll need to create a new client secret.
- Create a "New Client Secret".
-
Add the necessary permissions by navigating to Manage > API permissions in the left-hand menu.
-
Click "Add a permission," then select "Microsoft Graph," followed by "Application permissions."
-
Add the following permissions, then click "Add permissions."
-
Next, click "Grant admin consent for [Your organization]."
- Click on "Yes" in the popup.
- Your application will be ready for use with the widget.
To link the widget to a channel, you'll need the channel's ID. You can retrieve this from within the Microsoft Teams application.
In your team’s channel, click the three dots ("..."") next to the channel name and select "Get link to channel." Click "Copy" and save the link in your text file for later use.Now you have the following values saved in your text file:
- Channel link
- Application (client) ID
- Client Secret
In the Widget Marketplace, create an instance of the Microsoft Teams widget and enter the copied values into the corresponding property fields.
Important: Be sure to add a reminder in your calendar to regenerate the token after 730 days (or the interval you selected), as your widget will stop functioning if the token expires.