Intégration Freshworks CRM n8nAutomatiser Freshworks CRM avec n8n.

Crée un compte dans Freshworks CRM. Un seul champ est obligatoire, ce qui suffit à ouvrir une fiche propre que les commerciaux enrichiront ensuite.

• Name : le nom du compte, seul champ requis, en général repris de l'item précédent avec une expression du type {{ $json.field }}.
• Additional Fields : une collection optionnelle de 17 entrées, dont Website, Industry Type Name or ID, Number of Employees et Owner Name or ID, l'utilisateur à qui le compte est attribué.

La suppression d'un compte passe par son identifiant, jamais par son nom. L'id doit donc arriver d'une recherche ou d'une étape antérieure du workflow.

• Account ID : l'ID du compte à supprimer. Mieux vaut le prendre dans un nœud précédent avec {{ $json.field }} que le taper à la main, sinon le workflow ne sert qu'une fois.

Va chercher un compte précis dans Freshworks CRM et le pose dans le workflow. C'est la façon classique de donner à une automatisation le contexte que le système déclencheur n'avait pas.

• Account ID : l'ID du compte à récupérer, seul champ attendu par l'opération.

Ramène une liste de comptes, cadrée par une vue. Les vues sont les listes enregistrées dans Freshworks CRM, et le nœud en réclame une avant de renvoyer quoi que ce soit.

• View Name or ID : requis. Tu choisis la vue dans la liste, ou tu passes son ID par une expression.
• Return All : coché, n8n enchaîne les pages de l'API jusqu'au bout de la vue ; décoché, Limit fixe le nombre maximal de comptes renvoyés.

Modifie un compte existant. Rien n'est obligatoire en dehors de l'identifiant, donc un workflow peut toucher un seul champ et laisser le reste de la fiche tranquille.

• Account ID : l'ID du compte à mettre à jour.
• Update Fields : 18 entrées, dont Name, Annual Revenue, Territory Name or ID et Parent Sales Account ID, qui rattache la fiche à son compte parent.

Pose un rendez-vous dans Freshworks CRM depuis le workflow. Trois champs portent la réunion : un titre et deux horodatages.

• Title, Start Date et End Date : l'intitulé, plus les horodatages qui marquent le début et la fin du rendez-vous. Sur un rendez-vous à la journée, ils portent la date de début et la date de fin.
• Additional Fields : 9 entrées, dont Is All-Day, Location, Time Zone, ainsi que Target Type et Target ID, la fiche contre laquelle le rendez-vous est créé.

Retire un rendez-vous du calendrier CRM. Pratique quand l'annulation se produit ailleurs que dans Freshworks CRM, ce qui est le cas de tous les créneaux pris depuis une page externe.

• Appointment ID : l'ID du rendez-vous à supprimer. Il vient de l'item qui avait créé la réunion, conservé dans une ligne de tableur ou une base à côté de la référence de réservation.

Lit un rendez-vous à partir de son identifiant. Utile au milieu d'un workflow, quand une étape suivante a besoin du détail de la réunion et pas seulement de sa référence.

• Appointment ID : l'ID du rendez-vous à récupérer, unique champ requis.

Liste les rendez-vous, avec deux filtres qui rendent le résultat exploitable. Aucun champ n'est requis, l'opération tourne dès qu'on la pose dans le workflow.

• Time : upcoming ou past, le filtre qui décide de quel côté d'aujourd'hui tu lis.
• Include : ramène des données liées avec chaque rendez-vous, au choix appointment_attendees, creater ou targetable.
• Return All : coché, toutes les pages sont enchaînées ; décoché, Limit plafonne le nombre de rendez-vous.

Change les informations d'un rendez-vous déjà posé, à partir de son identifiant. Tout le reste est optionnel, et c'est ce qui rend le report de créneau facile à automatiser.

• Appointment ID : l'ID du rendez-vous à modifier.
• Update Fields : 13 entrées, dont Start Date, End Date, Location, Attendees et Outcome Name or ID, l'issue du type d'activité commerciale Appointment.

Enregistre une nouvelle personne dans Freshworks CRM. Trois champs sont requis, et ce sont les trois qu'un formulaire de lead collecte de toute façon.

