Configuración y control de vínculos profundos

2025-02-26

Puede configurar la aplicación de Teams para ejecutar vínculos profundos desde diferentes contextos, como la pestaña personal, la pestaña compartida, el mensaje de chat y el bot.

Pestaña Personal o Compartido

Es posible navegar dentro de una aplicación mediante TeamsJS. En el código siguiente se muestra cómo navegar a una entidad específica dentro de la aplicación de Teams. Las aplicaciones pueden ejecutar un vínculo profundo mediante la biblioteca TeamsJS. Para ejecutar un vínculo profundo, llame a la siguiente API:

TeamsJS v2
TeamsJS v1

Puede desencadenar la navegación desde la pestaña mediante la función pages.navigateToApp() como se muestra en el código siguiente:

if (pages.isSupported()) {
  const navPromise = pages.navigateToApp({ appId: <appId>, pageId: <pageId>, webUrl: <webUrl>, subPageId: <subPageId>, channelId:<channelId>});
  navPromise.
     then((result) => {/*Successful navigation*/}).
     catch((error) => {/*Failed navigation*/});
}
else { /* handle case where capability isn't supported */ }

Para obtener más información sobre el uso de la funcionalidad páginas, consulte pages.navigateToApp() y el espacio de nombres páginas para ver otras opciones de navegación. Si es necesario, también es posible abrir directamente un vínculo profundo mediante la función app.openLink().

Para desencadenar un vínculo profundo desde la pestaña, llame a:

microsoftTeams.executeDeepLink(/*deepLink*/);

Mensaje de chat

Puede configurar la aplicación para publicar mensajes en un chat y agregar vínculos profundos a ellos. Las siguientes son formas diferentes de incluir un vínculo profundo en un mensaje:

Mensaje de texto de hipervínculo

Al agregar un vínculo profundo a un mensaje de texto markdown con hipervínculo, se desencadena y se abre en Teams. A continuación se muestra un ejemplo:

Ejemplo: [App](https://teams.microsoft.com/l/app/{appId}), donde appId es el identificador de la aplicación. Para obtener más información, consulte Id. de aplicación para diferentes tipos de aplicaciones.

Para obtener más información, consulte Uso del formato Markdown en Teams.

Mensaje de texto de vínculo sin formato

Al agregar un vínculo profundo a un mensaje de texto sin formato, se desencadena y se abre en Teams. A continuación se muestra un ejemplo:

Ejemplo: https://teams.microsoft.com/l/app/{appId}, donde appId es el identificador de la aplicación. Para obtener más información, consulte Id. de aplicación para diferentes tipos de aplicaciones.

Tarjeta adaptable

Puede incluir una openURL acción en una tarjeta adaptable y agregarle un vínculo profundo. El vínculo profundo se ejecuta en Teams. A medida que se abran vínculos o hipervínculos sin formato en una tarjeta adaptable en el explorador, se recomienda usar openURL la acción . Para obtener más información, vea Action.OpenUrl.

A continuación se muestra un ejemplo de carga de tarjeta adaptable:


{
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "This card's action will open a URL"
        }
    ],
    "actions": [
        {
    "type": "Action.OpenUrl",
    "title": "Action.OpenUrl",
    "url": "https://teams.microsoft.com/l/app/{appId}"
    }
    ]
}

Control de vínculos profundos

Cuando se desencadene un vínculo profundo a una aplicación de pestaña, asegúrese de que todos los parámetros están establecidos en ese vínculo para el contexto de pestaña. Permite que el contexto de pestaña identifique la página, la subpágina o la etiqueta configurada en el vínculo profundo y abra la sección específica. Para obtener más información, vea Obtener contexto para la pestaña.

Consumir un vínculo profundo desde una pestaña

Cuando Teams navega a la pestaña a través de un vínculo profundo, Teams comprueba si el identificador de subpágina existe y lo recupera a través de la biblioteca TeamsJS.

Si la pestaña se navega a través de un vínculo profundo, las app.getContext() llamadas microsoftTeams.getContext() para comprobar si existe el identificador de subpágina. En la biblioteca teamsJS v2, el identificador de subpágina se denomina subPageIdy, en v1, es subEntityId. Para obtener más información, vea la interfaz PageInfo.

Compartir a través de