Integración HaloPSA n8nAutomatiza HaloPSA con n8n.

La operación abre una ficha de cliente en HaloPSA y devuelve lo que la API responde sobre ella.

• Name: el nombre del cliente, único campo obligatorio. Lo escribes tú o lo traes de un nodo anterior con una expresión, la sintaxis de n8n que lee un valor del elemento entrante.
• VIP: un booleano que indica si el cliente es VIP o no.
• Website: opcional, útil cuando la misma empresa aparece dos veces en la lista.

Borrar una ficha de cliente ocupa un solo campo: le pasas el identificador y desaparece.

• Client ID: el identificador de la ficha que se elimina. Es un identificador, no el nombre de la empresa, así que sale de un paso anterior, por ejemplo con {{ $json.field }}.

El nodo trae una ficha de cliente concreta y la deja lista para el resto del flujo.

• Client ID: la ficha que se lee.
• Simplify: activado, n8n devuelve una versión simplificada de la respuesta en lugar de los datos en bruto, lo que acorta mucho el mapeo de los nodos siguientes.

Cuando necesitas la cartera entera y no una ficha suelta, esta operación devuelve la lista.

• Return All y Limit: recorrer todas las páginas, o parar en un número fijo.
• Active Status: Active Only mantiene los clientes activos, Inactive Only los inactivos, All devuelve ambos.

Sobre una ficha ya creada, el nodo envía los campos que rellenas en la colección Update Fields.

• Client ID: la ficha que recibe el cambio.
• VIP: el mismo booleano que en la creación, para ascender una cuenta más adelante.
• Notes: texto libre, útil para anotar por qué se hizo el cambio.

Una sede cuelga siempre de un cliente, y por eso la operación pide las dos cosas antes de ejecutarse.

• Name: el nombre de la sede.
• Client ID: el cliente al que pertenece.
• Select Client by ID: un booleano que indica si el cliente se puede seleccionar por identificador.
• Phone Number: el número de teléfono de la sede.
• Main Contact: opcional, dentro de Additional Fields, la persona de referencia en esa dirección.

Quitar una sede de la estructura de un cliente es una llamada corta. La operación no pide nada más que el identificador, así que encaja bien detrás de un paso de verificación.

• Site ID: la sede que se elimina.

Leer una sede por separado evita arrastrar toda la estructura del cliente cuando solo interesa una dirección.

• Site ID: la sede que se lee.
• Simplify: versión simplificada de la respuesta en lugar de los datos en bruto.

Si el inventario de direcciones de un cliente se ha vuelto confuso, esta operación lo pone en orden.

• Text To Filter By: filtra las sedes por tu cadena de búsqueda.
• Return All y Limit: todas las páginas, o un tope de resultados.

Cambiar los datos de una sede se hace desde Update Fields, mientras el identificador queda fuera de esa colección.

• Site ID: el nodo no lo marca como obligatorio, rellénalo para señalar qué sede cambia.
• Client ID: traslada la sede a otro cliente.
• Main Contact: la persona de referencia registrada para la sede.

El ticket nace con tres campos obligatorios, y a partir de ahí ya existe en la cola.

• Ticket Type Name or ID: se elige de la lista, o se indica un identificador mediante una expresión cuando el tipo depende de lo que llega.
• Summary: la línea que lee el agente en la cola.
• Details: el cuerpo de la petición.
• Target Date: opcional, en Additional Fields, la fecha límite del ticket.

Hay tickets que nunca deberían haber entrado en la cola. Esta operación los retira.

• Ticket ID: el ticket que se elimina, único campo que pide.

Recuperar un ticket por su identificador sirve para trabajar con su estado actual y no con el de hace un rato.

• Ticket ID: el ticket que se lee.
• Simplify: una respuesta simplificada en vez de los datos en bruto, más fácil de meter en una plantilla de mensaje.

Listar tickets es la materia prima de cualquier panel de seguimiento, y sale de esta operación.

• Return All: activado, n8n encadena las páginas hasta leer la cola entera; desactivado, Limit marca el máximo de tickets devueltos.
• Text To Filter By: filtra los tickets por tu cadena de búsqueda.

Un ticket cambia de manos, de fecha y de contenido. Todo eso viaja en Update Fields.

• Ticket ID: el nodo no lo marca como obligatorio, pero es lo que indica qué ticket se modifica.
• Assigned Agent Name or ID: se elige de la lista, o se indica un identificador mediante una expresión.
• Target Date: se retrasa cuando el cliente pide más tiempo.

Los usuarios viven dentro de una sede, de ahí los dos campos obligatorios de esta operación.

• Name: el nombre del usuario.
• Site Name or ID: se elige de la lista, o se indica un identificador mediante una expresión.
• Email: opcional, dentro de Additional Fields.
• Surname: el apellido, útil para distinguir a alguien con nombre repetido.
• Password: si se define, necesita al menos 8 caracteres, con una letra, un número o símbolo, una mayúscula y una minúscula.

Cuando alguien sale de la empresa cliente, su usuario deja de tener sentido. Un identificador y ya está.

• User ID: el usuario que se elimina.

Traer un usuario concreto sirve sobre todo para comprobar antes de tocar nada.

• User ID: el usuario que se lee.
• Simplify: versión simplificada de la respuesta en lugar de los datos en bruto.

Para sacar el listado de quién puede abrir tickets en una cuenta, esta es la operación.

• Return All: recorre todas las páginas de usuarios; desactivado, Limit fija el máximo devuelto.
• Simplify: aligera la respuesta cuando solo hacen falta los nombres para comparar.
• Active Status: Active Only, Inactive Only o All.

Mover un usuario o corregir sus datos pasa por Update Fields, la colección más amplia de los cuatro recursos.

• User ID: el nodo lo deja opcional, rellénalo para apuntar a la persona correcta.
• Site Name or ID: se elige de la lista, o se indica un identificador mediante una expresión, para trasladar al usuario a otra sede.
• User Is Inactive: un booleano, más suave que borrar cuando alguien está de baja temporal.