Configuración de los tipos de pestañas integradas en Microsoft Teams

Para crear o configurar una pestaña de Microsoft Teams mediante las API de Microsoft Graph, necesitará saber el teamsAppId de la aplicación y entityId, contentUrl, removeUrl y websiteUrl para proporcionarle a ese tipo de aplicación. En este artículo se explica cómo obtener esos valores para los tipos de pestañas integradas.

Pestañas personalizadas

Para usar Microsoft Graph para configurar una pestaña asociada a un proveedor de pestañas que haya escrito, identifique el entityId, contentUrl, removeUrl, y websiteUrl que la interfaz de usuario de configuración de la aplicación proporciona a Microsoft Teams y coloque los mismos valores de entityId, contentUrl, removeUrl y websiteUrl en Microsoft Graph.

El teamsAppId es el mismo que el id en el esquema de manifiesto de aplicación para Microsoft Teams.

Pestañas de sitios Web

Para las pestañas de sitios Web, el teamsAppId es com.microsoft.teamspace.tab.web. La configuración es la siguiente.

Propiedad Tipo Descripción
entityId string Null
contentUrl string Dirección URL del sitio web
removeUrl string Null
websiteUrl string Dirección URL del sitio web

Pestañas de Word, Excel, PowerPoint y PDF.

En la siguiente tabla se enumeran los teamsAppId para cada aplicación.

App teamsAppId type (extension)
Word com.microsoft.teamspace.tab.file.staticviewer.word docx
Excel com.microsoft.teamspace.tab.file.staticviewer.excel xlsx
PowerPoint com.microsoft.teamspace.tab.file.staticviewer.powerpoint pptx
PDF com.microsoft.teamspace.tab.file.staticviewer.pdf pdf

La configuración es la siguiente.

Propiedad Tipo Descripción
entityId string El Id. de sourceDoc del archivo. Para encontrarlo, abra el archivo en SharePoint y mire la barra de direcciones, la dirección URL tendrá una cláusula sourcedoc=%7B{sourceDocId}%7D. También puede obtenerlo de la dirección URL web del elemento de unidad de SharePoint del documento. Para obtener más información, vea GET /groups/{group-id}/drive/items/{item-id}.
contentUrl string La dirección URL del archivo en el formato {folder-webUrl}/{item-name}. {folder-webUrl} es la dirección URL web de la carpeta de SharePoint que contiene el archivo, que puede encontrarse abriendo el archivo en SharePoint y mirando la barra de direcciones o mediante la propiedad de dirección URL web desde GET /groups/{group-id}/drive/items/{folder-item-id}. {item-name} es el nombre de archivo (por ejemplo, archivo.docx), que es la propiedad name en GET /groups/{group-id}/drive/items/{item-id}.
removeUrl string Null
websiteUrl string Null

Ejemplo: Crear una pestaña de Word configurada

En el ejemplo siguiente se crea una pestaña de Word configurada.

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
  "displayName": "word",
  "teamsApp@odata.bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.file.staticviewer.word",
  "configuration": {
     "entityId": "115A90F4-AC9C-4F79-9837-36D1EFB3BE08",
     "contentUrl": "https://m365x165177.sharepoint.com/sites/4NewCloneWithClonableParts/Shared%20Documents/General/Employee Handbook.docx",
     "removeUrl": null,
     "websiteUrl": null
  }
}

Pestañas de bibliotecas de documentos

Para las pestañas de bibliotecas de documentos, el teamsAppId es com.microsoft.teamspace.tab.files.sharepoint. La configuración es la siguiente.

Propiedad Tipo Descripción
entityId string Cadena vacía ("")
contentUrl string Dirección URL de la carpeta raíz de la biblioteca de documentos. Puede encontrar esta dirección URL abriendo la carpeta SharePoint en el explorador, copiando la dirección URL y eliminando "/Forms/AllItems.aspx" y todo después de eso.
removeUrl string Null
websiteUrl string Null

Ejemplo: Crear una pestaña de biblioteca de documentos configurada

En el siguiente ejemplo se crea una pestaña de biblioteca de documentos configurada.

POST https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/tabs
{
    "displayName": "Document%20Library1",
    "teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/com.microsoft.teamspace.tab.files.sharepoint",
    "configuration": {
        "entityId": "",
        "contentUrl": "https://microsoft.sharepoint.com/teams/WWWtest/Shared%20Documents",
        "removeUrl": null,
        "websiteUrl": null
    }
}

Pestañas de Wiki

Para las pestañas de Wiki, el teamsAppId es com.microsoft.teamspace.tab.wiki. Las pestañas Wiki no admiten la configuración a través de Microsoft Graph. Tenga en cuenta, sin embargo, que no hay mucho que configurar: en una pestaña wiki sin configurar, el primer usuario solo tiene que seleccionar la pestaña Configurar para configurarla.

Pestañas de Planner

Para las pestañas planner, teamsAppId el es com.microsoft.teamspace.tab.planner . Esta configuración no se admite.

Pestañas de Microsoft Stream

Para las pestañas de Microsoft Stream, el teamsAppId es com.microsoftstream.embed.skypeteamstab. Esta configuración no se admite.

Pestañas de Microsoft Forms

Para las pestañas de Microsoft Forms, el teamsAppId es 81fef3a6-72aa-4648-a763-de824aeafb7d. Esta configuración no se admite.

Pestañas de OneNote

Para las pestañas de OneNote, el teamsAppId es 0d820ecd-def2-4297-adad-78056cde7c78. Esta configuración no se admite.

Pestañas de Power BI

Para las pestañas de Power BI, el teamsAppId es com.microsoft.teamspace.tab.powerbi. Esta configuración no se admite.

Pestañas de páginas y listas de SharePoint

Para las pestañas de páginas y listas de SharePoint el teamsAppId es 2a527703-1f6f-4559-a332-d8a7d288cd88. Esta configuración no se admite. Si quiere configurar la pestaña, puede usar una pestaña del sitio web.