• First Name, Last Name et Email Address : l'identité du contact, en général reprise du formulaire avec {{ $json.field }}.
• Additional Fields : 24 entrées optionnelles, dont Job Title, Mobile Number, Lifecycle Stage Name or ID, Medium et Sales Account Names or IDs, les comptes auxquels le contact appartient.

Efface la fiche d'un contact. L'identifiant est la seule chose qui sépare le workflow de la suppression, donc celle-ci mérite un nœud IF en amont pour vérifier avant d'agir.

• Contact ID : l'ID du contact à supprimer, issu d'une recherche ou porté par l'item qui a lancé l'exécution.

Rapatrie un contact dans le workflow. L'étape qui transforme un identifiant en quelque chose qu'un message ou un rapport peut réellement utiliser.

• Contact ID : l'ID du contact à récupérer.

Sort les contacts en lot. Rien n'est obligatoire ici, la vue elle-même est facultative, c'est l'opération à dégainer quand tu veux un segment entier plutôt qu'une personne.

• View Name or ID : optionnel. Tu pointes une liste enregistrée, ou tu laisses vide pour lire plus large.
• Return All : coché, n8n enchaîne les pages de l'API jusqu'au bout ; décoché, Limit fixe le nombre maximal de contacts renvoyés.

Réécrit des champs sur un contact existant. La surface de mise à jour la plus large du nœud, et celle qui tient un CRM honnête entre deux revues manuelles.

• Contact ID : l'ID du contact à mettre à jour, seul champ requis.
• Update Fields : 26 entrées, dont Contact Status Name or ID, Owner Name or ID, Subscription Status Name or ID, Job Title et Territory Name or ID.

Ouvre une opportunité dans le pipeline. Deux champs requis, un nom et un montant, et l'affaire existe là où le prévisionnel se lit.

• Name et Amount : l'intitulé du deal et sa valeur, les deux obligatoires.
• Additional Fields : 14 entrées, dont Deal Pipeline Name or ID, Deal Stage Name or ID, Sales Account Name or ID, Currency Name or ID et Probability, un nombre entre 0 et 100.

Sort définitivement un deal de Freshworks CRM. À distinguer du passage en perdu, qui est un changement d'étape et relève de la mise à jour.

• Deal ID : l'ID du deal à supprimer.

Récupère un deal à partir de son identifiant, pour que la suite du workflow s'appuie sur ce que la fiche dit vraiment et pas sur ce que le déclencheur a supposé.

• Deal ID : l'ID du deal à récupérer, seul champ requis.

Parcourt une liste de deals. C'est la bête de somme du reporting sur ce nœud, et le seul endroit où l'interrupteur de pagination change vraiment le résultat.

• View Name or ID : optionnel. Une vue enregistrée resserre la lecture sur les deals qui t'intéressent.
• Return All : coché, chaque page de l'API est enchaînée jusqu'à la fin de la liste ; décoché, Limit fixe le nombre maximal de deals transmis à l'étape suivante.

Fait avancer un deal, ou le corrige. Étape, montant et propriétaire vivent dans la même collection optionnelle, donc un seul nœud couvre plusieurs types de changement.

• Deal ID : l'ID du deal à mettre à jour.
• Update Fields : 16 entrées, dont Amount, Deal Stage Name or ID, Probability et Deal Reason Name or ID, la raison de la perte, qui ne se renseigne que sur un deal à l'étape Lost.

Attache une note écrite à une fiche. Les trois champs sont requis, parce qu'une note sans cible n'a nulle part où se poser.

• Content : le contenu de la note.
• Target Type : le type d'entité concernée, Contact, Deal ou SalesAccount.
• Target ID : l'ID de cette entité, du type choisi juste au-dessus.

Une note écrite par un workflow doit pouvoir être reprise : cette opération l'enlève. Les notes automatiques s'empilent vite, et une automatisation qui écrit devrait savoir effacer.

• Note ID : l'ID de la note à supprimer, conservé depuis l'étape qui l'a créée.

Corrige une note après coup, ou la déplace vers une autre fiche. Trois champs optionnels, un identifiant obligatoire.

• Note ID : l'ID de la note à modifier.
• Update Fields : 3 entrées, Content, Target Type et Target ID, qui permettent ensemble de réécrire la note ou de la rattacher à une autre entité.

