Conectar Microsoft Teams

Mirox puede publicar tus notificaciones directamente en un canal de Microsoft Teams — alarmas, actividad de tickets, informes —, de modo que todo tu equipo las vea donde ya trabaja. La conexión es un flujo de trabajo de webhook entrante estándar de Teams: Teams te da una URL, y tú registras esa URL como webhook en tu configuración de notificaciones de Mirox. No hace falta instalar ningún plugin ni aplicación.

Antes de empezar

• Necesitas permiso en Microsoft Teams para añadir flujos de trabajo al canal de destino (la mayoría de los miembros del canal lo tienen; tu administrador de Teams puede restringirlo).
• Decide qué canal debe recibir las notificaciones de Mirox — un canal dedicado como Mirox Alerts las mantiene fáciles de seguir.

Paso 1 — Crear el flujo de trabajo de webhook en Teams

1. En Microsoft Teams, ve al canal que debe recibir las notificaciones.
2. Haz clic en los tres puntos (⋯) junto al nombre del canal y elige Flujos de trabajo (Workflows).
3. Selecciona la plantilla «Publicar en un canal cuando se reciba una solicitud de webhook» (en inglés: "Post to a channel when a webhook request is received").
4. Inicia sesión o confirma la conexión si se te pide, mantén o ajusta el nombre del flujo y haz clic en Siguiente.
5. Confirma el equipo y el canal, y haz clic en Agregar flujo de trabajo.
6. Teams muestra ahora la URL del webhook. Cópiala y haz clic en Listo.

Paso 2 — Añadir el webhook en Mirox

1. Abre tu Perfil y selecciona la pestaña Notificaciones.
2. En la tarjeta Canales, bajo Webhooks, haz clic en Añadir webhook.
3. Dale un nombre reconocible, por ejemplo Teams — Operaciones.
4. Pega la URL del flujo de trabajo de Teams.
5. Establece el formato en Microsoft Teams — así Mirox envía mensajes que Teams puede mostrar como tarjetas.
6. Guarda. Mirox muestra el secreto de firma una única vez — para una conexión con Teams puedes simplemente cerrarlo; consulta Sobre las cabeceras de firma más abajo.

Paso 3 — Enviar un mensaje de prueba

1. En la fila del nuevo webhook, haz clic en Probar.
2. En unos instantes, un mensaje de prueba de Mirox aparece en tu canal de Teams.

Si no llega nada, comprueba que la URL se copió completa y que el flujo de trabajo está habilitado en Teams, y vuelve a probar.

Dirigir las notificaciones a Teams

Añadir el webhook deja el canal disponible — ahora asegúrate de que las notificaciones realmente lo usan:

• Activa el interruptor principal Enviar notificaciones fuera de la app en la pestaña Notificaciones.
• Asegúrate de que el canal de webhook está habilitado y seleccionado para los grupos de notificación que te interesan en la tarjeta Qué me notifica (por defecto, los grupos siguen tu selección global de canales).

A partir de ahí, las notificaciones correspondientes se publican en tu canal de Teams según se producen.

Sobre las cabeceras de firma

Cada petición de webhook que envía Mirox va firmada: incluye cabeceras de firma y de marca de tiempo calculadas a partir del secreto de firma del webhook, de modo que un sistema receptor puede verificar que la petición procede realmente de Mirox y no es una repetición. Microsoft Teams ignora estas cabeceras — el flujo de trabajo acepta cualquier petición bien formada que conozca la URL —, así que para una conexión con Teams nunca necesitas el secreto. Importa cuando apuntas un webhook Generic JSON a tu propio sistema y quieres autenticar las peticiones entrantes; puedes volver a emitirlo en cualquier momento con Rotar secreto.

Solución de problemas

Guías relacionadas

• Notificaciones — la guía completa de configuración de notificaciones: canales, grupos, silencios y horario laboral
• Tickets — la actividad de tickets que puede publicarse en Teams