Manifiesto de la aplicación

El manifiesto de aplicación (anteriormente denominado manifiesto de aplicación de Teams) describe cómo se integra la aplicación en el producto de Microsoft Teams. El manifiesto de la aplicación debe ajustarse al esquema hospedado en https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json. Se admiten las versiones anteriores 1.0, 1.1,...,1.17 y la versión actual es 1.19 (con "v1.x" en la dirección URL). La versión 1.18 no está disponible. Para obtener más información sobre los cambios realizados en cada versión, consulte Registro de cambios de manifiesto de aplicación y para versiones anteriores, consulte Versiones de manifiesto de aplicación.

En la tabla siguiente se enumeran las versiones de manifiesto de aplicación y versión de TeamsJS según diferentes escenarios de aplicación:

* Use la versión más reciente de TeamsJS (v.2.19.0 o posterior) siempre que sea posible, para aprovechar las mejoras más recientes y la compatibilidad con nuevas características, incluidas las aplicaciones solo de Teams. TeamsJS v.1.12 sigue siendo compatible, pero no se agregan nuevas características ni mejoras. De lo contrario, los esquemas 1.12 y 1.13 son los mismos. Para obtener más información, consulte Biblioteca teamsJS.

A continuación se muestra el esquema de manifiesto de aplicación de ejemplo:

