# Integración con Microsoft Teams (Workflows)

# Configuración en MS Teams: creación de un canal

Para integrar MS Teams con Pandora FMS primero debe ir al grupo donde serán enviados los mensajes de alerta. Una vez allí seleccione la opción **Add channel**:

[![PFMS_MS_Teams_integration_020.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-ms-teams-integration-020.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-ms-teams-integration-020.png)

Coloque un nombre, una descripción opcional y los permisos para que cada miembro del equipo tenga acceso al nuevo canal, haga clic en el botón **Add**.

[![PFMS_MS_Teams_integration_030.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/scaled-1680-/pfms-ms-teams-integration-030.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-04/pfms-ms-teams-integration-030.png)

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-ms-teams-creacion-de-un-enlace-de-autorizacion)

# Configuración en MS Teams: creación de un enlace de autorización

Microsoft Teams ha sustituido los "Incoming Webhooks" clásicos por **Workflows** (basados en Power Automate). Sigue estos pasos para obtener tu URL directamente desde un canal:

1. **Seleccionar el Canal:** Ve al equipo y al canal específico donde quieres recibir las notificaciones de Pandora FMS.  
    [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/aKCimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/aKCimage.png)
2. **Acceder a Workflows:**
    - Haz clic en los tres puntos (`...`) junto al nombre del canal.
    - Selecciona la opción **Workflows**
3. **Crear un nuevo flujo:**
    - Haz clic en el botón **+ New workflow** o **Create**.
    - En el buscador de plantillas, escribe: `"Send webhook alerts to <button aria-label="channel" class="fui-Button r1alrhcs ___2lccp70 fhovq9v f1p3nwhy f11589ue f1q5o8ev f1pdflbu f16muhyy f1t94bn6 f1s2uweq fr80ssc f1ukrpxl fecsdlb f1a06su0 ft1hn21 fuxngvv fy5bs14 fsv2rcd f1h0usnq fs4ktlq f16h9ulv fx2bmrt f1omzyqd f1dfjoow f1j98vj9 fj8yq94 f4xjyn1 f1et0tmh f9ddjv3 f1wi8ngl f14t3ns0 f1cdqgvm fy77jfu f18xdgio f1a3p1vp f1cmbuwj fz5stix fjoy568 f1qumt79 ff5ikls f14riqcs" id="bkmrk-channel" type="button">channel</button>"`
    - Selecciona la plantilla que tiene ese nombre exacto.  
          
        [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/ZmIimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/ZmIimage.png)
4. **Configurar el flujo:**
    - Selecciona un grupo y canal para enviar el mensaje.  
        [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/1Rzimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/1Rzimage.png)
    - Haz clic en Save.
5. **Obtener la URL:**
    - Una vez creado, aparecerá una pantalla de confirmación.  
        [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/hGmimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/hGmimage.png)
    - Copia la URL que aparece dando al botón **Copy webhook link**. **Esta es la URL que debes usar en el parámetro `-u` o `--url` del script.**
6. **Finalizar:** Ya está todo configurado, podemos volver a la ventana de chat.

> **Nota:** Si necesitas recuperar la URL más tarde, puedes ir a la aplicación **Workflows** en la barra lateral de Teams, entrar en **Manage workflows** (Gestionar flujos) y editar el flujo correspondiente.

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-ms-teams-creacion-de-un-canal) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-pandora-fms-creacion-de-un-comando-de-alerta)

# Configuración en Pandora FMS: creación de un comando de alerta

Descargue desde el marketplace de pandorafms el *CLI* y descomprima en el servidor Pandora FMS (la ubicación recomendada es `/usr/share/pandora_server/util/pandora-msteams-workflow` o cualquier otra donde el servidor Pandora FMS tenga derecho de lectura y ejecución).Debe

Se recomienda realizar una prueba en la misma terminal de comandos con el siguiente formato:

### Parámetros del Script

