Introducción
Esta integración sincroniza los dispositivos de Level en HaloPSA como activos y enruta las alertas de Level a tickets de HaloPSA. La configuración se realiza en tres etapas: configurar una aplicación de HaloPSA, conectarla en Level y luego mapear los grupos de dispositivos a sitios de HaloPSA y elegir qué políticas de monitor crean tickets.
⚙️ REQUISITOS PREVIOS
Acceso de administrador en Level
Acceso de administrador en HaloPSA con permiso para crear aplicaciones y gestionar agentes
Integración con HaloPSA
Configurar la aplicación de HaloPSA
HaloPSA utiliza «Aplicaciones» para permitir el acceso a la API. Necesitamos crear una para Level.
1. Ve a Configuración > Integraciones:
2. Haz clic en «HaloPSA API»:
3. Toma nota de la URL base que se muestra a continuación. Se utilizará como «HaloPSA URL» al configurar Level:
4. Haz clic en «View Applications»:
5. Esta es la lista de tus «Applications» existentes. Haz clic en «New» en la esquina superior derecha para crear una aplicación para Level:
6. Completa el campo obligatorio «Application Name» con un nombre de tu elección. Selecciona la opción «Client ID and Secret (Services)»:
7. Toma nota del «Client ID» y el «Client Secret», ya que los necesitaremos al configurar Level.
8. Elige «Agent» para el «Login Type» y selecciona el agente que deseas que use Level.
💡 CONSEJO: HaloPSA recomienda crear un agente «API only» para las integraciones. Este tipo de agente no cuenta contra las licencias disponibles.
9. Haz clic en «Save»:
10. Haz clic en «Permissions»:
11. Selecciona los siguientes permisos:
read:tickets
edit:tickets
read:customers
read:assets
edit:assets
ℹ️ NOTA: Halo realizó recientemente un cambio que impide que las integraciones sin rol de administrador agreguen campos a los tipos de activos. Están trabajando para revertir el cambio, pero tomará aproximadamente dos semanas (alrededor del 19 de noviembre). Mientras tanto, si estás configurando tu integración de Halo por primera vez, por favor otorga el permiso de «admin» a la aplicación y el agente. Disculpa las molestias.
12. Haz clic en «Save» cuando hayas terminado:
Configurar los permisos del agente de HaloPSA
El agente de API que configuraste en el paso anterior como «Agent to log in as» requiere un par de permisos para funcionar correctamente.
1. Ve a Configuración > Teams & Agents > Agents y elige el agente asignado a la aplicación:
2. Haz clic en la pestaña «Permissions» y activa el modo «Edit»:
3. Asegúrate de que los siguientes ajustes estén configurados:
Tickets Access Level - Read and Modify
Clients Access Level - Read Only
Assets Access Level - Read and Modify
Can add new Tickets - Yes
Allow use of all Ticket Types - Yes
4. Haz clic en «Save» cuando hayas terminado:
Configurar la integración en Level
1. Ve a Configuración > Integraciones:
2. Haz clic en la integración de HaloPSA:
3. Completa los tres campos de configuración:
HaloPSA URL
La URL que utilizas para acceder a tu instancia de HaloPSA. Esta URL puede apuntar a una ubicación local o en la nube y debe incluir el protocolo correspondiente. Por ejemplo: https://domainhalopsa.com.
Client ID
El valor que generamos en los pasos anteriores.
Client secret
El valor que generamos en los pasos anteriores.
4. Haz clic en el botón «Save changes»:
5. Presiona «Test connection» para asegurarte de que tu configuración funciona:
Mapear grupos de Level a sitios de HaloPSA
Level creará activos en HaloPSA según tus asignaciones de grupos. Puedes elegir cualquier grupo o subgrupo en Level y asociarlo con una combinación de empresa y sitio de HaloPSA.
1. Ve a «Group mapping»:
2. Haz clic en «Add new groups» para seleccionar los grupos de Level que deseas mapear a sitios de HaloPSA:
3. Elige uno o más grupos y haz clic en «Add new groups»:
4. Elige una empresa de HaloPSA para el primer mapeo:
5. Selecciona el sitio de HaloPSA:
6. Repite para cada fila y haz clic en «Save» cuando hayas terminado:
ℹ️ NOTA: La integración permanece deshabilitada en esta etapa, por lo que aún no se sincronizan dispositivos.
Mapear políticas de monitor de Level a tipos de tickets de HaloPSA
Level puede mapear alertas a tickets de HaloPSA. Solo necesitamos seleccionar qué políticas de monitor deben crear tickets, así como los tipos de tickets bajo los cuales se deben crear.
1. Haz clic en «Ticketing»:
2. Elige los tipos de tickets de HaloPSA para cada política que desees mapear:
3. Cuando hayas terminado, haz clic en «Save changes» en la parte inferior de la página:
ℹ️ NOTA: La integración permanece deshabilitada en esta etapa, por lo que aún no se sincronizan dispositivos.
Comenzar a enviar dispositivos y alertas
1. Haz clic en el interruptor «Disabled»:
2. Esto comenzará a enviar dispositivos y alertas de inmediato. Puedes ver cómo los mapeos de grupos cambian de «Unsynced» a «Syncing» y finalmente a «Synced»:
3. Si deseas seguir el progreso o solucionar un problema, navega a la pestaña «Events» para ver una lista en tiempo real de las solicitudes que se envían a HaloPSA:
Preguntas frecuentes
¿Quién puede configurar esta integración? Un administrador de Level. Del lado de HaloPSA también se requiere un administrador con permiso para crear aplicaciones y gestionar agentes.
¿Necesito crear un agente de HaloPSA dedicado para esto? HaloPSA lo recomienda. Un agente «API only» no consume una licencia y mantiene la actividad de la integración separada de la actividad de los agentes humanos.
¿Se sincronizarán todos los dispositivos de inmediato al habilitar la integración? Sí. Al habilitar el interruptor se comienza a sincronizar todos los dispositivos en los grupos mapeados. Observa la tabla de mapeo de grupos: las filas pasan de «Unsynced» a «Synced» a medida que se procesan los dispositivos.
¿Por qué no aparece un dispositivo en HaloPSA? Verifica que el grupo del dispositivo esté mapeado en Group mapping y que la integración esté habilitada. Luego abre la Events y busca solicitudes fallidas relacionadas con ese dispositivo.
¿Puedo mapear más grupos después de que la integración esté activa? Sí. Vuelve a Group mapping, agrega nuevos grupos y guarda. Los nuevos grupos se sincronizan después de guardar el mapeo.