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 asignan a clientes de AlgaPSA, los dispositivos en grupos asignados 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 envía alertas a AlgaPSA. En AlgaPSA, pegas la clave, asignas grupos y ejecutas la sincronización de dispositivos.

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

⚙️ REQUISITOS PREVIOS

  • Acceso de administrador a 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, relleno retroactivo 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 Conectada y muestra el tiempo de conexión.

Asignar grupos y sincronizar dispositivos

La asignación se realiza completamente en AlgaPSA, en la Sincronización & Asignaciones de grupos tarjeta.

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

  2. Para cada grupo que gestionas, elige un cliente de AlgaPSA en el Cliente asignado 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 asignados se convierten en activos de AlgaPSA.

Hay dos comportamientos que vale la pena conocer:

  • Los subgrupos heredan. Un subgrupo sin asignación propia utiliza el padre asignado más cercano, por lo que asignar el grupo de nivel superior de un cliente generalmente cubre todo su árbol.

  • Los grupos sin asignación se omiten. Los dispositivos en un grupo sin asignación y sin padre asignado no se sincronizan.

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

Enviar alertas a AlgaPSA

AlgaPSA autentica las alertas entrantes con su propio X-Alga-Webhook-Secret encabezado y espera su propio payload JSON. Los webhooks integrados de Level (Configuración → Webhooks) envían un payload fijo y solo añaden un X-Level-Signature encabezado, 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 permite establecer encabezados y cuerpo personalizados.

En AlgaPSA, abre la Webhook de alertas tarjeta y copia los tres valores que te proporciona: el URL del webhook, el Encabezado 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 + y selecciona Solicitud HTTP de la categoría Otros.

  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

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

  4. Guarda la automatizació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 deseas convertir en tickets (Políticas de monitores en la barra lateral).

  2. Abre un monitor y busca la 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 contra 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 loopback, la acción falla con «Solicitud bloqueada: no se pueden realizar solicitudes a direcciones privadas o de loopback». Asigna a tu instancia de AlgaPSA un nombre de host HTTPS resoluble públicamente antes de configurar la automatización.

Relleno retroactivo de alertas existentes

El webhook es el flujo en tiempo real. Para obtener alertas que ya existen en Level, o para ponerse al día después de un evento perdido, haz clic en Relleno retroactivo de alertas en la Sincronización de AlgaPSA & tarjeta de Asignaciones de grupos. No hay sondeo programado.

Probar la integración

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

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

  3. Activa 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 que se procesa 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 para un secreto incorrecto o HTTP 404 - Not Found para una URL mal escrita. Luego comprueba:

  • El nombre del encabezado 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á asignado a un cliente en AlgaPSA.

  • El monitor realmente incluye 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 antigua. Eliminar una clave tiene efecto 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 del encabezado 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 incluye 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 un encabezado personalizado, 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 asignados a un cliente, más los dispositivos en subgrupos que heredan un padre asignado. Las ramas sin asignación se omiten.

  • ¿Se sobreescriben los activos existentes de AlgaPSA? La sincronización de dispositivos se gestiona desde AlgaPSA. Consulta su Integración con Level RMM documentación y Cómo funcionan las integraciones RMM en AlgaPSA para saber cómo se comparan 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?