Upload your Workspace app in Teams
Table of Contents
- Setup policies
You can integrate Workspace 365 as an application within Microsoft Teams. For this, the manifest.json ZIP file is required including the app icons. It can be found under the Downloads section and is only available to our partners.
As an admin, make sure that the Workspace app is available in the Teams App Store for the users in your tenant.
If you already had your Workspace app published in Teams for the users in your tenant, you must execute the steps in step 2 and edit/replace the manifest.json file, reupload the zip file in the Microsoft Teams admin center and publish the app.
Step 1. Edit and zip the manifest.json file
- Download and unzip the Workspace365-Teams-App ZIP file.
- Change the ContentURL to your own URL:
- You can change the display name of the Workspace app in Teams, which is determined by the short name. In the example below, the display name in Teams will be "WS 365". Bare in mind when choosing a name containing too many characters, it won't be fully displayed in Teams.
"short": "WS 365"
"full": Workspace 365"
- Go to your Workspace SSO app registration in Azure AD.
- On the overview page, copy and save the Application (client) ID.
- Add the following code to add new properties to your Teams application manifest:
- Zip the manifest.json file including the app icons.
Step 2. Under your Workspace SSO app registration in Azure AD, create a scope defined by this API and authorize the client application
- Under Manage, select Expose an API.
- Select Add a scope. In the panel that opens, enter access_as_user as the Scope name.
- In the Who can consent? box, enter Admins and users.
- Enter the details in the boxes for configuring the admin and user consent prompts with values that are appropriate for the access_as_user scope:
- Admin consent display name: Teams can access the user’s profile.
- Admin consent description: Teams can call the app’s web APIs as the current user.
- User consent display name: Teams can access your profile and make requests on your behalf.
- User consent description: Teams can call this app’s APIs with the same rights as you have.
- Ensure that State is set to Enabled.
- Select Add scope to save the details.
- In the Authorized client applications section, identify the applications that you want to authorize for your app’s web application.
- Select Add a client application.
- Enter each of the following client IDs and select the authorized scope you created in the previous step:
- 1fec8e78-bce4-4aaf-ab1b-5451cc387264 (for Teams mobile or desktop application).
- 5e3ce6c0-2b1f-4285-8d4b-75ee78787346 (for Teams web application).
- Select Add application.
- For further detailed information about the SSO setup, click here.
Step 3. Upload the zipfile in the Microsoft Teams admin center
- Upload the created zipfile in the Microsoft Teams admin center:
- Go to Teams apps and select Manage apps.
- Click on Upload to upload the ZIP file.
- Click here for further detailed information.
- Now the user can add the app themselves or you could create a policy to push the app to the users automatically.
Once the app is uploaded in the Teams App Store, as an admin you can manage app setup policies. To create a policy, do the following:
- Go to Teams apps.
- Choose Setup policies.
- Click on Add or change the current policy to add the Workspace 365 Teams app to the users left sidebar.
Automatically install the app for users
If you want to install the app for users automatically when they start Teams, follow these steps:
- In the Add installed apps pane search for the app you want to automatically install. You can also filter apps by app permission policy.
- Then, select Add.
Change app order in the Teams app navigation bar
It's also possible to arrange the apps in the order that you want them to appear in Teams.
- Under Teams apps, select Setup policies.
- Go to Pinned apps.
- You can select an app and move it up- or downwards.
- Then, select Save.
Add the Workspace app as a user
When the app has been made available in the Teams App Store by the admin, the users can now add the Workspace app to Teams.
- Click on Apps and search for the app.
- Click on Add to add it to Teams.
- The Workspace app is now added to Teams.