INTÉGRATION HALOPSA n8n : AUTOMATISER HALOPSA AVEC N8N

L'action "Create Client" vous permet d'ajouter un nouveau client directement dans votre instance HaloPSA depuis n8n. C'est la pierre angulaire de toute automatisation d'onboarding client : dès qu'un prospect signe ou qu'un formulaire est validé, créez automatiquement sa fiche client.

Paramètres clés :

• Credential to connect with : Sélectionnez vos identifiants HaloPSA dans le menu déroulant. Ce paramètre est requis pour authentifier la requête API.
• Resource : Menu déroulant défini sur "Client" pour cibler les entités clients.
• Operation : Défini sur "Create" pour la création d'un nouveau client.
• Name : Champ texte pour le nom du client à créer. Ce paramètre est requis et accepte une valeur fixe ou une expression dynamique.
• Additional Fields : Section extensible pour ajouter des propriétés supplémentaires (email, téléphone, adresse, etc.).

Cas d'usage typiques :

• Créer un client HaloPSA quand un deal est gagné dans votre CRM
• Onboarder automatiquement les nouveaux inscrits depuis un formulaire web
• Synchroniser les clients depuis une base de données externe

L'action "Delete Client" supprime définitivement un client de votre instance HaloPSA. Utilisez-la avec précaution dans vos workflows de nettoyage de données ou de gestion du cycle de vie client.

Paramètres clés :

• Credential to connect with : Menu déroulant pour sélectionner les credentials HaloPSA. Requis.
• Resource : Défini sur "Client" pour cibler les entités clients.
• Operation : Défini sur "Delete" pour l'opération de suppression.
• Client ID : Champ texte où vous entrez l'identifiant unique du client à supprimer. Ce paramètre est requis pour cibler précisément le bon enregistrement.

Cas d'usage typiques :

• Supprimer les clients inactifs après une période définie
• Nettoyer les doublons identifiés par un workflow de déduplication
• Gérer les demandes RGPD de suppression de données

L'action "Get Client" récupère les informations détaillées d'un client spécifique dans HaloPSA. Idéale pour enrichir vos workflows avec des données client actualisées avant de les envoyer vers d'autres applications.

Paramètres clés :

• Credential to connect with : Sélection des credentials HaloPSA. Requis.
• Resource : Menu déroulant défini sur "Client".
• Operation : Défini sur "Get" pour récupérer un enregistrement unique.
• Client ID : Champ texte pour l'identifiant du client à récupérer. Requis.
• Simplify : Interrupteur on/off qui, lorsqu'activé, simplifie la structure des données retournées pour faciliter leur utilisation dans les nœuds suivants.

Cas d'usage typiques :

• Récupérer les infos client pour personnaliser un email automatique
• Vérifier l'existence d'un client avant d'en créer un nouveau
• Alimenter un dashboard avec des données client en temps réel

L'action "Get Many Client" récupère plusieurs clients en une seule requête. Parfaite pour les synchronisations en masse, les exports ou les rapports impliquant l'ensemble de votre base client.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Client".
• Operation : Défini sur "Get Many" pour récupérer plusieurs enregistrements.
• Simplify : Interrupteur pour simplifier les données retournées. Activé par défaut.
• Return All : Interrupteur pour retourner tous les clients sans limite. Désactivé par défaut.
• Limit : Champ numérique définissant le nombre maximum de clients à récupérer (défaut : 50). Actif uniquement si "Return All" est désactivé.
• Filters : Section extensible pour ajouter des critères de filtrage et affiner les résultats.

Cas d'usage typiques :

• Exporter la liste complète des clients vers un Google Sheet via n8n
• Générer un rapport hebdomadaire des nouveaux clients
• Synchroniser les clients avec un outil marketing

L'action "Client - Update" met à jour les informations d'un client existant dans HaloPSA. Essentielle pour maintenir vos données client synchronisées entre toutes vos applications.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Client".
• Operation : Défini sur "Update" pour modifier un enregistrement existant.
• Client ID : Identifiant du client à mettre à jour. Requis.
• Update Fields : Section dynamique où vous ajoutez les champs à modifier et leurs nouvelles valeurs via le bouton "Add Field".

Cas d'usage typiques :

• Mettre à jour l'email d'un client quand il change dans votre CRM
• Synchroniser le statut client entre plusieurs systèmes
• Enrichir les fiches client avec des données provenant d'autres sources

