Ir al contenido principal

Integración con AlgaPSA

Connect Level to AlgaPSA so groups map to clients, devices sync as assets, and Level alerts open AlgaPSA tickets.

Introducción

AlgaPSA refleja tu configuración de Level en el lado del PSA: los grupos de Level se corresponden con clientes de AlgaPSA, los dispositivos en grupos mapeados se sincronizan como Activos y las alertas de Level abren tickets a través de las reglas de alerta de AlgaPSA.
​

La configuración abarca ambas plataformas. En Level creas una clave de API y una automatización que publica alertas en AlgaPSA. En AlgaPSA pegas la clave, mapeas los grupos y ejecutas la sincronización de dispositivos.

ℹ️ NOTA: Esta integración fue desarrollada y es mantenida por Nine Minds, los creadores de AlgaPSA. Para la parte de configuración de AlgaPSA, consulta su documentación: Integración de Level RMM. Es una función de la edición Enterprise de AlgaPSA.

⚙️ REQUISITOS PREVIOS

  • Acceso de administrador en Level (para crear una clave de API y construir una automatización)

  • Una cuenta de AlgaPSA Enterprise Edition con acceso a la Configuración de administrador

  • Tu instancia de AlgaPSA accesible en una dirección HTTPS pública (consulta la advertencia en Enviar alertas a AlgaPSA)

Integración con AlgaPSA

Crear una clave de API en Level

AlgaPSA utiliza una clave de API de Level para leer tus grupos, dispositivos y alertas.

  1. En Level, navega a Configuración → Claves de API.

  2. Haz clic en + Crear clave de API.

  3. Introduce una Descripción como «Integración AlgaPSA».

  4. Selecciona Solo lectura. Todo lo que AlgaPSA obtiene de Level (descubrimiento de grupos, sincronización de dispositivos, recuperación de alertas) es una lectura, por lo que una clave de solo lectura es suficiente.

  5. Haz clic en Crear clave, luego usa el menú de tres puntos en la nueva fila y elige Copiar clave.

Consulta Configuración de claves de API para obtener detalles completos sobre la gestión de claves.

Conectar AlgaPSA a Level

  1. En AlgaPSA, ve a Configuración → General para abrir la Configuración de administrador.

  2. Selecciona Integraciones en Datos & Integración, abre la RMM pestaña, y selecciona Level.

  3. Pega tu clave en el campo Clave de API campo en la Conexión con Level tarjeta.

  4. Haz clic en Guardar configuración, luego Probar conexión.

Una prueba exitosa marca la integración como Conectado y muestra la hora de conexión.

Mapear grupos y sincronizar dispositivos

El mapeo se realiza completamente en AlgaPSA, en la Sincronizar & Mapeos de grupos tarjeta.

  1. Haz clic en Descubrir grupos. AlgaPSA importa la jerarquía de grupos de Level a la tabla de mapeo.

  2. Para cada grupo que gestiones, elige un cliente de AlgaPSA en el Cliente mapeado desplegable. Opcionalmente, establece un Contacto predeterminado, que se adjunta a los tickets abiertos por alertas de ese grupo.

  3. Haz clic en Ejecutar sincronización de dispositivos. Los dispositivos en grupos mapeados se convierten en activos de AlgaPSA.

Hay dos comportamientos que vale la pena conocer:

  • Los subgrupos heredan. Un subgrupo sin mapeo propio utiliza el padre mapeado más cercano, por lo que mapear el grupo de nivel superior de un cliente generalmente cubre todo su árbol.

  • Los grupos no mapeados se omiten. Los dispositivos en un grupo sin mapeo y sin padre mapeado no se sincronizan.

💡 CONSEJO: Mapea un grupo de nivel superior de Level por cliente y deja que los subgrupos hereden. Es menos trabajo de mantenimiento que mapear cada subgrupo manualmente.

Enviar alertas a AlgaPSA

AlgaPSA autentica las alertas entrantes con su propia X-Alga-Webhook-Secret cabecera y espera su propio payload JSON. Los webhooks integrados de Level (Configuración → Webhooks) envían un payload fijo y solo añaden una X-Level-Signature cabecera, por lo que las alertas van a AlgaPSA a través de una automatización con una Solicitud HTTP acción en su lugar, que te permite establecer cabeceras y cuerpo personalizados.
​

En AlgaPSA, abre la Webhook de alerta tarjeta y copia los tres valores que te proporciona: el URL del webhook, el Cabecera nombre y secreto (el icono de ojo revela el secreto), y la Plantilla de payload.

En Level:

  1. Navega a Automatizaciones y crea una nueva automatización, por ejemplo «Ticket de alerta AlgaPSA».

  2. En el pipeline, haz clic en Añadir una acción y selecciona Solicitud HTTP de la Otro categoría.

  3. Completa la acción:

    • URL: la URL del webhook de AlgaPSA

    • Método: POST

    • Tipo de contenido: application/json

    • Cuerpo: la plantilla de payload de AlgaPSA, pegada tal cual

    • Cabeceras: haz clic en + Añadir cabeceras de solicitud y añade X-Alga-Webhook-Secret con el valor del secreto

  4. Haz clic en Guardar en el panel lateral de la acción.

