Installation guide to Microsoft Teams

Pre-requirements:
Administrator access for MS Teams and Microsoft Azure is required for the person doing the installation.

  1. In Microsoft Teams go to the apps section and search for an app called app studio

2. Add App Studio. This is required in order to package your custom app integration for your organization.

3. Start by creating a new app

  1. Make sure you provide a relevant app name as your users my look at the profile of the app/bot to see more details regarding the context of the communication with the app. Generate an app id and provide a package name as an example below. Provide your own descriptions of the app. In the developer, the section provides the information as provided in this documentation below. Make sure you also provide the necessary icon and image files to create the app.
  1. In the left-hand section, select the bot section and set up a new bot for this app.
  1. Once creating the bot. Make sure you click on the generate password button and copy the value somewhere as we will need this value during the rest of this installation process. Also, make sure you provide the messaging endpoint as https://preppapp.com/api/messages
  1. We are almost done here. Go to the Test and distribute the section on the left and download the package.
  1. You then need to go to https://admin.teams.microsoft.com/ and upload the app in your organization app catalog.

11. Go to manage the app section and select upload.  Upload the package you created in the previous step and you should see your custom app available in the manage app list.

12. Select the app you uploaded to see its details page.

13. Make a copy of the catalog App id. We need this catalog app id for installing the bot in the Prepp application.

Head over to the Azure portal. We need to get a few settings from the Azure portal in order to complete the installation. After log-in, search for App registration:

14. Select the application (in this example called Onboard Me).

15. Make sure you copy the application id and the tenant id somewhere so that we can refer to them later when doing the installation.

16. Go to the API permission section to start granting API permissions to the application. This is needed in order for the app to get hold of groups/teams and members of Teams information, in addition, to install the app for each user so that we can send proactive messages.

Select add permissions and on the right-hand side select Microsoft Graph.

17. Select Application permissions.

18. Search and add the following permissions:

User.Read.All

Group.Read.All

GroupMember.Read.All

Chat.ReadBasic.All

TeamsAppInstallation.ReadWriteForUser.All

Once you are done with adding the permissions you should see the following list of permissions that we need to grant request for.

19. Click on the “Grant admin consent for the XXXX button”. You need to then reload the page (the refresh button here may not always work). You should then see the below with a green checkmark beside each permission requested.

You are all done here.

20. You need to go to the Prepp application to start the installation process.

Log into the Prepp application, you will need administrator privileges. Under the profile section select the settings page and add a bot. You will need to select a Microsoft Teams bot.

21. Provide the keys you made a copy of earlier and insert them here. The application id and the tenant id as stated earlier can be found in the Microsoft Azure app registration section for the given app. The app secret key is the same key as when we generated a password for the bot inside Microsoft App Studio. The app catalog application id is available from the Microsoft Teams Admin tool and Manage App section there as shown earlier. The installation will proceed and depending on the size of your organization this could take between a few minutes and up to an hour time.