L'action "Create Site" crée un nouveau site (emplacement) dans HaloPSA, rattaché à un client. Utile pour les MSP gérant des clients multi-sites.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Site".
• Operation : Défini sur "Create".
• Name : Nom du site à créer. Requis. Accepte une valeur fixe ou une expression.
• Select Client by ID : Interrupteur pour choisir le mode de sélection du client (par ID ou par nom).
• Client Name or ID : Champ pour associer le site à un client existant.
• Additional Fields : Section pour ajouter des propriétés supplémentaires (adresse, contact principal, etc.).

Cas d'usage typiques :

• Créer un site quand un nouveau bureau est ajouté pour un client
• Automatiser l'onboarding multi-sites depuis un formulaire
• Synchroniser les sites depuis un système de gestion immobilière

L'action "Delete Site" supprime un site de votre instance HaloPSA. À utiliser dans les workflows de nettoyage ou quand un site client est désactivé.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Site".
• Operation : Défini sur "Delete".
• Site ID : Identifiant unique du site à supprimer. Requis.

Cas d'usage typiques :

• Supprimer les sites associés à un client résilié
• Nettoyer les sites de test après validation
• Gérer le cycle de vie des sites dans un workflow de désactivation

L'action "Get Site" récupère les informations détaillées d'un site spécifique. Idéale pour vérifier ou enrichir les données d'un site avant une action ultérieure.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Site".
• Operation : Défini sur "Get".
• Site ID : Identifiant du site à récupérer. Optionnel mais nécessaire pour cibler un site précis.
• Simplify : Interrupteur pour simplifier la structure des données retournées.

Cas d'usage typiques :

• Récupérer l'adresse d'un site pour une notification
• Vérifier les informations d'un site avant création d'un ticket
• Alimenter un système de reporting avec des données site

L'action "Get Many Site" récupère plusieurs sites en une requête. Parfaite pour les exports, synchronisations ou rapports impliquant vos sites clients.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Site".
• Operation : Défini sur "Get Many".
• Simplify : Interrupteur pour simplifier les données. Activé par défaut.
• Return All : Interrupteur pour retourner tous les sites. Désactivé par défaut.
• Limit : Nombre maximum de sites à récupérer (défaut : 50).
• Filters : Section pour ajouter des critères de filtrage.

Cas d'usage typiques :

• Lister tous les sites d'un client spécifique
• Générer un inventaire des sites pour audit
• Synchroniser les sites avec un outil de cartographie

L'action "Update Site" modifie les informations d'un site existant dans HaloPSA. Essentielle pour maintenir les données de localisation à jour.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Site".
• Operation : Défini sur "Update".
• Site ID : Identifiant du site à mettre à jour. Requis.
• Update Fields : Section dynamique pour définir les champs à modifier via "Add Field".

Cas d'usage typiques :

• Mettre à jour l'adresse d'un site après un déménagement
• Modifier le contact principal d'un site
• Synchroniser les changements depuis un système tiers

L'action "Create Ticket" est probablement la plus utilisée : elle crée un nouveau ticket de support dans HaloPSA. Automatisez la création de tickets depuis n'importe quelle source externe.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Ticket".
• Operation : Défini sur "Create".
• Ticket Type Name or ID : Type de ticket (incident, demande, etc.). Accepte un nom ou un ID.
• Summary : Champ texte pour le titre/résumé du ticket.
• Details : Champ texte pour la description détaillée du ticket.
• Additional Fields : Section pour ajouter priorité, client, site, agent assigné, etc.

Cas d'usage typiques :

• Créer un ticket quand un email arrive dans une boîte partagée
• Automatiser l'ouverture de tickets depuis un chatbot
• Générer des tickets à partir d'alertes de monitoring

💡 TIPS : Utilisez les expressions n8n pour injecter dynamiquement le contenu d'un email ou d'un formulaire dans les champs Summary et Details. Pensez à mapper le client et le site pour un routage automatique vers la bonne équipe.

L'action "Delete Ticket" supprime un ticket de HaloPSA. À utiliser avec précaution, principalement pour le nettoyage de tickets de test ou la gestion de doublons.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Ticket".
• Operation : Défini sur "Delete".
• Ticket ID : Identifiant unique du ticket à supprimer. Requis.

Cas d'usage typiques :

• Supprimer les tickets spam automatiquement détectés
• Nettoyer les tickets de test après recette
• Gérer les doublons identifiés par un workflow de déduplication

L'action "Get Ticket" récupère les détails complets d'un ticket spécifique. Indispensable pour vérifier le statut d'un ticket ou enrichir une notification.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Ticket".
• Operation : Défini sur "Get".
• Ticket ID : Identifiant du ticket à récupérer. Requis.
• Simplify : Interrupteur pour simplifier les données retournées.

