Add a SharePoint site as a custom app within Teams

For the app to work you need 3 files:

Manifest.json and two image files png 400×400 in size

(one to be used on the tool bar and one to be used within the app)

Once you have all three files and the json is configured zip the contents together and use that zip file to upload into teams

If an app has already been added but needs updating to go apps then ‘Built for company name tenant

Find the app, click three dots and then update

Manifest file example and list of lines which needs modifying for your custom SharePoint site and info:

{
“$schema”: “https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json”,
“manifestVersion”: “1.5”,
“version”: “1.4.0”,
“id”: “05db8546-1517-4306-8dda-7278e8272226”,
“packageName”: “com.microsoft.teams.m365lp”,
“developer”: {
“name”: “In IT Together”,
“websiteUrl”: “https://aka.ms/MicrosoftAdoption”,
“privacyUrl”: “https://microsoft.com/privacy”,
“termsOfUseUrl”: “https://aka.ms/m365lpdocs”
},
“icons”: {
“color”: “color.png”,
“outline”: “outline.png”
},
“name”: {
“short”: “Get Started”,
“full”: “Getting Started with Office 365”
},
“description”: {
“short”: “Training tools for Office 365 applications”,
“full”: “Get started with on demand training for Office 365”
},
“accentColor”: “#DC3E15”,
“staticTabs”: [
{
“entityId”: “20300621111”,
“name”: “Training Portal”,
“contentUrl”: “https://inittogether.sharepoint.com/sites/learningpathways”,
“websiteUrl”: “https://inittogether.sharepoint.com/sites/learningpathways”,
“scopes”: [
“personal”
]
},
{
“entityId”: “20200621112”,
“name”: “Teams Training”,
“contentUrl”: “https://inittogether.sharepoint.com/sites/learningpathways/SitePages/Get-started-with-Microsoft-Teams.aspx”,
“websiteUrl”: “https://inittogether.sharepoint.com/sites/learningpathways/SitePages/Get-started-with-Microsoft-Teams.aspx”,
“scopes”: [
“personal”
]
},
{
“entityId”: “20200621154”,
“name”: “OneDrive Basics”,
“contentUrl”: “https://inittogether.sharepoint.com/sites/learningpathways/SitePages/Get-started-with-OneDrive.aspx”,
“websiteUrl”: “https://inittogether.sharepoint.com/sites/learningpathways/SitePages/Get-started-with-OneDrive.aspx”,
“scopes”: [
“personal”
]
}
],
“permissions”: [
“identity”,
“messageTeamMembers”
],
“validDomains”: [
“inittogether.sharepoint.com”
]
}

Line 4: every time you update the app you have to update the version number or the app upload will fail when uploading

Line 5: id – create a new GUID for an app which will be unique, once created it does not need changing

Lines 9 – 11 – URLs which point to privacy and terms URL which can be seen when browsing the app settings or About within the team app, redirect to your organisation URLs

Line 15 & 16 – png files which are used for the tiles within teams, these images have to be in same zip file as the manifest file

Line 18 & 19 – name the app

Line 22 & 23 – this shows in the about tab or within the app upload description

Line 25 – keep the same accent code

Line 28 – 61 – these are tabs across the app within teams and the URL paths they point to, can add or remove tabs as required (entityID needs to be different between each tab within the json), the order of the tabs listed will be the same format in teams

Line 62 – remember no comma after last tab entry

Line 64 – leave permissions as is, sharepoint will deal with the permissions

Line 69 – have to specify valid root sharepoint site for the domain

Deploy the app to all users:

Admin.teams.microsoft.com (teams apps – setup policies)

Select Global org-wide

Within this policy add the app and move the tile to selected location by moving app up or down

Can take long time to deploy to all users, potentially up to 24 hours

For certain users to have certain apps, we can create new setup policies, add that unique app in and then go to Admin.teams.microsoft.com – users and update their app setup policy

Can select up to 20000 users at a time to update their policy

Share
Ryan Wilson
Azure and Office 365 Technical Architect | Microsoft Certified Solutions Associate: Office 365 | Microsoft Certified: Azure Solutions Architect Expert | Microsoft Certified Solutions Expert: Productivity | Microsoft 365 Certified: Enterprise Administrator Expert | Microsoft 365 Certified: Messaging Administrator Associate

Leave a Reply

Your email address will not be published. Required fields are marked *