Skip to main content
All CollectionsIntegrationsTeams
Step 1. Edit and zip the manifest.json file
Step 1. Edit and zip the manifest.json file
Updated over a week ago

Introduction

To add the Workspace 365 app to Teams, the first step is to configure the manifest.json file according to your workspace setup. In this article, we explain how.

Instructions

Download the 'Workspace365-Teams-App' ZIP file

  1. Download the ZIP file from our downloads page.

Edit the manifest file

Note: when following the instructions below, bear in mind that the entered Workspace URL must contain a domain which is available in the customer's Azure tenant. This could be a subdomain or a custom URL.

  1. Unzip the downloaded file.

  2. Right-click the manifest file and open it with Notepad or Notepad++.

  3. Change the ContentURL. Adjust the red text to your own Workspace environment URL.

    "contentUrl": "https://workspace365instance.url/environmentname/Embed/Teams",

  4. You can determine the display name of the Workspace app in Teams by changing the short name to your liking.

    Bear in mind that when choosing a name containing too many characters, it won’t be fully displayed in Teams.

    In the example below, the display name in Teams will be “WS 365”.

    "name": {
    "short": "WS 365"
    "full": "Workspace 365"
    },
  5. In Microsoft Entra ID (previously called Azure AD), go to your Workspace SSO app registration.

  6. Go to the Overview page.

  7. Note down the Application (client) ID.

  8. Select Expose an API.

  9. Click the pencil icon (or click 'Set') to adjust the Application ID URL.

  10. The Application ID URL should have the following format, replace instance with your own instance URL without the HTTPS (e.g. example.workspace365.net):
    api://instance/00000000-0000-0000-0000-000000000000

  11. Click Save.

  12. In the manifest.json file, adjust the webApplicationInfo. For both values, keep the quotation marks.

    • “id”: replace this with the Application (client) ID you got from step 7.

    • “resource”: replace this with the same format as the Application ID URL.

      "webApplicationInfo": {
      "id": "00000000-0000-0000-0000-000000000000",
      "resource": "api://instance/00000000-0000-0000-0000-000000000000"
      },
  13. Save the changes you made to the manifest.json file.

  14. Select the manifest.json, Icon-Medium.png and Icon-Small.png files and add them to a ZIP-file.

It must be a .zip file.

Proceed to step 2.


Did this answer your question?