How to integrate Microsoft Teams

To integrate Microsoft Teams and Atlan, follow these steps.

Retrieve the team link

To retrieve the team link, from within Microsoft Teams:

1. In the left menu in Microsoft Teams, click Teams.
2. Under Teams, navigate to your team, and to the right of the team name, click the three dots.
3. From the dropdown menu, click Get link to team.
4. From the Get a link to the team dialog, click Copy to copy the team link and save it in a temporary location.

Connect Atlan to Microsoft Teams

Once you have retrieved the team link, you can proceed to connecting Atlan to Microsoft Teams.

Atlan requires the following delegated permissions for the Microsoft Teams integration:

• offline_access — allows the Atlan app to access resources on behalf of the users, even when users are not currently using the app.
• User.Read — allows users to sign in to the app, and allows the app to read the profile of signed-in users.
• AppCatalog.Submit — allows the app to submit application packages to the catalog and cancel submissions that are pending review on behalf of the signed-in user.
• ChannelMessage.Read.All — allows the app to read a channel’s messages in Microsoft Teams, on behalf of the signed-in user (only required if you have admin access to publish the app in Microsoft Teams).
• AppCatalog.ReadWrite.All — allows the app to create, read, update, and delete apps in the app catalogs (only required if you have admin access to publish the app in Microsoft Teams).
• TeamsAppInstallation.ReadWriteSelfForUser — allows a Teams app to read, install, upgrade, and uninstall itself for the signed-in user.

From within Atlan:

1. From the left menu on any screen, click Admin.
2. Under Workspace, click Integrations.
3. In the Microsoft Teams tile, click Connect.
4. In the Add to Microsoft Teams dialog, for Team link, paste the team link you copied from Microsoft Teams above.
5. Click Next to continue.
6. For Publish the Atlan app:
   • If you have Application Administrator access to Microsoft Teams:
     • Click Publish now to publish the Atlan app in your Microsoft Teams workspace.
     • In the Permissions requested popover, check the box for Consent on behalf of your organization to automatically grant access to the application for all users and then click Accept to publish the Atlan app.
   • If you do not have admin access to Microsoft Teams:
     • Click Request to publish.
     • In the Permissions requested popover, click Accept to publish the Atlan app.
     • Contact your Microsoft Teams administrator to approve and publish the Atlan app in your Microsoft Teams workspace.

Add Atlan to the Microsoft Teams directory

Once the Atlan app has been published in your Microsoft Teams workspace, you will need your Teams Administrator to add Atlan to your Microsoft Teams directory.

From within Microsoft Teams:

1. Log in to the Microsoft Teams admin center with Teams Administrator access.
2. In the left menu of Microsoft Teams, click Teams apps and then click Manage apps.
3. On the Manage apps page, use the search bar to search for the Atlan app.
4. To the left of the app name, click the circle to select the Atlan app.
5. From the tabs along the top of the All apps section, click Add to a team.
6. In the Add to a team form, configure the following:
   1. Click the search bar and enter the name of the team to which you want to add the Atlan app. Hover over the team name and then click Add.
   2. Click Apply to confirm your selection(s).

Atlan is now connected to Microsoft Teams! 🎉

Configure integration from Atlan to Microsoft Teams

Now that Atlan is connected to Microsoft Teams, you can configure the Microsoft Teams integration from Atlan.

From the Integrations sub-menu:

1. Expand the Microsoft Teams tile.
2. Under the Configurations tab, configure the following:
   1. For any existing Microsoft Teams integrations prior to February 22, 2024 only, you will need to update the Atlan app in your Microsoft Teams workspace to use new features like enabling notifications for starred assets:
      • If you have Application Administrator access to Microsoft Teams:
        • Click Install now to update the Atlan app in your Microsoft Teams workspace.
        • In the Permissions requested popover, click Accept to update the Atlan app.
      • If you do not have admin access to Microsoft Teams:
        • Click Request update.
        • Contact your Microsoft Teams administrator to update the Atlan app in your Microsoft Teams workspace.
        • Once updated, click Check status in Atlan to view the status of your requested update.
      💪 Did you know? For all new Microsoft Teams integrations from February 22, 2024 onward, no additional configuration required.
   2. For Channels, enter channels to use in your Microsoft Teams workspace to allow users to post to from within Microsoft Teams or get notified about glossary updates. Enter the channel name without a #, and press tab after each channel if you want to enter multiple channels.
   3. (Optional) For Announcements channel, enter the name of a single channel that can be used to view announcements on assets in Atlan.
   4. (Optional) For Workflows alert channel, enter the name of a single channel that can be used to see alerts for workflow activities in Atlan. You can also choose to receive failure alerts only by toggling on the Receive failure alerts only slider.
   5. (Optional) For Playbooks alert channel, enter the name of a single channel that can be used to see alerts for playbook runs in Atlan. You can also choose to receive failure alerts only by toggling on the Receive failure alerts only slider.
3. At the bottom of the tile, click the Update button.

Users can now post to Microsoft Teams without leaving Atlan! 🎉