Intégration HighLevel n8nAutomatiser HighLevel avec n8n.

Une seule opération pour deux situations : si la personne existe déjà dans HighLevel, sa fiche est mise à jour plutôt que dupliquée.

• Email : l'adresse qui identifie la personne (name@email.com). Email ou Phone, il en faut au moins un pour créer le contact.
• Phone : même rôle, en numéro. Il doit commencer par un indicatif pays valide précédé du signe plus, façon +491234567890.
• Additional Fields : 14 champs facultatifs, dont First Name, Last Name, Source, Tags en liste séparée par des virgules, et Custom Fields.

Retire la fiche de HighLevel. Le nœud attend l'identifiant, pas le nom ni l'adresse email.

• Contact ID : l'identifiant HighLevel de la fiche à supprimer. Il vient le plus souvent d'un nœud précédent, récupéré par une expression du type {{ $json.field }}, qui lit un champ de l'item entrant.

Lit une fiche unique et transmet ses données au nœud suivant, ce qui évite d'aller la chercher à la main dans l'interface.

• Contact ID : la fiche à lire. On enchaîne après une opération de liste quand on ne dispose que d'un nom ou d'un email.

Renvoie une liste de contacts, avec des filtres qui la réduisent avant même que les données atteignent la suite du workflow.

• Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier contact correspondant. Désactivé, Limit fixe le nombre maximal de contacts renvoyés.
• Query : recherche libre, appliquée sur Name, Phone, Email, Tags et Company Name.
• Sort By et Order : tri sur date_added ou date_updated, croissant (asc) ou décroissant (desc).

Modifie uniquement les champs listés sur une fiche existante et laisse le reste intact.

• Contact ID : la fiche à réécrire.
• Update Fields : 14 champs au choix, parmi lesquels Email, Phone, Tags, Timezone et Do Not Disturb, où true signifie qu'aucun message sortant n'est autorisé.

Ouvre une affaire rattachée à un contact, avec son nom, son statut et sa place dans un pipeline.

• Contact Email or ID : à choisir dans la liste ou à passer en ID via une expression. Le nœud précise qu'il ne peut y avoir qu'une seule opportunité par contact.
• Status : open, won, lost ou abandoned.
• Pipeline Name or ID : depuis la liste, ou sous forme d'identifiant.
• Monetary Value : la valeur monétaire de l'opportunité, dans Additional Fields à côté de Tags et Assigned To.

Efface une affaire du pipeline. C'est l'opération à garder sous la main quand des enregistrements créés pendant la recette d'un workflow doivent disparaître avant lecture des chiffres.

• Opportunity ID : l'affaire à retirer, généralement transmise par le nœud qui l'a créée ou listée.

Récupère une affaire et ses données, pour qu'un nœud plus loin décide sur du concret plutôt que sur une hypothèse.

• Opportunity ID : l'affaire à lire.

Liste les affaires avec 8 filtres, ce qui en fait l'opération de référence pour construire un état sans ouvrir l'interface.

• Return All : activé, toutes les affaires correspondantes remontent page après page ; désactivé, Limit plafonne le nombre renvoyé.
• Pipeline Name or ID et Stage Name or ID : on réduit à un pipeline, puis à une étape. Le nœud demande le pipeline en premier, sinon les étapes n'apparaissent pas.
• Start Date et End Date : une plage de dates sur les affaires.
• Status : open, won, lost ou abandoned.

Fait avancer une affaire : autre étape, autre statut, autre valeur, ou changement de propriétaire.

• Opportunity ID : l'affaire à modifier. Le nœud prévient que l'identifiant de pipeline d'une opportunité ne se met pas à jour.
• Update Fields : 6 champs, dont Status, Stage Name or ID, Monetary Value, Assigned To et Name.

Rattache une tâche à un contact, avec une échéance. Quatre champs sont requis ici, plus que sur la plupart des opérations du nœud.

• Contact Email or ID : le contact auquel la tâche appartient, depuis la liste ou en identifiant.
• Title : ce qu'il y a à faire.
• Due Date : l'échéance, en date et heure.
• Completed : booléen requis, donc n8n en demande la valeur même sur une tâche qu'on vient d'ouvrir.
• Body : le détail, dans Additional Fields à côté de Assigned To.

Supprime une tâche qui n'a plus lieu d'être. Deux identifiants sont nécessaires, parce qu'une tâche est accrochée à un contact.

• Contact Email or ID : le contact porteur de la tâche.
• Task ID : la tâche visée sur ce contact.

Va chercher une tâche précise chez un contact et transmet ce qu'elle contient à la suite du workflow.

• Contact Email or ID : le contact qui porte la tâche.
• Task ID : la tâche à lire.

Les tâches d'un contact remontent sous forme de liste. Le contact est requis, donc le résultat est toujours cadré sur une seule personne.

• Contact Email or ID : requis, le contact dont les tâches sont renvoyées.
• Return All : activé, toutes les tâches de ce contact reviennent ; désactivé, Limit fixe le nombre.

Réécrit une tâche sur place : nouvelle échéance, nouveau responsable, ou la coche qui la termine.

• Contact Email or ID et Task ID : le couple qui désigne la tâche.
• Update Fields : 5 champs, Completed, Title, Body, Due Date et Assigned To.

Pose un rendez-vous dans un agenda HighLevel pour un contact, sans que personne n'ouvre une page de réservation.

• Calendar ID : l'agenda qui reçoit le rendez-vous.
• Location ID : l'identifiant de location que le nœud réclame en parallèle.
• Contact ID : la personne concernée.
• Start Time : une chaîne qui porte la date, l'heure et le décalage, au format 2021-06-23T03:30:00+05:30. End Time suit le même format, dans Additional Fields.
• Appointment Status : facultatif, valeurs autorisées new, confirmed, cancelled, showed, noshow et invalid.

Interroge un agenda sur les créneaux encore libres dans une fenêtre qu'on définit. C'est l'étape qui précède toute proposition d'horaire.

• Calendar ID : l'agenda consulté.
• Start Date et End Date : les bornes de la fenêtre, en nombres. Le nœud donne 1548898600000 et 1601490599999 comme exemples.
• Timezone : le fuseau utilisé pour les créneaux renvoyés, America/Chihuahua par exemple, dans Additional Fields à côté de User ID.