Configurar notificaciones de Microsoft Teams

Los paneles de IA/BI admiten el envío de instantáneas programadas a canales de Microsoft Teams. Esto permite a los equipos recibir actualizaciones del panel directamente en su área de trabajo de Teams. En esta página se explica cómo crear una aplicación de Microsoft Teams y configurar un canal de Teams como destino de notificación. A continuación, los editores de paneles de control pueden agregar este destino de notificación como suscriptor a los paneles de control programados. Para obtener información sobre cómo agregar un canal de Teams como suscriptor, consulte Suscribirse a un canal de Slack o Microsoft Teams.

Las suscripciones de Teams proporcionan instantáneas del tablero de control que incluyen:

• Una captura de imagen en formato PNG del panel visible directamente en el canal
• Vínculo directo para abrir el panel en Azure Databricks
• Instantáneas PDF adjuntas en el hilo de mensajes

Requisitos

Debe tener los permisos siguientes:

• Debe ser administrador del área de trabajo de Azure Databricks para configurar destinos de notificación.
• Debes tener los permisos adecuados para registrar aplicaciones y conceder el consentimiento de administrador en Microsoft Entra ID. También debes ser capaz de crear un recurso de Azure Bot en el Azure Portal, añadir una app de Teams y crear flujos de trabajo de Power Automate en Microsoft Teams.

Durante el proceso de instalación, recopilará credenciales de autenticación de Microsoft para configurar el destino de notificación de Azure Databricks.

Después de configurar el destino de la notificación, cualquier usuario con permisos CAN EDIT en un panel puede agregar el destino de Teams como suscriptor a las programaciones que administra.

Paso 1: Crear y configurar una aplicación de Microsoft Teams

Registra una app de Microsoft Entra ID, crea un bot de Azure asociado a esa app y añade una app de Teams para el bot a tu canal.

Registra una aplicación de Microsoft Entra ID

1. Vaya al Centro de administración de Microsoft Entra.
2. Haz clic en Aplicaciones > Registros de aplicaciones > Nueva inscripción.
3. Introduce un nombre en la app y haz clic en Registrar.
4. En la página Información general de la aplicación, copie el identificador de aplicación (cliente). Necesitas este valor para crear el bot de Azure y configurar el destino de notificaciones de Azure Databricks.

Configuración de permisos de aplicación en microsoft Entra ID

1. En el centro de administración de Centro de administración Microsoft Entra, con tu registro de app seleccionado, haz clic en permisos de la API en la barra lateral izquierda.
2. Haga clic en Agregar permisos.
3. En Las API de Microsoft, haga clic en Permisos de aplicación de Microsoft Graph>.
4. Agregue los permisos siguientes:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Haga clic en Agregar permisos.
6. Haga clic en Conceder consentimiento del administrador para conceder los permisos para su organización.

Creación de un secreto de autenticación

1. En el centro de administración de Centro de administración Microsoft Entra, con tu registro de aplicación seleccionado, haz clic en Certificados y secretos.
2. Haga clic en Secretos > de cliente Nuevo secreto de cliente.
3. Escriba una descripción y seleccione un período de expiración.
4. Haga clic en Agregar.
5. Copie el valor del secreto recién creado. Este valor solo se muestra una vez y lo necesita para configurar el destino de notificación de Azure Databricks.

Obtención del identificador de inquilino

1. En el Centro de administración de Microsoft Entra, con el registro de la aplicación seleccionado, vaya a Información general.
2. Copie el ID de directorio (tenant). Necesita este valor para configurar el destino de notificación de Azure Databricks.

Crea un bot de Azure para la app

Crea un recurso de Azure Bot que utilice la aplicación Microsoft Entra ID que has registrado.

1. Ve al Azure Portal y haz clic en Crear un recurso.
2. Busca Azure Bot, selecciona la carta Azure Bot y haz clic en Crear.
3. En el ID de la aplicación Microsoft, selecciona Usar registro de aplicación existente e introduce el ID de la aplicación (cliente) de la aplicación que has registrado.
4. Completa los campos restantes y luego haz clic en Revisar + crear > Crear.
5. Cuando termine el despliegue, haz clic en Ir a recurso.

Conecta el bot a Microsoft Teams

Añade el canal de Microsoft Teams al bot, luego crea una app de Teams para el bot y añádela a tu canal. Para el procedimiento completo, véase Conectar un bot a Microsoft Teams en la documentación de Azure Bot Service.

