Ampliar una extensión de mensajería de Teams en Microsoft 365

Las extensiones de mensaje permiten a los usuarios interactuar con el servicio web mediante botones y formularios. Los usuarios pueden buscar o iniciar acciones en un sistema externo desde Microsoft Teams y Outlook ampliando las aplicaciones de Teams en Microsoft 365. Hay dos tipos de extensiones de mensaje:

• Extensiones de mensajes basadas en búsqueda: permite a los usuarios buscar en un sistema externo y compartir resultados a través del área de redacción del mensaje del cliente.

• Extensiones de mensajes basadas en acciones: permitir que los usuarios con un elemento emergente modal recopilen o muestren información, procesen la interacción y envíen la información al cliente como una tarjeta enriquecida.

Nota:

Las extensiones de mensajes basadas en búsqueda de Teams están disponibles con carácter general para Outlook y las extensiones de mensaje basadas en acciones están disponibles en versión preliminar para Outlook.

Los usuarios móviles de Outlook en Android e iOS pueden recibir y realizar acciones en las tarjetas de las aplicaciones que les enviaron los usuarios en Outlook en la Web y Outlook para Windows.

La extensión de mensajes de Teams en Microsoft 365 también admite la desplegamiento de vínculos que muestran tarjetas para iniciar stageview y diálogos.

Requisitos previos

Para ampliar la extensión de mensaje de Teams a Outlook, asegúrese de lo siguiente:

• Busque compatibilidad con extensiones de mensaje en Outlook para escritorio, web y móvil de Windows; consulte la tabla de soporte técnico en Extensión de aplicaciones de Teams en Microsoft 365.
• Una cuenta empresarial de espacio aislado del Programa de desarrolladores de Microsoft 365 Para la extensión de mensajes basada en acciones, inscriba el inquilino del desarrollador para las versiones dirigidas de Microsoft 365.
• Un entorno de prueba con aplicaciones de Microsoft 365 instaladas desde el canal actual de Aplicaciones Microsoft 365.
• Código de Microsoft Visual Studio con la extensión del Kit de herramientas de Teams (opcional)

Compilación o extensión de una extensión de mensaje

Para ampliar la extensión de mensaje de Teams a Outlook, puede crear una nueva aplicación de extensión de mensajes con Teams Toolkit o ampliar una aplicación de extensión de mensajes de Teams existente a Outlook.

Compilación de una aplicación de extensión de mensaje para Outlook

Puede crear una aplicación de extensión de mensajes de Teams para Outlook a través de la extensión kit de herramientas de Teams para Visual Studio Code. Para compilar una aplicación de extensión de mensaje para Outlook, asegúrese de lo siguiente:

• Cargar la aplicación en Microsoft Teams
• Obtener una vista previa de la extensión de mensajería en Outlook

Puede crear una extensión de mensaje basada en búsquedas o basada en acciones.

Extensión de mensaje basada en búsqueda

1. Abra Visual Studio Code.

2. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

3. Seleccione Teams: Create a New App (Equipos: Crear una nueva aplicación).

4. Seleccione Extensión de mensaje en la lista desplegable.

5. Seleccione Resultados de búsqueda personalizados para descargar el código de ejemplo de una extensión de mensaje basada en búsqueda de Teams mediante el manifiesto de aplicación más reciente (anteriormente denominado manifiesto de aplicación de Teams).

   

   También puede descargar el código de ejemplo del panel izquierdo, en DESARROLLO, seleccione Ver ejemplos. Aparece una pestaña Ejemplos , en el campo de búsqueda, escriba NPM Search Connector.

   

6. Seleccione un lenguaje de programación preferido.

7. Seleccione una ubicación en la máquina local para la carpeta del área de trabajo y escriba el nombre de la aplicación.

8. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

9. Escriba Teams: Aprovisionar para crear los recursos de aplicación pertinentes, como Azure App Service, App Service plan, Azure Bot e Identidad administrada, en su cuenta de Azure.

10. Seleccione una suscripción y un grupo de recursos.

11. Seleccione Aprovisionar. Como alternativa, puede seleccionar Aprovisionar en la sección CICLO DE VIDA de la extensión.

12. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

13. Escriba Teams: Deploy (Equipos: Implementación ) para implementar el código de ejemplo en los recursos aprovisionados en Azure e iniciar la aplicación. Como alternativa, puede seleccionar Implementar en la sección CICLO DE VIDA de la extensión.

14. Seleccione Implementar.

Extensión de mensaje basada en acciones

1. Abra Visual Studio Code.

2. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

3. Seleccione Teams: Create a New App (Equipos: Crear una nueva aplicación).

4. Seleccione Extensión de mensaje en la lista desplegable.

5. Seleccione Recopilar datos de entrada y proceso de formulario para descargar el código de ejemplo de una extensión de mensaje basada en acciones de Teams mediante el manifiesto de aplicación más reciente (anteriormente denominado manifiesto de aplicación de Teams).

   

6. Seleccione el lenguaje de programación preferido.

