MS Teams integration

The MS Teams integration gives users the ability to chat at the speed of conversation (latency of 5 seconds or less) with other users inside your digital workplace using Microsoft Teams. When configuring the integration, you can select which team or channel from Microsoft Teams is available. If no team or channel is specified, users will see all the teams and channels they have access to on their Microsoft Teams account. After signing into the integration, users can navigate their configured teams and channels and see and reply to messages. When viewing conversations, users can see images and gifs, download files, and select links.  

Sections in this article: 

Considerations and caveats

Microsoft license

Your organization must have a Microsoft license for the M365 E series of SKUs in order to properly utilize the MS Teams integration.

Security and privacy

The MS Teams integration provides a window into MS Teams through an authenticated session in a user's browser. While Igloo facilitates the initial Igloo/MS interaction via a proxy login process, after this connection is established only the user has access to MS Teams data. No data is read or retained by Igloo.


You must sign in to the integration using your Microsoft Teams credentials.

After signing in, you will only see the teams and channels that you have access to and that have been configured for the integration. If the integration is configured to show a team or channel to which you do not have access, you will not see it. 

To sign out, go to the Teams tab and select Sign out. You will need to sign back into the integration to view and interact with conversations.

Widget layout

The teams tab.

Location Description

Select a team to expand it and see its channels.


Select a channel to view its conversation feed.


Conversation Feed

The conversations feed.

Location Description
Teams tab

At the top of the feed, select the team/channel name to view the Teams tab.

See more / less

Select See More to expand long conversations and replies. Select See less to collapse these again.

# replies

Select # replies to view replies to a conversation. Select Collapse all to hide these replies again.


Select Reply to reply to an existing conversation.

New conversation

Select New conversation to start a new one. After selecting Reply or New Conversation, you can enter your text-only message in the provided text box.

If you need to edit or delete your message, you must do so from the Microsoft Teams application.



Set up

  1. Place an  Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Igloo Integration Library.
  4. Select Igloo Software MS Teams from the library.
  5. Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  6. In the widget editor, select Update to apply your changes.
  7. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Finding the team or channel link 

You can restrict the integration to a specific team or channel by specifying its link. To find this link, open Microsoft Teams. Next to the team or channel that you want to use, select More Options followed by Get link to team/Get link to channel. Then, select Copy

Office 365 administrator sign in

Only users who have the role of Global Administrator in your Office 365 portal can approve this integration.

The first time you ever set up the integration anywhere in your digital workplace, your Office 365 administrator must be the first one to sign in to it.  When signing in, they will receive a popup that asks to give the integration permissions. They must select Consent on behalf of your organization followed by Accept to grant these.  

This only needs to be done once per Office 365 environment. Once an O365 administrator allows the app, the integration can be used anywhere in your digital workplace without additional administrator approvals.

The request for permissions.


Options tab

Setting Description

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.

Title link

Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.


Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.

General options
Setting Description
Team or Channel Link

Enter the link of the team or channel that you want to restrict the integration to. Users must have access to this team or channel to see and interact with it. For instructions on how to get this link, see the Finding the team or channel link section above.

If left blank, users will see all the teams and channels that their account has access to. To include a private channel, you must enter the link for the team that it is a part of (this will cause other channels from this team to be displayed as well).

Advanced options

Appearance tab

Appearance options
Setting Description

Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.


Select the height of the widget.

The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px.

Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar.


Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.