Manifiesto de aplicación de ejemplo

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json",
    "manifestVersion": "1.19",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "localizationInfo": {
        "defaultLanguageTag": "en",
        "defaultLanguageFile": "en.json",
        "additionalLanguages": [
            {
                "languageTag": "es",
                "file": "es.json"
            }
        ]
    },
    "developer": {
        "name": "Publisher Name",
        "websiteUrl": "https://example.com/",
        "privacyUrl": "https://example.com/privacy",
        "termsOfUseUrl": "https://example.com/app-tos",
        "mpnId": "1234567890"
    },
    "name": {
        "short": "Name of your app (<=30 chars)",
        "full": "Full name of app, if longer than 30 characters (<=100 chars)"
    },
    "description": {
        "short": "Short description of your app (<= 80 chars)",
        "full": "Full description of your app (<= 4000 chars)"
    },
    "icons": {
        "outline": "A relative path to a transparent .png icon — 32px X 32px",
        "color": "A relative path to a full color .png icon — 192px X 192px"
    },
    "accentColor": "A valid HTML color code.",
    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },
    "configurableTabs": [
        {
            "configurationUrl": "https://contoso.com/teamstab/configure",
            "scopes": [
                "team",
                "groupChat"
            ],
            "canUpdateConfiguration": true,
            "context": [
                "channelTab",
                "privateChatTab",
                "meetingChatTab",
                "meetingDetailsTab",
                "meetingSidePanel",
                "meetingStage"
            ],
            "sharePointPreviewImage": "Relative path to a tab preview image for use in SharePoint — 1024px X 768",
            "supportedSharePointHosts": [
                "sharePointFullPage",
                "sharePointWebPart"
            ]
        }
    ],
    "staticTabs": [
        {
            "entityId": "unique Id for the page entity",
            "scopes": [
                "personal"
            ],
            "context": [
                "personalTab",
                "channelTab"
            ],
            "name": "Display name of tab",
            "contentUrl": "https://contoso.com/content (displayed in Teams canvas)",
            "websiteUrl": "https://contoso.com/content (displayed in web browser)",
            "searchUrl": "https://contoso.com/content (displayed in web browser)"
        }
    ],
    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ],
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "scopes": [
                "team",
                "personal",
                "groupChat"
            ],
            "needsChannelSelector": false,
            "isNotificationOnly": false,
            "supportsFiles": true,
            "supportsCalling": false,
            "supportsVideo": true,
            "commandLists": [
                {
                    "scopes": [
                        "team",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Command 1",
                            "description": "Description of Command 1"
                        },
                        {
                            "title": "Command 2",
                            "description": "Description of Command 2"
                        }
                    ]
                },
                {
                    "scopes": [
                        "personal",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Personal command 1",
                            "description": "Description of Personal command 1"
                        },
                        {
                            "title": "Personal command N",
                            "description": "Description of Personal command N"
                        }
                    ]
                }
            ]
        }
    ],
    "connectors": [
        {
            "connectorId": "GUID-FROM-CONNECTOR-DEV-PORTAL%",
            "scopes": [
                "team"
            ],
            "configurationUrl": "https://contoso.com/teamsconnector/configure"
        }
    ],
    "composeExtensions": [
        {
            "canUpdateConfiguration": true,
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "commands": [
                {
                    "id": "exampleCmd1",
                    "title": "Example Command",
                    "type": "query",
                    "context": [
                        "compose",
                        "commandBox"
                    ],
                    "description": "Command Description; e.g., Search on the web",
                    "initialRun": true,
                    "fetchTask": false,
                    "parameters": [
                        {
                            "name": "keyword",
                            "title": "Search keywords",
                            "inputType": "choiceset",
                            "description": "Enter the keywords to search for",
                            "value": "Initial value for the parameter",
                            "choices": [
                                {
                                    "title": "Title of the choice",
                                    "value": "Value of the choice"
                                }
                            ]
                        }
                    ]
                },
                {
                    "id": "exampleCmd2",
                    "title": "Example Command 2",
                    "type": "action",
                    "context": [
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "initialRun": true,
                    "fetchTask": false ,
                    "parameters": [
                        {
                            "name": "custinfo",
                            "title": "Customer name",
                            "description": "Enter a customer name",
                            "inputType": "text"
                        }
                    ]
                },
                {
                    "id": "exampleCmd3",
                    "title": "Example Command 3",
                    "type": "action",
                    "context": [
                        "compose",
                        "commandBox",
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "fetchTask": false,
                    "taskInfo": {
                        "title": "Initial dialog title",
                        "width": "Dialog width",
                        "height": "Dialog height",
                        "url": "Initial webview URL"
                    }
                }
            ],
            "messageHandlers": [
                {
                    "type": "link",
                    "value": {
                        "domains": [
                            "mysite.someplace.com",
                            "othersite.someplace.com"
                        ],
                        "supportsAnonymizedPayloads": false
                    }
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "devicePermissions": [
        "geolocation",
        "media",
        "notifications",
        "midi",
        "openExternal"
    ],
    "validDomains": [
        "contoso.com",
        "mysite.someplace.com",
        "othersite.someplace.com"
    ],
    "webApplicationInfo": {
        "id": "AAD App ID",
        "resource": "Resource URL for acquiring auth token for SSO"
    },
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "type": "Application",
                    "name": "ChannelSettings.Read.Group"
                },
                {
                    "type": "Delegated",
                    "name": "ChannelMeetingParticipant.Read.Group"
                }
            ]
        }
    },
    "showLoadingIndicator": false,
    "isFullScreen": false,
    "activities": {
        "activityTypes": [
            {
                "type": "taskCreated",
                "description": "Task created activity",
                "templateText": "<team member> created task <taskId> for you"
            },
            {
                "type": "userMention",
                "description": "Personal mention activity",
                "templateText": "<team member> mentioned you"
            }
        ]
    },
    "defaultBlockUntilAdminAction": true,
    "publisherDocsUrl": "https://example.com/app-info",
    "defaultInstallScope": "meetings",
    "defaultGroupCapability": {
        "meetings": "tab",
        "team": "bot",
        "groupchat": "bot"
    },
    "configurableProperties": [
        "name",
        "shortDescription",
        "longDescription",
        "smallImageUrl",
        "largeImageUrl",
        "accentColor",
        "developerUrl",
        "privacyUrl",
        "termsOfUseUrl"
    ],
    "subscriptionOffer": {
        "offerId": "publisherId.offerId"
    },
    "meetingExtensionDefinition": {
        "scenes": [
            {
                "id": "9082c811-7e6a-4174-8173-6ccd57d377e6",
                "name": "Getting started sample",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 0
            },
            {
                "id": "afeaed22-f89b-48e1-98b4-46a514344e4a",
                "name": "Sample-1",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 3
            }
        ]
    }
}

El esquema define las siguientes propiedades:

$schema

Opcional, pero recomendado: cadena

Dirección URL de https:// que hace referencia al esquema JSON para el manifiesto de la aplicación.

manifestVersion

Obligatorio : cadena

Versión del esquema de manifiesto de aplicación que usa este manifiesto. Use 1.13 para habilitar la compatibilidad con aplicaciones de Teams en outlook y aplicaciones de Microsoft 365; use 1.12 (o versiones anteriores) para aplicaciones solo de Teams.

version

Obligatorio : cadena

La versión de una aplicación específica. Al actualizar algo en el manifiesto de la aplicación, la versión también debe incrementarse. De este modo, cuando se instala el nuevo manifiesto de aplicación, sobrescribe el existente y el usuario recibe la nueva funcionalidad. Cuando esta aplicación se envió a microsoft Teams Store, el nuevo manifiesto de aplicación debe volver a enviarse y volver a validarse. Los usuarios de la aplicación reciben automáticamente el nuevo manifiesto de aplicación actualizado en pocas horas después de que se apruebe el manifiesto de la aplicación.

Si la aplicación solicita un cambio de permisos de acceso, se pide a los usuarios que actualicen y vuelvan a dar los permisos a la aplicación.

La versión de esta cadena debe seguir el estándar de SemVer (MAJOR.MINOR.PATCH).

Id.

Obligatorio : identificador de aplicación de Microsoft

El id. es un identificador único generado por Microsoft para la aplicación. El formato del identificador es GUID. Usted tiene un id. si su bot está registrado a través de Microsoft Bot Framework. Usted tiene un id. si la aplicación web de la pestaña ya inicia sesión con Microsoft. Debe escribir el identificador aquí. De lo contrario, debe generar un nuevo id. en el portal de registro de aplicación de Microsoft. Use el mismo id. si agrega un bot.

El identificador almacenado en el Centro de Administración de Teams es el identificador de aplicación externa y es visible como ExternalID en los seguimientos.

developer

Requerido : objeto

Especifica información sobre su empresa. En el caso de las aplicaciones enviadas a la Tienda Teams, estos valores deben coincidir con la información de la descripción de la Tienda Teams. Para obtener más información, consulte las directrices de publicación de la Tienda Teams. El nombre del desarrollador ayuda a mejorar la detectabilidad de la aplicación en la Tienda Teams.

name

Requerido : objeto

El nombre de la experiencia de la aplicación, que se muestra a los usuarios en la experiencia de Teams. Para las aplicaciones enviadas a AppSource, estos valores deben coincidir con la información de la entrada de AppSource. Los valores de short y full deben ser diferentes. El nombre de la aplicación ayuda a mejorar la detectabilidad de la aplicación en la Tienda Teams.

description

Requerido : objeto

Describe la aplicación a los usuarios. Para las aplicaciones enviadas a AppSource, estos valores deben coincidir con la información de la entrada de AppSource. La descripción de la aplicación ayuda a mejorar la detectabilidad de la aplicación en la Tienda Teams.

Asegúrese de que la descripción describe su experiencia y ayuda a los clientes potenciales a comprender lo que hace su experiencia. Debe anotar en la descripción completa si se requiere una cuenta externa para su uso. Los valores de short y full deben ser diferentes. La descripción breve no se puede repetir dentro de la descripción larga y no debe incluir ningún otro nombre de aplicación.

localizationInfo

Opcional : objeto

Permite la especificación de un idioma predeterminado y punteros a archivos de idioma adicionales. Consulte localización.

localizationInfo.additionalLanguages

Matriz de objetos, cada uno con las siguientes propiedades para especificar traducciones de idioma adicionales.

iconos

Requerido : objeto

Iconos usados en la aplicación Teams. Los archivos de icono deben incluirse como parte del paquete de carga. Para obtener más información, consulte Iconos.

accentColor

Requerido : código de color hexadecimal HTML

Color que se va a usar y como fondo para los iconos de color.

El valor debe ser un código de color HTML válido que empiece por "#", como por ejemplo #4464ee. Para obtener más información, vea accentColor.

copilotAgents

Opcional : objeto

Define uno o varios agentes para Microsoft 365 Copilot. Los agentes declarativos son personalizaciones de Microsoft 365 Copilot que se ejecutan en sus mismos modelos de orquestador y base.

declarativeAgents

Representa una personalización de Microsoft 365 Copilot, tal como se define en su archivo de manifiesto.

configurableTabs

Opcional : matriz

Se usa cuando la experiencia de la aplicación tiene una experiencia de pestaña de canal de equipo que requiere una configuración adicional antes de agregarla. Las pestañas configurables solo se admiten en los ámbitos team y groupChat y se pueden configurar las mismas pestañas varias veces. Sin embargo, solo puede definirlo en el manifiesto de la aplicación una vez.

staticTabs

Opcional : matriz

Define un conjunto de pestañas que se pueden anclar de forma predeterminada, sin que el usuario las agregue manualmente. Las pestañas estáticas declaradas en el ámbito personal siempre se anclan a la experiencia personal de la aplicación.

Este elemento es una matriz (con un máximo de 16 elementos) y todos los elementos de tipo object. Este bloque solo es necesario para las soluciones que proporcionan una solución de pestaña estática.

bots

Opcional : matriz

Define una solución de bot, junto con información opcional, como las propiedades de comando predeterminadas.

El elemento es una matriz (máximo de un solo elemento, solo se permite un bot por aplicación) con todos los elementos del tipo object. Este bloque solo es necesario para las soluciones que proporcionan una experiencia de bot.

bots.configuration

Opcional : objeto

bots.commandLists

Opcional : matriz

Lista de comandos que el bot puede recomendar a los usuarios. El objeto es una matriz (máximo de tres elementos) con todos los elementos de tipo object; debe definir una lista de comandos independiente para cada ámbito que admita el bot. Para obtener más información, consulte Menús de bot.

bots.commandLists.commands

Requerido : matriz

conectores

Opcional : matriz

El connectors bloque define una tarjeta de conector para Grupos de Microsoft 365 para la aplicación.

El objeto es una matriz (con un máximo de un elemento) y todos los elementos de tipo object. Este bloque solo es necesario para las soluciones que proporcionan un conector.

composeExtensions

Opcional : matriz

Define una extensión de mensajería para la aplicación.

El elemento es una matriz (máximo de un elemento) con todos los elementos de tipo object. Este bloque solo es necesario para las soluciones que proporcionan una extensión de mensajería.

composeExtensions.commands

Su extensión de mensajería debe declarar uno o más comandos con un máximo de 10 comandos. Cada comando aparece en Microsoft Teams como una posible interacción desde el punto de entrada basado en la interfaz de usuario.

Cada elemento de comando es un objeto con la estructura siguiente:

permissions

Opcional : matriz de cadenas

Matriz de string, que especifica qué permisos solicita la aplicación, lo que permite a los usuarios finales saber cómo funciona la extensión. Las siguientes opciones no son exclusivas:

• identity Requiere información de identidad de usuario.
• messageTeamMembers Requiere permiso para enviar mensajes directos a los miembros del equipo.

Al cambiar estos permisos durante la actualización de la aplicación, los usuarios repiten el proceso de consentimiento después de ejecutar la aplicación actualizada. Para obtener más información, consulte Actualizar la aplicación.

devicePermissions

Opcional : matriz de cadenas

Proporciona las características nativas en el dispositivo de un usuario al que la aplicación solicita acceso. Las opciones son:

• geolocation
• media
• notifications
• midi
• openExternal

validDomains

Opcional (excepto Obligatorio cuando se indica): matriz de cadenas

Una lista de dominios válidos para sitios web que la aplicación espera cargar en el cliente de Teams. Las listas de dominios pueden incluir caracteres comodín, por ejemplo *.example.com. El dominio válido coincide exactamente con un segmento del dominio; si necesita que coincida con a.b.example.com entonces use *.*.example.com. Si la configuración de pestañas o la interfaz de usuario de contenido navega a cualquier otro dominio que no sea la configuración de pestañas, ese dominio debe especificarse aquí.

No incluya los dominios de proveedores de identidades que desea admitir en la aplicación. Por ejemplo, para autenticarse mediante un identificador de Google, es necesario redirigir a accounts.google.com, pero no debe incluir accounts.google.com en validDomains[].

Las aplicaciones de Teams que requieren sus propias direcciones URL de SharePoint para funcionar bien, incluyen " {teamsitedomain}" en su lista de dominios válidos.

El objeto es una matriz con todos los elementos del tipo string. El elemento máximo del objeto es 16 y la longitud máxima es de 2048 caracteres.

WebApplicationInfo

Opcional : objeto

Proporcione su Microsoft Entra id. de aplicación y la información de Microsoft Graph para ayudar a los usuarios a iniciar sesión sin problemas en la aplicación. Si la aplicación está registrada en Microsoft Entra ID, debe proporcionar el identificador de aplicación. Los administradores pueden revisar fácilmente los permisos y conceder consentimiento en el Centro de administración de Teams.

graphConnector

Opcional : objeto

Especifique la configuración del conector de Graph de la aplicación. Si está presente, también debe especificarse webApplicationInfo.id .

showLoadingIndicator

Opcional : booleano

Indica si se va a mostrar o no el indicador de carga cuando se carga una aplicación o pestaña. El valor predeterminado es false.

IsFullScreen

Opcional : booleano

Indica si una aplicación personal se representa sin una barra de encabezado de pestaña (lo que significa el modo de pantalla completa). Valor predeterminado: false

activities

Opcional : objeto

Defina las propiedades que usa la aplicación para publicar una fuente de actividades del usuario.

activities.activityTypes

{
   "activities":{
      "activityTypes":[
         {
            "type":"taskCreated",
            "description":"Task Created Activity",
            "templateText":"{actor} created task {taskId} for you"
         },
         {
            "type":"teamMention",
            "description":"Team Mention Activity",
            "templateText":"{actor} mentioned team"
         },
         {
            "type":"channelMention",
            "description":"Channel Mention Activity",
            "templateText":"{actor} mentioned channel"
         },
         {
            "type":"userMention",
            "description":"Personal Mention Activity",
            "templateText":"{actor} mentioned user"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"creatorTaskCreated",
            "description":"Created Task Created",
            "templateText":"The Creator created task {taskId} for you"
         }
      ]
   }
}

defaultInstallScope

Opcional : cadena

Especifica el ámbito de instalación definido para esta aplicación de forma predeterminada. El ámbito definido es la opción que se muestra en el botón cuando un usuario intenta agregar la aplicación. Las opciones son:

• personal
• team
• groupChat
• meetings

defaultGroupCapability

Opcional : objeto

Cuando se selecciona un ámbito de instalación de grupo, define la funcionalidad predeterminada cuando el usuario instala la aplicación.

configurableProperties

Opcional : matriz

El bloque configurableProperties define las propiedades de la aplicación que los administradores de Teams pueden personalizar. Para más información, consulte Habilitar la personalización de aplicaciones. La característica de personalización de aplicaciones no se admite en aplicaciones personalizadas o aplicaciones personalizadas creadas para su organización (aplicaciones LOB).

Puede definir cualquiera de las siguientes propiedades:

• name: nombre para mostrar de la aplicación.
• shortDescription: descripción breve de la aplicación.
• longDescription: la descripción larga de la aplicación.
• smallImageUrl: icono de esquema de la aplicación.
• largeImageUrl: icono de color de la aplicación.
• accentColor: el color que se va a usar y un fondo para los iconos de esquema.
• developerUrl: dirección URL HTTPS del sitio web del desarrollador.
• privacyUrl: dirección URL HTTPS de la directiva de privacidad del desarrollador.
• termsOfUseUrl: dirección URL HTTPS de los términos de uso del desarrollador.

supportedChannelTypes

Opcional : matriz

Habilita la aplicación en canales no estándar. Si la aplicación admite un ámbito de equipo y se define esta propiedad, Teams habilita la aplicación en cada tipo de canal en consecuencia. La propiedad supportedChannelTypes solo admite sharedChannels y privateChannels.

defaultBlockUntilAdminAction

Opcional : booleano

Cuando la propiedad defaultBlockUntilAdminAction se establece en true, la aplicación se oculta a los usuarios de forma predeterminada hasta que el administrador la permita. Si se establece en true, la aplicación se oculta para todos los inquilinos y usuarios finales. Los administradores de inquilinos pueden ver la aplicación en el Centro de administración de Teams y tomar medidas para permitir o bloquear la aplicación. El valor predeterminado es False. Para obtener más información sobre el bloque de aplicaciones predeterminado, consulte Bloquear aplicaciones de forma predeterminada para los usuarios hasta que un administrador lo apruebe.

publisherDocsUrl

Opcional : cadena

Tamaño máximo : 2048 caracteres

El valor del publisherDocsUrl parámetro es una dirección URL HTTPS segura para la página de documentación e información de la aplicación que los desarrolladores de aplicaciones deciden proporcionar. Los administradores de inquilinos obtienen documentación sobre la aplicación en esta dirección URL. El Centro de administración de Teams muestra la dirección URL en la página de detalles de la aplicación. La documentación puede incluir las instrucciones para que los administradores faciliten la adopción de aplicaciones y el lanzamiento de aplicaciones. En la documentación de la aplicación, también puede incluir instrucciones o información sobre la aplicación que sea útil para el administrador de inquilinos, los usuarios y otras partes interesadas de la empresa.

subscriptionOffer

Opcional : objeto

Especifica la oferta de SaaS asociada a la aplicación.

meetingExtensionDefinition

Opcional : objeto

Especifique la definición de la extensión de reunión. Para obtener más información, vea escenas personalizadas del Modo conferencia en Teams

meetingExtensionDefinition.scenes

Autorización

Opcional : objeto

Especifique y consolide la información relacionada con la autorización de la aplicación.

authorization.permissions

authorization.permissions.resourceSpecific

Permisos de aplicación de RSC

Los permisos de aplicación permiten a la aplicación acceder a los datos sin que un usuario haya iniciado sesión. Para obtener información sobre los permisos de aplicación, consulte Permisos de RSC para Microsoft Graph y Microsoft BotSDK.

Permisos delegados de RSC

Los permisos delegados permiten a la aplicación acceder a los datos en nombre del usuario que ha iniciado sesión.

• Permisos delegados de RSC para un equipo

  Nombre	Descripción
  ChannelMeetingParticipant.Read.Group	Permite que la aplicación lea la información de los participantes, incluidos el nombre, rol, identificador, horas de unión y salida de las reuniones de canal asociadas a este equipo, en nombre del usuario que ha iniciado sesión.
  ChannelMeetingIncomingAudio.Detect.Group	Permite que la aplicación detecte el audio entrante en las reuniones de canal asociadas al equipo.
  ChannelMeetingActiveSpeaker.Read.Group	Permite que la aplicación lea a los participantes que envían audio a las reuniones del canal asociadas con el equipo.
  ChannelMeetingAudioVideo.Stream.Group	Permite que la aplicación transmita contenido de audio y vídeo desde las reuniones de canal asociadas al equipo.
  InAppPurchase.Allow.Group	Permite que la aplicación muestre las ofertas de Marketplace a los usuarios del equipo y complete sus compras dentro de la aplicación, en nombre del usuario que ha iniciado sesión.
  ChannelMeetingStage.Write.Group	Permite que la aplicación muestre contenido en la fase de reunión en las reuniones de canal asociadas al equipo, en nombre del usuario que ha iniciado sesión.
  LiveShareSession.ReadWrite.Group	Permite a la aplicación crear y sincronizar sesiones de Live Share para el equipo y obtener información relacionada con el acceso, como el nombre y el rol, sobre la lista del equipo y las reuniones asociadas en nombre del usuario que ha iniciado sesión.
  MeetingParticipantReaction.Read.Group	Permite a la aplicación leer las reacciones de los participantes en las reuniones de canal asociadas con el equipo.

• Permisos delegados de RSC para chats o reuniones

  Nombre	Descripción
  InAppPurchase.Allow.Chat	Permite a la aplicación mostrar las ofertas de Marketplace a los usuarios en el chat, y cualquier reunión asociada, y completar sus compras dentro de la aplicación, en nombre del usuario que ha iniciado sesión.
  MeetingStage.Write.Chat	Permite que la aplicación muestre contenido en la fase de reunión en las reuniones asociadas al chat, en nombre del usuario que ha iniciado sesión.
  OnlineMeetingParticipant.Read.Chat	Permite que la aplicación lea la información de los participantes, incluidos el nombre, el rol, el identificador, las horas unidas y las horas izquierdas, de la reunión asociada al chat, en nombre del usuario que ha iniciado sesión.
  OnlineMeetingParticipant.ToggleIncomingAudio.Chat	Permite a la aplicación alternar el audio entrante para los participantes en las reuniones asociadas al chat, en nombre del usuario que ha iniciado sesión.
  LiveShareSession.ReadWrite.Chat	Permite a la aplicación crear y sincronizar sesiones de Live Share para el chat y obtener información relacionada con el acceso, como el nombre y el rol, sobre la lista del chat y las reuniones asociadas en nombre del usuario que ha iniciado sesión.
  MeetingParticipantReaction.Read.Chat	Permite a la aplicación leer las reacciones de los participantes en las reuniones asociadas al chat.
  OnlineMeetingIncomingAudio.Detect.Chat	Permite que la aplicación detecte cambios en el estado del audio entrante en las reuniones asociadas al chat, en nombre del usuario que ha iniciado sesión.
  OnlineMeetingActiveSpeaker.Read.Chat	Permite que la aplicación lea a los participantes que envían audio a las reuniones asociadas al chat.
  OnlineMeetingAudioVideo.Stream.Chat	Permite que la aplicación transmita contenido de audio y vídeo de las reuniones asociadas al chat.

• Permisos delegados de RSC para los usuarios

  Nombre	Descripción
  CameraStream.Read.User	Permite que la aplicación lea la secuencia de cámara del usuario.
  InAppPurchase.Allow.User	Permite que la aplicación muestre las ofertas de Marketplace del usuario y complete las compras del usuario dentro de la aplicación, en nombre del usuario que ha iniciado sesión.
  OutgoingVideoStream.Write.User	Permite que la aplicación modifique el vídeo saliente del usuario.
  MicrophoneStream.Read.User	Permite que la aplicación lea el flujo de micrófono del usuario.
  MeetingParticipantReaction.Read.User	Permite que la aplicación lea las reacciones del usuario mientras participa en una reunión.

extensions

Opcional : objeto

La extensions propiedad especifica complementos de Outlook dentro de un manifiesto de aplicación y simplifica la distribución y adquisición en todo el ecosistema de Microsoft 365. Cada aplicación solo admite una extensión.

Para obtener más información, vea Manifiesto de complementos de Office para Microsoft 365.

extensions.requirements

El extensions.requirements objeto especifica los ámbitos, los factores de forma y los conjuntos de requisitos de la biblioteca javascript de Office que se deben admitir en el cliente de Office para que se instale el complemento. Los requisitos también se admiten en las propiedades secundarias "ribbon", "runtime", "alternates" y "autoRunEvents" para filtrar selectivamente algunas características del complemento. Para obtener más información, vea Especificar requisitos de complementos de Office en el manifiesto unificado para Microsoft 365.

extensions.runtimes

Opcional : matriz

La extensions.runtimes matriz configura los conjuntos de tiempos de ejecución y las acciones que puede usar cada punto de extensión.

Para usar extensions.runtimes, consulte creación de comandos de complemento,configuración del tiempo de ejecución para un panel de tareas y configuración del tiempo de ejecución para el comando de función.

extensions.ribbons

Opcional : matriz

La extensions.ribbons propiedad proporciona la capacidad de agregar comandos de complemento (botones y elementos de menú) a la cinta de opciones de la aplicación de Microsoft 365. La definición de la cinta de opciones se selecciona de la matriz en función de los requisitos y el primer orden.

Para usar extensions.ribbons, consulte creación de comandos de complemento, configuración de la interfaz de usuario para el comando del panel de tareas y configuración de la interfaz de usuario para el comando de función.

extensions.autoRunEvents

Opcional : matriz

La extensions.autoRunEvents propiedad define puntos de extensión de activación basados en eventos.

extensions.alternates

Opcional : matriz

La extensions.alternates propiedad se usa para ocultar o priorizar complementos específicos en el mercado cuando se han publicado varios complementos con funcionalidad superpuesta.

dashboardCards

Opcional : matriz

Define una lista de tarjetas que se pueden anclar a un panel, como Microsoft Viva Connections, para proporcionar una vista resumida de la información de la aplicación. Para más información sobre cómo crear tarjetas para Viva Connections panel, consulte Información general sobre las extensiones de tarjeta adaptable con tecnología de bot.

Este elemento es una matriz de dashboardCard elementos de tipo object.

dashboardCards.dashboardCard

Define una sola tarjeta de panel y sus propiedades.

dashboardCards.dashboardCard.icon

Define las propiedades de icono de una tarjeta de panel determinada.

dashboardCards.dashboardCard.contentSource

Define el origen de contenido de una tarjeta de panel determinada.

dashboardCards.dashboardCard.contentSource.botConfiguration

Creación de un archivo de manifiesto de aplicación

Si la aplicación no tiene un archivo de manifiesto de aplicación, debe crearlo.

Para crear un archivo de manifiesto de aplicación:

1. Use el esquema de manifiesto de aplicación de ejemplo para crear un archivo .json.
2. Guárdelo en la raíz de la carpeta del proyecto como manifest.json.

{ 
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json", 
"manifestVersion": "1.12", 
"version": "1.0.0", 
"id": "{new GUID for this Teams app - not the Microsoft Entra App ID}", 
"developer": { 
"name": "Microsoft", 
"websiteUrl": "https://www.microsoft.com", 
"privacyUrl": "https://www.microsoft.com/privacy", 
"termsOfUseUrl": "https://www.microsoft.com/termsofuse" 
}, 

"name": { 
  "short": "Teams Auth SSO", 
  "full": "Teams Auth SSO" 
}, 


"description": { 
  "short": "Teams Auth SSO app", 
  "full": "The Teams Auth SSO app" 
}, 

"icons": { 
  "outline": "outline.png", 
  "color": "color.png" 
}, 

"accentColor": "#60A18E", 
"staticTabs": [ 
  { 
   "entityId": "auth", 
   "name": "Auth", 
   "contentUrl": "https://subdomain.example.com/Home/Index", 
   "scopes": [ "personal" ] 
  } 
], 

"configurableTabs": [ 
  { 
   "configurationUrl": "https://subdomain.example.com/Home/Configure", 
   "canUpdateConfiguration": true, 
   "scopes": [ 
   "team" 
    ] 
  } 
], 
"permissions": [ "identity", "messageTeamMembers" ], 
"validDomains": [ 
 "{subdomain or ngrok url}" 
], 
"webApplicationInfo": { 
  "id": "{Microsoft Entra AppId}", 
  "resource": "api://subdomain.example.com/{Microsoft Entra AppId}" 
}
} 

Vea también

• Comprender la estructura de la aplicación de Microsoft Teams
• Habilitar la personalización de aplicaciones
• Localizar la aplicación
• Integrar capacidades multimedia
• Esquema de manifiesto de aplicación de versión preliminar para desarrolladores públicos