An automation in edit mode with an HTTP request action panel open, showing the URL, Method POST, Content type application/json, Body, and a custom request header row

Ahora apunta los monitores que deben abrir tickets a esa automatización:

  1. Abre la política de monitores que genera las alertas que quieres convertir en tickets (Políticas de monitores en la barra lateral).

  2. Abre un monitor y busca la sección Corrección sección, «Ejecutar automatizaciones cuando se dispare esta alerta».

  3. Selecciona tu automatización de AlgaPSA en el Automatización de corrección selector, luego guarda.

  4. Repite el proceso para cada monitor cuyas alertas deban convertirse en tickets.

A monitor in a monitor policy with the Remediation section visible

La automatización se ejecuta en el dispositivo que generó la alerta, por lo que la solicitud incluye los detalles de ese dispositivo.

⚠️ ADVERTENCIA: La acción de solicitud HTTP solo llama a direcciones públicas. Si alojas AlgaPSA en una dirección privada o de bucle invertido, la acción falla con «Solicitud bloqueada: No se pueden realizar solicitudes a direcciones privadas o de bucle invertido.» Asigna a tu instancia de AlgaPSA un nombre de host HTTPS resolvible públicamente antes de configurar la automatización.

Recuperar alertas existentes

El webhook es el feed en tiempo real. Para obtener alertas que ya existen en Level, o para ponerse al día tras un evento perdido, haz clic en Recuperar alertas en la Sincronización & tarjeta de Mapeos de grupos. No hay sondeo programado.

Probar la integración

  1. Confirma que la tarjeta de Conexión con Level en AlgaPSA muestra Conectado con una marca de tiempo reciente.

  2. Comprueba la lista de activos de un cliente en AlgaPSA comparándola con su grupo en Level.

  3. Dispara una alerta de prueba en Level en un monitor al que hayas adjuntado la automatización.

  4. Confirma que aparece un ticket en AlgaPSA y se enruta a través de tus reglas de alerta.

Si no aparece ningún ticket, abre la ejecución de la automatización para ese dispositivo y lee la salida de la acción de solicitud HTTP. Registra la respuesta, por ejemplo HTTP 401 - Unauthorized por un secreto incorrecto o HTTP 404 - Not Found por una URL mal escrita. Luego comprueba:

  • El nombre de la cabecera es exactamente X-Alga-Webhook-Secret y el secreto no tiene espacios adicionales.

  • La URL del webhook se copió completa.

  • El grupo del dispositivo que genera alertas está mapeado a un cliente en AlgaPSA.

  • El monitor realmente lista tu automatización en Corrección.

Gestión continua

  • Rotar la clave: crea una nueva clave de API en Level, pégala en AlgaPSA, prueba la conexión y luego elimina la clave anterior. Eliminar una clave surte efecto de inmediato, así que hazlo en ese orden.

  • Añadir grupos o dispositivos: ejecuta Descubrir grupos después de añadir grupos en Level, y Ejecutar sincronización de dispositivos para incorporar los nuevos dispositivos.

  • Pausar la generación de tickets: deshabilita la automatización de Level, o elimínala del campo Corrección campo para detener solo las alertas de ese monitor.

  • Cambiar el secreto: actualiza el valor de la cabecera en la automatización de Level cada vez que lo regeneres en AlgaPSA.

Preguntas frecuentes

  • ¿Necesito habilitar AlgaPSA en la página de Integraciones de Level? No. Configuración → Integraciones en Level cubre ConnectWise PSA, HaloPSA, Zest, Hudu y DeskDay. AlgaPSA se conecta a través de la API de Level y una automatización, por lo que no hay nada que activar allí.

  • ¿La clave de API es de solo lectura o de lectura y escritura? Solo lectura. AlgaPSA lee grupos, dispositivos y alertas de Level y no escribe nada de vuelta. Si una prueba de conexión o sincronización falla con un error de permisos, consulta con Nine Minds antes de ampliar los permisos de la clave.

  • ¿Puedo usar Configuración → Webhooks en lugar de una automatización? No para AlgaPSA. Los webhooks de Level no pueden añadir una cabecera personalizada, y AlgaPSA requiere X-Alga-Webhook-Secret en cada solicitud. La acción de solicitud HTTP dentro de una automatización es la que la envía.

  • ¿Cerrar un ticket en AlgaPSA resuelve la alerta en Level? La documentación de AlgaPSA cubre la dirección de Level a AlgaPSA (alertas que abren tickets). Consulta a Nine Minds sobre el comportamiento de cierre de tickets en su lado.

  • ¿Qué dispositivos se sincronizan en AlgaPSA? Los dispositivos en grupos mapeados a un cliente, más los dispositivos en subgrupos que heredan un padre mapeado. Las ramas no mapeadas se omiten.

  • ¿Se sobreescriben los activos existentes de AlgaPSA? La sincronización de dispositivos se gestiona desde AlgaPSA. Consulta su Integración de Level RMM documentación y Cómo funcionan las integraciones de RMM en AlgaPSA para saber cómo se emparejan y actualizan los activos.

  • ¿Quién puede configurar esto? Un administrador de Level (para la clave de API y la automatización) y un usuario de AlgaPSA con acceso a la Configuración de administrador.

Artículos relacionados
¿Ha quedado contestada tu pregunta?