<table class="code-line" data-line="16" dir="auto" id="bkmrk-par%C3%A1metro-%28corto%29-pa"><thead class="code-line" data-line="16" dir="auto"><tr class="code-line" data-line="16" dir="auto"><th>Parámetro (Corto)</th><th>Parámetro (Largo)</th><th>Descripción</th><th>Requerido</th><th>Valor por defecto</th></tr></thead><tbody class="code-line" data-line="18" dir="auto"><tr class="code-line" data-line="18" dir="auto"><td>`-u`</td><td>`--url`</td><td>**URL del Webhook de Teams**. Generada por el flujo de Power Automate.</td><td>**Sí**</td><td>-</td></tr><tr class="code-line" data-line="19" dir="auto"><td>`-d`</td><td>`--data`</td><td>**Datos de la alerta** en formato `clave=valor` separados por comas.</td><td>**Sí**</td><td>-</td></tr><tr class="code-line" data-line="20" dir="auto"><td>`-t`</td><td>`--alert_tittle`</td><td>Título principal que aparecerá en la tarjeta.</td><td>No</td><td>`PandoraFMS alert fired`</td></tr><tr class="code-line" data-line="21" dir="auto"><td>`-D`</td><td>`--alert_desc`</td><td>Descripción o texto adicional de la alerta.</td><td>No</td><td>`Alert Fired`</td></tr><tr class="code-line" data-line="22" dir="auto"><td>-</td><td>`--image`</td><td>URL de la imagen que se mostrará en la tarjeta.</td><td>No</td><td>Logo de Pandora FMS</td></tr><tr class="code-line" data-line="23" dir="auto"><td>-</td><td>`--image_size`</td><td>Tamaño de la imagen (`Small`, `Medium`, `Large`, `Stretch`).</td><td>No</td><td>`Medium`</td></tr><tr class="code-line" data-line="24" dir="auto"><td>-</td><td>`--button`</td><td>URL a la que redirigirá el botón de acción.</td><td>No</td><td>`https://pandorafms.com`</td></tr><tr class="code-line" data-line="25" dir="auto"><td>-</td><td>`--button_desc`</td><td>Texto que se mostrará dentro del botón.</td><td>No</td><td>`Open web console`</td></tr></tbody></table>

---

### Ejemplos de Uso

#### 1. Ejemplo Básico

Envío de una alerta simple con los datos mínimos obligatorios:

```bash
./pandora-msteams-workflow \
  --url "https://tu-webhook-url" \
  --data "Agent=Server_Web_01,Module=CPU_Load,Status=Critical"

```

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/gwsimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/gwsimage.png)

#### 2. Ejemplo completo con personalización

Personalizando el título, la descripción, el botón y el tamaño de la imagen:

```bash
./pandora-msteams-workflow \
  --url "https://tu-webhook-url" \
  --data "Hostname=DB-Server-05,IP=10.0.0.50,Error=MySQL service is down" \
  --alert_tittle "CRITICAL: Database Failure" \
  --alert_desc "The database service has stopped responding. Please check immediately." \
  --image "https://img.icons8.com/color/96/error.png" \
  --image_size "Large" \
  --button "https://tu-consola-pandora.com/index.php?sec=estado&sec2=lista_agentes" \
  --button_desc "Open PandoraFMS Console"

```

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/1cPimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/1cPimage.png)

---

### Funcionamiento interno del Parámetro `--data`

El parámetro `--data` procesa una cadena de texto y la convierte en una lista de "Facts" (hechos) dentro de la Adaptive Card de Teams.

- **Formato correcto:** `Nombre=Valor,OtroNombre=OtroValor`
- **Nota:** Evita usar comas (`,`) o signos de igual (`=`) dentro de los valores, ya que el script los usa como delimitadores.

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-ms-teams-creacion-de-un-enlace-de-autorizacion) [SIGUIENTE &gt;](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-pandora-fms-creacion-de-una-accion-de-alerta)

# Configuración en Pandora FMS: creación de una acción de alerta

El paquete zip donde viene el binario, tambien contiene un fichero llamado `test-exec.txt` el cual contiene información sobre los parámetros adicionales que enriquecerán el mensaje enviado (subtítulo, color, botón de enlace web, etcétera).

 Para crear un [comando de alerta](https://prewebs.pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Alertas#Introducci.C3.B3n_al_sistema_de_alertas) vaya a la [Consola web de Pandora FMS](https://prewebs.pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Interfaz) y haga clic en **Alerts** -&gt; **Commands** -&gt; **Create**.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/aj8image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/aj8image.png)

A continuación defina los ocho campos necesarios más los dos últimos parámetros que son constantes. Asegúrese de que el campo número dos tenga marcada la casilla de campo oculto **Hide** y anote allí el enlace de autorización obtenido en la página anterior.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/hQaimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/hQaimage.png)

El archivo `test-exec` que acompaña el *Slack connector CLI* contiene información que puede utilizar para rellenar estos campos. Haga clic en el botón **Create** para guardar el comando de alerta.

Las [acciones de alerta](https://prewebs.pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Alertas#Acci.C3.B3n) permiten definir *el cómo* lanzar el comando. Vaya al menú **Alerts** -&gt; **Actions** -&gt; **Create**.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/0X5image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/0X5image.png)

Seleccione en **Command** el comando de alerta creado en la página anterior, los campos se rellenarán automáticamente. Sin embargo, siempre podrá personalizar los iconos o mensajes para los eventos de disparado y recuperación (**Triggering** y **Recovery**, respectivamente), por ejemplo.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/scaled-1680-/KCOimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2026-03/KCOimage.png)

Para guardar, haga clic en **Create**. Para aplicar esta acción, bien sea a un [Módulo o Política](https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Politicas#M.C3.B3dulos), establezca una [plantilla de alerta](https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Alertas#Plantilla_de_alerta) para tal fin.

[&lt; ANTERIOR](https://pandorafms.com/guides/public/books/integracion-con-microsoft-teams/page/configuracion-en-pandora-fms-creacion-de-un-comando-de-alerta)