This article describes how Kameleon tab can be added to Teams channel with default meta field values e.g. when provisioning Teams channels and Kameleon programmatically.
Kameleon Teams Application must be preinstalled before continue this article Centralized Deployment of Kameleon Teams application
Microsoft Graph
Teams channel tabs can be managed with Microsoft Graph API https://learn.microsoft.com/en-us/graph/api/resources/teamstab?view=graph-rest-1.0
Add new Kameleon tab with default values
Below is example request for adding new tab with
-
{team-id}is Microsoft Teams teamidhttps://learn.microsoft.com/en-us/graph/api/teams-list?view=graph-rest-1.0&tabs=http -
{channel-id}is Microsoft Teams team channelidhttps://learn.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0&tabs=http -
{kameleon-app-id}is Kameleon app id from app catalog https://learn.microsoft.com/en-us/graph/api/appcatalogs-list-teamsapps?view=graph-rest-1.0&tabs=http-
GET https://graph.microsoft.com/v1.0/appCatalogs/teamsApps?$filter=displayName eq 'Kameleon'
-
Define meta field default values
Meta field default values can be defined in URL query parameters for contentUrl. Meta field names can be found in Kameleon portal. More specific information https://help.kameleon.app/kb/create-update-document-panel#Metafields
Request
Below requests adds Kameleon tab to Teams channel with default value for documenttype meta field
POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
"displayName": "Kameleon",
"teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/{kameleon-app-id}",
"configuration": {
"entityId": "",
"contentUrl": "https://teams.kameleon.app/tab?documenttype=Memo",
"websiteUrl": "https://teams.kameleon.app/tab ",
"removeUrl": ""
}
}