Cas d'usage typiques :

• Récupérer les détails d'un ticket pour une notification Slack enrichie via Discord n8n ou Slack
• Vérifier le statut d'un ticket avant escalade
• Alimenter un dashboard temps réel avec les infos ticket

L'action "Get Many Ticket" récupère plusieurs tickets selon vos critères. Parfaite pour les rapports, dashboards ou traitements en lot.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Ticket".
• Operation : Défini sur "Get Many".
• Simplify : Interrupteur pour simplifier les données. Activé par défaut.
• Return All : Interrupteur pour retourner tous les tickets.
• Limit : Nombre maximum de tickets à récupérer (défaut : 50).
• Filters : Section pour filtrer par statut, priorité, client, date, etc.

Cas d'usage typiques :

• Générer un rapport quotidien des tickets ouverts
• Identifier les tickets en retard pour escalade automatique
• Exporter les tickets résolus vers un outil de reporting

L'action "Update Ticket" modifie un ticket existant. Utilisez-la pour changer le statut, réassigner, ajouter des notes ou modifier la priorité automatiquement.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "Ticket".
• Operation : Défini sur "Update".
• Ticket ID : Identifiant du ticket à modifier. Requis.
• Update Fields : Section dynamique pour définir les champs à mettre à jour (statut, priorité, agent, notes, etc.).

Cas d'usage typiques :

• Passer un ticket en "En attente" quand une réponse client est reçue
• Escalader automatiquement les tickets non traités après X heures
• Ajouter une note interne depuis une intégration externe

L'action "Create User" ajoute un nouvel utilisateur (contact client) dans HaloPSA. Différent d'un agent, l'utilisateur représente un contact côté client pouvant soumettre des tickets.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "User".
• Operation : Défini sur "Create".
• Name : Nom de l'utilisateur à créer. Requis.
• Site Name or ID : Site auquel rattacher l'utilisateur.
• Additional Fields : Section pour ajouter email, téléphone, rôle, etc.

Cas d'usage typiques :

• Créer un contact utilisateur quand un nouveau collaborateur rejoint un client
• Synchroniser les utilisateurs depuis un Active Directory
• Onboarder les utilisateurs depuis un formulaire d'inscription

L'action "Delete User" supprime un utilisateur de HaloPSA. Utile pour les workflows de désactivation ou de nettoyage de contacts obsolètes.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "User".
• Operation : Défini sur "Delete".
• User ID : Identifiant de l'utilisateur à supprimer. Requis.

Cas d'usage typiques :

• Désactiver les utilisateurs quand ils quittent une entreprise cliente
• Nettoyer les contacts inactifs après une période définie
• Gérer les demandes de suppression RGPD

L'action "User - Get" récupère les informations d'un utilisateur spécifique dans HaloPSA. Idéale pour vérifier ou enrichir les données utilisateur.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "User".
• Operation : Défini sur "Get".
• User ID : Identifiant de l'utilisateur à récupérer. Requis.
• Simplify : Interrupteur pour simplifier les données retournées.

Cas d'usage typiques :

• Récupérer l'email d'un utilisateur pour notification personnalisée
• Vérifier les permissions d'un utilisateur avant action
• Enrichir un ticket avec les infos du demandeur

L'action "Get Many User" récupère plusieurs utilisateurs selon vos critères. Parfaite pour les exports, synchronisations ou rapports utilisateurs.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "User".
• Operation : Défini sur "Get Many".
• Simplify : Interrupteur pour simplifier les données. Activé par défaut.
• Return All : Interrupteur pour retourner tous les utilisateurs.
• Limit : Nombre maximum d'utilisateurs à récupérer (défaut : 50).
• Filters : Section pour filtrer par site, client, statut, etc.

Cas d'usage typiques :

• Exporter la liste des utilisateurs d'un client
• Synchroniser les utilisateurs avec un outil de communication
• Générer un rapport des contacts par site

L'action "Update User" modifie les informations d'un utilisateur existant. Essentielle pour maintenir vos contacts client à jour.

Paramètres clés :

• Credential to connect with : Credentials HaloPSA. Requis.
• Resource : Défini sur "User".
• Operation : Défini sur "Update".
• User ID : Identifiant de l'utilisateur à modifier. Requis.
• Update Fields : Section dynamique pour définir les champs à mettre à jour via "Add Field".

Cas d'usage typiques :

• Mettre à jour l'email ou téléphone d'un contact
• Modifier le site de rattachement d'un utilisateur
• Synchroniser les changements depuis un Active Directory