1. En el recurso de Azure Bot, abre los Canales de Configuración > y haz clic en Microsoft Teams.
2. Acepte los términos de servicio. En la pestaña de Mensajería , selecciona el entorno en la nube de tu bot y luego haz clic en Aplicar.
3. Crea una aplicación de Teams para el bot, empaquetala y súbela a Microsoft Teams. Para las instrucciones, consulta Publicar tu bot en Teams.
4. Añade la app de Teams al canal donde quieres recibir notificaciones del panel de control.

Obtener la dirección URL del canal de Teams

1. En Microsoft Teams, vaya al canal de destino.
2. Haga clic en el menú hamburguesa ••• junto al nombre del canal.
3. Haga clic en Copiar vínculo. Asegúrese de copiar la dirección URL del canal y no la dirección URL de Teams. Necesita esta dirección URL para configurar el destino de notificación de Azure Databricks.

Crear un webhook entrante para el canal

1. Sigue los pasos de Microsoft para crear un webhook entrante con Workflows for Microsoft Teams, usando la opción Enviar alertas de webhook a una plantilla de canal y seleccionando el canal de destino.
2. Copie y guarde la dirección URL del webhook generada. Necesita esta dirección URL para configurar el destino de notificación de Azure Databricks.

Paso 2: Configuración del destino de notificación en Azure Databricks

Cree un destino de notificación en el área de trabajo de Azure Databricks que apunte al canal de Microsoft Teams.

1. Inicie sesión en su área de trabajo de Azure Databricks.

2. Haga clic en el nombre de usuario en la esquina superior derecha del área de trabajo.

3. Seleccione Configuración en la lista desplegable.

4. En la sección Administrador del área de trabajo, haga clic en la pestaña Notificaciones.

5. Haga clic en Administrar en la sección Destinos de notificación .

6. Haga clic en Agregar destino.

7. Seleccione Microsoft Teams en la lista desplegable Tipo de destino.

8. Escriba la siguiente información:

   • Nombre: nombre descriptivo para este destino de canal de Teams
   • URL de webhook de Microsoft Teams: El URL del webhook entrante de Teams
   • ID de la aplicación: El ID de la aplicación (cliente) de tu registro de la aplicación Microsoft Entra ID
   • Secreto de autenticación: el valor del secreto de cliente de Microsoft Entra ID
   • Dirección URL del canal: la dirección URL del canal de Microsoft Teams
   • Id de arrendatario: Identificador de directorio (inquilino) de Microsoft Entra ID

9. Haga clic en Crear.

Ahora los usuarios pueden agregar este destino de notificación de Teams como suscriptor a los calendarios del tablero.

Para obtener instrucciones sobre cómo suscribir canales de Teams a horarios del tablero, consulte Suscribir un canal de Slack o Microsoft Teams.

Solución de problemas

Use lo siguiente para solucionar errores comunes con notificaciones de Microsoft Teams.

Faltan datos adjuntos en PDF

Si la notificación de Teams aparece sin archivo adjunto PDF, verifique que:

• El ID de la aplicación (cliente) está correctamente configurado en el destino de notificaciones
• El secreto de autenticación es válido y no ha expirado.
• A la aplicación se le han concedido los permisos necesarios Files.Read.All y Sites.ReadWrite.All en el identificador de Entra de Microsoft
• Se ha concedido el consentimiento del administrador para los permisos de API

Notificación que no aparece

Si las notificaciones no aparecen en el canal de Teams:

• Compruebe que la dirección URL del webhook es correcta y coincide con el canal de destino.
• Compruebe que el secreto de autenticación usa el valor del secreto de cliente de Microsoft Entra ID y no el identificador del secreto.
• Comprueba que la app de Teams para el bot se ha añadido al canal de destino
• Asegúrese de que la dirección URL del canal es correcta
• Verifique que el ID del tenant coincida con su organización de Microsoft
• Confirmar que la programación está activa y no está en pausa

Pasos siguientes

• Suscríbase los canales de Teams a las programaciones del panel. Consulte Suscribirse a un canal de Slack o Microsoft Teams.
• Configurar destinos de notificación de Slack. Consulte Configuración de notificaciones de Slack
• Configurar destinos de notificación por correo electrónico. Consulte Administración de destinos de notificación.