Intégration HaloPSA n8nAutomatiser HaloPSA avec n8n.

L'opération ouvre une fiche client dans HaloPSA et renvoie ce que l'API répond à son sujet.

• Name : le nom du client, seul champ obligatoire. Tu le saisis, ou tu le récupères d'un nœud précédent avec une expression, la syntaxe n8n qui va chercher une valeur dans l'item entrant.
• VIP : un booléen qui indique si le client est VIP ou non.
• Website : le site web du client, à remplir quand la même entreprise apparaît deux fois dans la liste.

Supprimer un client tient en un champ. Tu donnes l'identifiant, la fiche disparaît de HaloPSA.

• Client ID : l'identifiant de la fiche à retirer. C'est bien un identifiant et pas une raison sociale, donc il vient d'une étape précédente, par exemple sous la forme {{ $json.field }}.

Le nœud va chercher une fiche client précise et la remet dans le flux, prête à être exploitée par la suite.

• Client ID : la fiche à lire.
• Simplify : activé, n8n renvoie une version simplifiée de la réponse au lieu des données brutes, ce qui raccourcit nettement le mapping des nœuds suivants.

Là où la lecture unitaire ramène une fiche, celle-ci ramène la liste, page après page si tu le demandes.

• Active Status : Active Only garde les clients actifs, Inactive Only les inactifs, All les deux.
• Return All : coché, n8n parcourt toutes les pages ; décoché, Limit fixe le nombre maximal de résultats.

Sur une fiche existante, le nœud envoie les champs que tu renseignes dans la collection Update Fields.

• Client ID : la fiche qui reçoit la modification.
• VIP : le même booléen qu'à la création, pour promouvoir un compte plus tard.
• Notes : du texte libre, utile pour noter la raison du changement.

Un site dépend toujours d'un client : l'opération demande donc les deux informations avant de partir.

• Name : le nom du site.
• Client ID : le client auquel il se rattache.
• Select Client by ID : un booléen qui indique si le client peut être sélectionné par son identifiant.
• Phone Number : le numéro de la ligne sur place.
• Main Contact : la personne référente pour ce site.

Retirer un site de la structure d'un client se fait en un appel. L'opération ne réclame rien d'autre que l'identifiant, ce qui la rend facile à enchaîner après une vérification.

• Site ID : le site à supprimer.

Pour lire un site isolément, sans remonter toute l'arborescence du client, c'est cette opération.

• Site ID : le site à lire.
• Simplify : renvoie une version simplifiée de la réponse plutôt que les données brutes.

Quand l'inventaire des adresses d'un client devient flou, cette opération le remet à plat.

• Return All : coché, n8n enchaîne les pages jusqu'au dernier site ; décoché, Limit borne le résultat.
• Text To Filter By : filtre les sites sur ta chaîne de recherche.

Modifier un site passe par la collection Update Fields, l'identifiant restant en dehors de celle-ci.

• Site ID : le nœud ne le marque pas comme requis, renseigne-le pour désigner le site visé.
• Client ID : rattache le site à un autre client.
• Main Contact : la personne référente sur place.

Le ticket est le cas le plus fréquent. Trois champs obligatoires suffisent à le faire exister.

• Ticket Type Name or ID : à choisir dans la liste, ou à fournir sous forme d'identifiant via une expression quand le type dépend de la demande.
• Summary : la ligne que l'agent lit dans la file.
• Details : le corps de la demande.
• Target Date : optionnelle, dans Additional Fields, et le champ qui détermine où le ticket apparaît dans une vue triée par date.

Certains tickets n'auraient jamais dû exister. Cette opération les retire sans détour.

• Ticket ID : le ticket à supprimer, unique champ demandé.

Relire un ticket par son identifiant permet de travailler sur son état actuel, pas sur celui d'il y a dix minutes.

• Ticket ID : le ticket à lire.
• Simplify : une version simplifiée de la réponse au lieu des données brutes, plus simple à insérer dans un message.

La liste des tickets alimente tous les tableaux de bord, et c'est cette opération qui la produit.

• Text To Filter By : filtre les tickets sur ta chaîne de recherche.
• Return All et Limit : tout remonter, ou s'arrêter à un nombre fixe pendant les essais.

Un ticket vit : il change de main, de date, de contenu. Les modifications passent par Update Fields.

• Ticket ID : non marqué requis par le nœud, mais c'est lui qui désigne le ticket à modifier.
• Assigned Agent Name or ID : à choisir dans la liste, ou à fournir en identifiant via une expression.
• Target Date : la date cible, à repousser quand le client demande un délai.

Les utilisateurs se rattachent à un site, d'où les deux champs obligatoires de l'opération.

• Name : le nom de l'utilisateur.
• Site Name or ID : à choisir dans la liste, ou à fournir en identifiant via une expression.
• Email : l'adresse du nouvel utilisateur.
• Surname : le nom de famille, utile pour le distinguer d'un homonyme.
• Password : s'il est renseigné, il lui faut au moins 8 caractères, avec une lettre, un chiffre ou un symbole, une majuscule et une minuscule.

Quand un contact quitte le client, son compte n'a plus de raison d'être dans HaloPSA. Un identifiant suffit, et un seul appel API fait le reste.

• User ID : l'utilisateur à supprimer.

Aller chercher un utilisateur précis sert surtout à vérifier avant d'agir.

• User ID : l'utilisateur à lire.
• Simplify : une version simplifiée de la réponse plutôt que les données brutes.

Lister les utilisateurs répond à la question que pose chaque revue de compte : qui a le droit d'ouvrir un ticket ici ?

• Active Status : Active Only, Inactive Only ou All.
• Simplify : allège la réponse quand tu n'as besoin que des noms.
• Return All et Limit : toutes les pages, ou un échantillon.

Déplacer un utilisateur ou corriger ses coordonnées passe par Update Fields, la collection la plus fournie des quatre ressources.

• User ID : laissé optionnel par le nœud, à renseigner pour viser la bonne personne.
• Site Name or ID : à choisir dans la liste, ou à fournir en identifiant via une expression, pour déplacer l'utilisateur vers un autre site.
• User Is Inactive : un booléen, plus doux que la suppression pour une absence longue.