Une activité commerciale se récupère à l'unité, par son identifiant, et le nœud transmet sa fiche complète à la suite du workflow.

• Sales Activity ID : l'identifiant de l'activité à récupérer. Tu le saisis, ou tu le reprends de l'item entrant avec une expression, la syntaxe n8n qui va chercher une valeur dans l'étape précédente et s'écrit {{ $json.field }}. Un champ requis laissé vide arrête le nœud avant tout appel à Freshworks CRM.

Là où la version unitaire vise une fiche, celle-ci ramène plusieurs activités commerciales dans la même exécution, chacune sous forme d'item pour les étapes suivantes.

• Return All : activé, n8n enchaîne les pages de l'API jusqu'à la dernière activité commerciale.
• Limit : lu seulement si Return All reste désactivé, il plafonne le nombre d'activités qui entrent dans le workflow.

Deux réglages suffisent pour chercher dans Freshworks CRM : le terme visé, et les types d'enregistrements sur lesquels la recherche porte. Chaque correspondance ressort en item distinct.

• Search Term : le terme utilisé pour la recherche, souvent construit à partir d'une valeur entrante avec une expression du type {{ $json.field }}.
• Search on Entities : les types couverts, parmi contact, deal, sales_account et user. Plusieurs cases peuvent être cochées ensemble.
• Return All et Limit : toutes les correspondances, ou un nombre plafonné.

Ici, la recherche part d'une valeur exacte plutôt que d'un terme approximatif : tu choisis le champ, tu donnes la valeur, et les enregistrements correspondants reviennent.

• Search Field : email, name ou customField, ce dernier n'étant autorisé que sur les champs personnalisés de type Text field, Number, Dropdown ou Radio button.
• Custom Field Name et Custom Field Value : le champ personnalisé visé et la valeur cherchée dedans.
• Field Value : la valeur cherchée sur le champ sélectionné.
• Entities, dans Options : les entités liées interrogées en parallèle, parmi contact, deal et sales_account. Le champ doit exister dans chacune, sinon l'API renvoie une erreur.

Créer une tâche demande cinq informations obligatoires : une tâche est rattachée à l'enregistrement qu'elle concerne et à la personne qui doit la traiter.

• Title : le titre de la tâche.
• Due Date : l'horodatage de l'échéance à laquelle la tâche doit être terminée.
• Owner Name or ID : l'utilisateur à qui la tâche est assignée, choisi dans la liste ou fourni par une expression.
• Target Type : Contact, Deal ou SalesAccount.
• Target ID : l'identifiant de cette entité, dont le type vient de Target Type.
• Additional Fields : Creator Name or ID, Outcome Name or ID, Task Type ID.

Un identifiant, et la tâche quitte le CRM. Aucun autre champ n'entre en jeu, donc toute la question tient à la provenance de cet identifiant.

• Task ID : l'identifiant de la tâche à supprimer. Venu d'une étape précédente, il s'écrit sous forme d'expression, par exemple {{ $json.field }}, et ce champ requis bloque l'exécution s'il reste vide.

Avant d'agir sur une tâche, beaucoup de workflows la relisent. C'est exactement ce que fait cette lecture unitaire : un identifiant en entrée, la fiche de la tâche en sortie.

• Task ID : l'identifiant de la tâche à récupérer, saisi dans le champ ou résolu depuis l'item entrant.

Le filtre fait tout l'intérêt de cette liste. Le nœud renvoie des tâches sous forme d'items, et la collection Filters réduit l'ensemble avant qu'il arrive à l'étape suivante.

• Status, dans Filters : completed, due_today, due_tomorrow, open ou overdue.
• Include, dans Filters : owner, targetable ou users.
• Return All : coché, n8n parcourt les pages jusqu'à la dernière tâche ; décoché, Limit plafonne le nombre de tâches renvoyées.

Modifier une tâche existante repose sur son identifiant, plus les seuls champs que tu ajoutes. Ce que tu laisses hors de la collection Update Fields reste tel quel dans Freshworks CRM.

• Task ID : l'identifiant de la tâche à modifier, unique champ requis.
• Update Fields : Title, Due Date, Owner Name or ID, Creator Name or ID, Outcome Name or ID, Task Type ID, Target Type et Target ID. Target Type donne le type d'entité, Target ID désigne laquelle.