7. Seleccione una ubicación en la máquina local para la carpeta del área de trabajo y escriba el nombre de la aplicación.

8. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

9. Escriba Teams: Aprovisionar para crear los recursos de aplicación pertinentes, como Azure App Service, App Service plan, Azure Bot e Identidad administrada, en su cuenta de Azure.

10. Seleccione una suscripción y un grupo de recursos.

11. Seleccione Aprovisionar. Como alternativa, puede seleccionar Aprovisionar en la sección CICLO DE VIDA de la extensión.

12. Seleccione Paleta de comandos... en la opción Ver o Ctrl+Mayús+P.

13. Escriba Teams: Deploy (Equipos: Implementación ) para implementar el código de ejemplo en los recursos aprovisionados en Azure e iniciar la aplicación. Como alternativa, puede seleccionar Implementar en la sección CICLO DE VIDA de la extensión.

14. Seleccione Implementar.

Ahora, puede cargar la aplicación en Teams y obtener una vista previa de la extensión de mensaje en Outlook. Para compilar el paquete de aplicaciones a través del kit de herramientas de Teams, consulte Compilación de un paquete de aplicaciones.

Extensión de una aplicación de extensión de mensajes de Teams existente a Outlook

Para ampliar la aplicación de extensión de mensajes de Teams existente a Outlook, asegúrese de lo siguiente:

• Actualice el manifiesto de la aplicación.
• Agregue el canal de Microsoft 365 para la aplicación.
• Actualice Microsoft Entra registro de aplicaciones para el inicio de sesión único.
• Cargue la aplicación actualizada en Teams.
• Obtener una vista previa de la extensión de mensajería en Outlook

Actualizar el manifiesto de la aplicación

Actualice la versión 1.13 del esquema del manifiesto de aplicación (anteriormente denominado manifiesto de aplicación de Teams) o posterior para permitir que la extensión de mensaje de Teams se ejecute en Outlook.

Abra el $schema manifiesto de la aplicación y actualice y manifestVersion con los siguientes valores:

{
"$schema" : "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
"manifestVersion" : "1.16"
}

Puede usar Teams Toolkit para validar el manifiesto de la aplicación e identificar los errores.

Especificar los requisitos de tiempo de ejecución del host (versión preliminar del desarrollador)

Para asegurarse de que la aplicación siempre proporciona a los clientes experiencias de alta calidad, puede adaptar el comportamiento de la aplicación en los hosts de Microsoft 365 aplicables o omitirla de la navegación en contextos que no está listo para admitir. Use el manifiesto de aplicación para especificar las relaciones de dependencia entre las funcionalidades de la aplicación y los requisitos de tiempo de ejecución específicos de las pestañas estáticas, las extensiones de mensaje y los bots.

Para obtener más información, consulte cómo especificar los requisitos de tiempo de ejecución de host de Microsoft 365 en el manifiesto de la aplicación.

Agregar un canal de Microsoft 365 para la aplicación

En Microsoft Teams, una extensión de mensajería consta de un servicio web que usted hospeda y un manifiesto de aplicación, que define dónde se hospeda el servicio web. El servicio web aprovecha el esquema de mensajería del SDK de Bot Framework y el protocolo de comunicación seguro a través de un canal de Teams registrado para el bot.

Para que los usuarios interactúen con la extensión de mensaje desde Outlook, debe habilitar el canal de Microsoft 365 para el recurso de bot de Azure de la aplicación de extensión de mensajes.

Nota:

Si previamente ha habilitado el canal de Outlook para el bot, deberá habilitar el canal de Microsoft 365 para que la extensión de mensaje funcione correctamente en Microsoft Outlook. El canal de Outlook ya no se usa para las extensiones de mensaje que se ejecutan en Outlook y se puede deshabilitar.

1. Vaya al portal de Microsoft Azure Portal o Bot Framework (si se ha registrado anteriormente allí), vaya al recurso del bot.

2. Desde Canales de configuración>.

3. En Canales disponibles, seleccione Canal de Microsoft 365 .

   

4. Seleccione Aplicar.

   

5. Confirme que el canal de Microsoft 365 aparece junto con Microsoft Teams en el panel Canales del bot.

Actualización del registro de aplicaciones de Microsoft Entra para sso

Nota:

Puede omitir este paso si va a crear una aplicación para Outlook mediante Teams Toolkit, ya que el escenario no implica Microsoft Entra autenticación de inicio de sesión único.

Microsoft Entra inicio de sesión único (SSO) para las extensiones de mensaje funciona de la misma manera en Outlook que en Teams. Sin embargo, debe agregar varios identificadores de aplicación cliente al registro de aplicaciones Microsoft Entra del bot en el portal de Registros de aplicaciones del inquilino.

1. Inicie sesión en Azure Portal con su cuenta empresarial de espacio aislado.

2. Seleccione Registros de aplicaciones.

3. Seleccione el nombre de la aplicación para abrir el registro de la aplicación.

4. Seleccione Administrar Exponer>una API.

