This document describes how to setup Microsoft (MS) Teams App.
MS Teams App Setup
To configure MS Teams App, perform the following steps:
- Log in to MS teams Application using the following URL:
https://teams.microsoft.com - Navigate to Apps > Developer Portal.
Figure: Developer Portal - Create a New App using Developer Portal > Apps > New app.
Figure: Apps - Enter App name in Add app pop-up and click Add.
Figure: Add app - Specify the required fields under Basic information tab.
Figure: Basic information - Upload images under Branding tab.
Figure: Branding - Select Bot under App features tab.
Figure: App features - After selecting Bot:
- Select "Enter a bot ID" option and fill the app ID created/captured from Azure bot where we enabled the MS Teams channel.
Note: The SymphonyAI Summit DevOps teams will share the app ID. - Select the scopes from the following options:
- Personal
- Team
- Group Chat
Figure: Bot Details
- Select "Enter a bot ID" option and fill the app ID created/captured from Azure bot where we enabled the MS Teams channel.
- Add the domains for which the App/bot needs to access under Domains tab. Enter the domain name and click Add.
Figure: Add domain - Select Publish to Org under Publish section.
Figure: App Features - Click Publish your app. A record is created, and the status will be Submitted.
Figure: Publish to your org (Submitted) - Once it gets approved from IT Admin, the status will be Published.
Figure: Publish to your org (Published)
IT Admin Activity
The following are the actions for an Admin to perform:
Allow and block apps
An admin can allow or block individual apps at the organization level on the Manage apps page. The page displays all the available apps and their current org-level app status. The list of apps includes apps provided by Microsoft, by third-party developers, and by developers within your organization.
Perform the following steps to allow or block an app:
- Sign into the Teams admin center and navigate to Teams apps > Manage apps.
- Select an app from the list of apps. You can search by the name of the app.
- Select Allow or Block option.
When you allow (or block) an app on the Manage apps page in Teams admin center, the specific app is allowed (or blocked) for all users in your organization.
View a request
Sign into the Teams admin center and navigate to Teams Apps > Manage apps.
Figure: Upload new app
To view and check the number of requests for each app, sort the requests in the Requests by user column. You can't view the name of the users who requested an app.
To allow an app, select the name of the app and it opens the app details page.
Select Manage requests and complete the steps displayed in the popup dialog. Based on the method used to block an app, one or more of the following steps are required to unblock it:
- If the app is blocked using permission policies, allow the app by modifying permission policies.
- If the app is blocked for all users, allow the app.
- If all apps are blocked for all users, modify org-wide settings.
If an admin allows an app, then Teams doesn't inform the end-user that their request is acted upon. The user can view the app in the Teams Store to check if they can add the app to their Teams client or not. If the app is approved by an admin, users can add it. Alternatively, if and admin doesn't approve the request and dismisses it, then end-users can request it again.
End-users Access
To provision end-user access, perform the following steps:
- Select Apps menu, find the app under Built for your org section.
Figure: Built for your org
Scenario I - First Access by the end-user - Click Add to start the conversation.
Figure: Add CINDE - It displays the CINDE conversation page.
Figure: CINDE Conversation Page
Scenario II - Second Time Access by End-User - Click Open and start the conversation.
Figure: Open CINDE - It displays the CINDE conversation page.
Figure: Add CINDE
References
- App setup Overview
https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-publish-overview
- Create Teams App Package
https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/apps-package#outline