Compartir a través de

Configuración de opciones predeterminadas para la aplicación Teams

  • Artículo

Es habitual que una aplicación admita varios escenarios en Teams, pero es posible que la haya diseñado teniendo en cuenta un ámbito y una funcionalidad específicos. Por ejemplo, si la aplicación es principalmente para uso de equipo o canal, puedes asegurarte de que la primera opción de instalación que los usuarios ven en la Tienda Microsoft Teams es Agregar a un equipo.

Captura de pantalla que muestra la opción Agregar a un equipo.

Si la funcionalidad principal de la aplicación es un bot, también puede convertir el bot en la funcionalidad predeterminada cuando un usuario instala la aplicación en un equipo.

Configuración del ámbito de instalación predeterminado de la aplicación

Configure el ámbito de instalación predeterminado para la aplicación. Solo puede establecer un ámbito a la vez. Para obtener más información, vea manifiesto de aplicación.

Para configurar el ámbito de instalación predeterminado en el manifiesto de la aplicación:

  1. Abra el manifiesto de la aplicación y agregue la defaultInstallScope propiedad .

  2. Establezca el valor predeterminado del ámbito de personalinstalación como , , teamgroupchato meetings.

    "defaultInstallScope": "meetings",

Configuración de la funcionalidad predeterminada para ámbitos compartidos

Configure la funcionalidad predeterminada cuando la aplicación esté instalada para un equipo, reunión o chat de grupo. Para obtener más información, vea manifiesto de aplicación.

Nota:

defaultGroupCapability proporciona la funcionalidad predeterminada que se agrega al equipo, al chat en grupo o a la reunión. Seleccione una pestaña, un bot o un conector como la funcionalidad predeterminada para la aplicación, pero debe asegurarse de que ha proporcionado la funcionalidad seleccionada en la definición de la aplicación.

Para configurar los detalles en el manifiesto de la aplicación:

  1. Abra el manifiesto de la aplicación y agréguele la defaultGroupCapability propiedad.

  2. Establezca un valor de team, groupchato meetings.

  3. Para la funcionalidad de grupo seleccionada, las funcionalidades de grupo disponibles son, bot, tabo connector.

    Nota:

    Solo puede seleccionar una funcionalidad predeterminada, bot, tabo connector para la funcionalidad de grupo seleccionada.

    "defaultGroupCapability": {
    "team": "bot",
    "groupchat": "bot",
    "meetings": "tab"
}

Configuración de la funcionalidad de aterrizaje predeterminada de la aplicación

Puede configurar la funcionalidad de aterrizaje predeterminada para una aplicación que admita funcionalidades de bot y pestaña en el ámbito personal. En función de esta configuración, la aplicación se abre como un bot o una pestaña de forma predeterminada.

Puede configurar cualquiera de las siguientes opciones:

Bot como funcionalidad de aterrizaje predeterminada

Configure la aplicación para que se abra como bot de forma predeterminada:

  1. Abra el manifiesto de la aplicación.

  2. En bots la propiedad , defina scopes como personal.

    "bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

Nota:

Bot actúa como la funcionalidad de aterrizaje predeterminada si su ámbito se define como personal, incluso si no se especifica entityId como conversations en staticTabs la propiedad .

En el ejemplo siguiente se muestra cómo abrir una aplicación con bot como funcionalidad de aterrizaje predeterminada y cómo un usuario puede realizar la transición a una pestaña:

El gráfico muestra el proceso de apertura de una aplicación con bot como funcionalidad de aterrizaje predeterminada.

Pestaña como funcionalidad de aterrizaje predeterminada

Configure la aplicación para que se abra como una pestaña de forma predeterminada:

  1. Abra el manifiesto de la aplicación.
  2. En la staticTabs propiedad :
    1. Agregue las propiedades de la pestaña como la primera entrada de la matriz. Para definir propiedades de pestaña, consulte manifiesto de aplicación.
    2. Agregue las siguientes propiedades:
      1. Defina entityId como conversations.
      2. Defina scopes como personal.

El siguiente fragmento de código es un ejemplo para establecer la pestaña como la funcionalidad de aterrizaje predeterminada:

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

En el ejemplo siguiente se muestra cómo abrir una aplicación con la pestaña como funcionalidad de aterrizaje predeterminada y cómo un usuario puede realizar la transición a un bot:

El gráfico muestra el proceso de abrir una aplicación con la pestaña como funcionalidad de aterrizaje predeterminada.

La staticTabs propiedad también se usa para anclar pestañas personales y reordenar pestañas. Para obtener más información, vea manifiesto de aplicación.

Bloquear aplicaciones de forma predeterminada para los usuarios hasta que un administrador lo apruebe

Para mejorar la experiencia del usuario de una aplicación de Teams, en ocasiones, los administradores de TI deben intervenir antes de que los usuarios usen la aplicación. Por ejemplo, considere la posibilidad de usar una aplicación de soporte técnico creada por Contoso Electronics para Teams. Para asegurarse de que la aplicación funciona correctamente, Contoso Electronics quiere que los clientes configuren primero propiedades específicas de la aplicación.

Para asegurarse de que los administradores de TI realizan las tareas pertinentes, los desarrolladores pueden bloquear una aplicación para los usuarios hasta que un administrador permita la aplicación. Para bloquear la aplicación de forma predeterminada, establezca la defaultBlockUntilAdminAction propiedad true en en el archivo de manifiesto de la aplicación. Cuando la propiedad se establece en true, el estado de la aplicación en el Centro de administración de Teams es Bloqueado por el publicador en la página Administrar aplicaciones .

Captura de pantalla que muestra una aplicación bloqueada por el publicador.

Los administradores pueden realizar su debida diligencia sobre la aplicación y pueden leer la documentación de la aplicación que proporcione antes de permitir que sus usuarios usen la aplicación. Por ejemplo, los administradores pueden comprar las licencias necesarias y distribuirlas antes de permitir que los usuarios usen la aplicación. Para permitir la aplicación con el estado Bloqueado por publicador , un administrador puede seleccionar Permitir en la página Administrar aplicaciones del Centro de administración de Teams.

Captura de pantalla que muestra la opción Permitir para la aplicación bloqueada por el publicador.

Si no quieres que la aplicación se bloquee de forma predeterminada, actualiza la configuración a false y envía la defaultBlockUntilAdminAction aplicación actualizada para su publicación. Después de publicar la nueva versión de la aplicación, se permite de forma predeterminada.

Nota:

En el caso de las aplicaciones personalizadas creadas para su organización, defaultBlockUntilAdminAction no se admite. Si carga una aplicación personalizada creada para su organización con esta propiedad, la aplicación no se bloqueará.

Ejemplo de código

Ejemplo de nombre Descripción .NET Node.js Manifiesto
Hello mundo En este ejemplo se muestra cómo configurar la funcionalidad de aterrizaje predeterminada para una aplicación que admite funcionalidades de bot y pestaña en el ámbito personal. View View View

Paso siguiente

Crear el paquete de aplicación