5. En la sección Aplicaciones cliente autorizadas , asegúrese de que aparecen todos los valores siguientes Client Id :

   Microsoft 365 aplicación cliente	Id. de cliente
   Escritorio y móvil de Teams	1fec8e78-bli4-4aaf-ab1b-5451cc387264
   Web de Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
   Web de Microsoft 365	4765445b-32c6-49b0-83e6-1d93765276ca
   Escritorio de Microsoft 365	0ec893e0-5785-4de6-99da-4ed124e5296c
   Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Versión de escritorio de Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c
   Outlook Web Access	bc59ab01-8403-45c6-8796-ac3ef710b3e3
   Outlook para dispositivos móviles	27922004-5251-4030-b22d-91ecd9a37ea4

Carga de la aplicación personalizada en Teams

Cargue la extensión de mensaje actualizada (paquete de aplicación) en Teams. Una vez completado, la extensión de mensaje aparece en las aplicaciones instaladas desde el área de redacción del mensaje.

1. Cree un archivo .zip con iconos de aplicación y manifiesto de aplicación.

2. Vaya a Microsoft Teams e inicie sesión con su cuenta de inquilino de espacio aislado.

3. Seleccione Aplicaciones>Administrar las aplicaciones>Cargar una aplicación.

   

4. Seleccione la opción Cargar una aplicación personalizada , seleccione el archivo .zip e instálelo (Agregar) en el cliente de Teams.

   

Después de cargarlo a través de Teams, la extensión de mensaje está disponible en Outlook para escritorio y web de Windows.

Obtener una vista previa de la extensión de mensajería en Outlook

A continuación se muestra cómo probar la extensión de mensaje que se ejecuta en Outlook en la Web. Para obtener una vista previa de la aplicación que se ejecuta en Outlook en la Web, siga estos pasos:

1. Inicie sesión en outlook.com con las credenciales del inquilino de prueba.

2. Seleccione Nuevo mensaje.

3. Seleccione Aplicaciones en la cinta de opciones.

   

Se mostrará la extensión de mensajería. Puede invocarla desde allí y usarla como lo haría al redactar un mensaje en Teams.

Depuración

A medida que depura la extensión de mensaje, puede identificar el origen (que se origina en Teams frente a Outlook) de las solicitudes de bot por el campo channelId del objeto Activity . Cuando un usuario realiza una consulta, el servicio recibe un objeto Bot Framework Activity estándar. Una de las propiedades del objeto Activity es channelId, que tiene el valor de msteams o m365extensions, en función de dónde se origine la solicitud del bot. Para obtener más información, consulte SDK de extensiones de mensaje basadas en búsquedas y SDK de extensiones de mensajería basadas en acciones.

Limitaciones

Aunque la extensión de mensaje actualizada continúa ejecutándose en Teams, debe tener en cuenta las siguientes limitaciones:

• Las extensiones de mensaje en Outlook solo se admiten en el compose contexto. En el manifiesto de aplicación de Teams, los contextos de extensión de mensaje como commandBox y message no se admiten en Outlook.

• Las extensiones de mensaje basadas en acciones que envían tarjetas al cuadro de redacción se admiten en Outlook. Sin embargo, no se admite el uso de bots para entregar tarjetas . En este escenario, puede convertir la extensión de mensaje para enviar tarjetas al cuadro de redacción de Outlook.

• No puede insertar más de cinco tarjetas adaptables en un correo electrónico.

• No se admiten las acciones de tarjeta de tipo messageBack, imBack, invokey signin . openURL es la única acción de tarjeta admitida.

• Se admiten acciones de tarjeta adaptable. Action.Submit Solo se admite el inicio de stageview y taskmodule.

Nota:

Al probar una aplicación con el vínculo desplegándose, asegúrese de quitarla manualmente después de las pruebas. Si varias aplicaciones supervisan el mismo dominio, es posible que la aplicación instalada más recientemente no se invoque para desenfoque el vínculo en Outlook, como lo haría en Teams.

Use los canales de la comunidad de desarrolladores de Microsoft Teams para notificar problemas y enviar comentarios.

Ejemplo de código

Nombre de ejemplo	Descripción	Node.js
Conector de búsqueda NPM	Aplicación de ejemplo del kit de herramientas de Teams para compilar una aplicación de extensión de mensaje. Funciona en Teams y Outlook.	View
Desplegamiento de vínculos de Teams	Aplicación sencilla de Teams para mostrar la desplegamiento de vínculos. Funciona en Teams, Outlook.	View
Pestaña en vista previa	Aplicación de ejemplo de pestaña de Microsoft Teams para mostrar una pestaña en Stageview. Funciona en la aplicación Teams, Outlook y Microsoft 365.	View
Extensión de mensaje basada en acciones de Teams para Microsoft 365	Aplicación de ejemplo del kit de herramientas de Teams para compilar una aplicación de extensión de mensaje. Funciona en Teams y Outlook.	View

Paso siguiente

Publicación de aplicaciones de Teams para Outlook y aplicaciones de Microsoft 365